maybeai-sheet-cli 0.7.0__tar.gz → 0.9.0__tar.gz

{maybeai_sheet_cli-0.7.0 → maybeai_sheet_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maybeai-sheet-cli
-Version: 0.7.0
+Version: 0.9.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
@@ -88,6 +88,12 @@ Optional global flags:
 - `--timeout <seconds>`
 - `--verbose`
 
+Alias note:
+
+- Prefer nested worksheet media/layout commands such as `mbs excel-worksheet style ...`
+- The CLI also exposes compatibility shortcuts `mbs style ...`, `mbs image ...`,
+  `mbs chart ...`, and `mbs dashboard ...` for the same command groups
+
 ## Quick Start
 
 The examples below follow the target protocol names.
@@ -167,11 +173,33 @@ Search, style, inspect history, and export:
 ```bash
 mbs excel-worksheet range search --doc-id abc123 --worksheet-name Sheet1 --query revenue --max-results 20
 mbs excel-worksheet style freeze-panes --doc-id abc123 --worksheet-name Sheet1 --cell B2
+mbs excel-worksheet style worksheet plan --doc-id abc123 --worksheet-name Sheet1 --mode auto_detect --spec worksheet_style.json
+mbs excel-worksheet style worksheet apply --doc-id abc123 --worksheet-name Sheet1 --mode auto_detect --spec worksheet_style.json
+mbs excel-worksheet image list --doc-id abc123 --worksheet-name Dashboard
+mbs excel-worksheet chart list --doc-id abc123 --worksheet-name Dashboard
+mbs excel-worksheet dashboard manifest --doc-id abc123 --worksheet-name Dashboard
+mbs workbook calculate --doc-id abc123
+mbs excel-worksheet calculate --doc-id abc123 --worksheet-name Sheet1
 mbs excel-worksheet range calculate --doc-id abc123 --worksheet-name Sheet1 --cell E2 --formula "=SUM(B2:D2)"
 mbs version list --doc-id abc123 --limit 10
 mbs workbook export --doc-id abc123 --out workbook.xlsx
 ```
 
+The worksheet media/layout groups are available in both forms:
+
+```bash
+mbs excel-worksheet chart list --doc-id abc123 --worksheet-name Dashboard
+mbs chart list --doc-id abc123 --worksheet-name Dashboard
+```
+
+Prefer the nested `excel-worksheet ...` form in docs and agent prompts when you
+want the object model to stay explicit.
+
+For chart specs authored as `type: "json"`, keep metadata `title` when the chart
+needs an internal or custom-rendered title, and hide the visible container title
+with `hide_title: true` or `spec.style.showContainerTitle: false` rather than
+deleting `title`.
+
 ## Relationship
 1 workbok
  |                         \
@@ -216,6 +244,7 @@ mbs
 │   ├── list-user-workbooks       API   List user workbooks with bounded output.
 |       list-worksheets           API   List worksheets, including engine.
 │   ├── search                   NOW   Search user workbooks with bounded output.
+│   ├── calculate                NOW   Recalculate formulas across the workbook.
 │   ├── export                   API   Export workbook bytes.
 │   └── copy                     API   Copy a workbook.
 │   ├── upload                   API   Upload a file through workbook import flow.
@@ -226,6 +255,7 @@ mbs
 │
 ├── excel_worksheet
 │   ├── read                     API   Read the full range of the worksheet.
+│   ├── calculate                NOW   Recalculate formulas in one worksheet.
 │   ├── list-table               API   Detect content-backed tables in a worksheet.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
@@ -281,39 +311,40 @@ mbs
 │   └── append                   API   Append columns.
 │
 ├── excel_worksheet chart
-│   ├── list                     API   List charts in a workbook or dashboard.
-│   ├── get                      API   Read one chart spec and source binding.
+│   ├── list                     NOW   List charts in one worksheet.
+│   ├── get                      NOW   Read one chart spec and source binding.
 │   ├── preview                  PLAN  Preview one chart from its spec/source binding.
-│   ├── create-config                     API   Create one chart from a chart spec.
-│   ├── update                   API   Update one chart from a chart spec.
+│   ├── create-config            NOW   Create one chart from a chart spec.
+│   ├── update                   NOW   Update one chart from a chart spec.
 │   ├── refresh                  PLAN  Refresh one chart from its current source binding.
-│   └── delete                   API   Delete one chart.
+│   └── delete                   NOW   Delete one chart.
 │
 ├── excel_worksheet dashboard
-│   ├── manifest                 PLAN  Read dashboard, chart, metric, layout, and lineage metadata.
-│   ├── create-config            PLAN  Compose chart ids/specs into a dashboard config.
-│   ├── validate                 PLAN  Validate dashboard layout, permissions, filters, and metrics.
-│   └── refresh                  PLAN  Refresh dashboard charts from their current source bindings.
-│   └── delete  
+│   ├── manifest                 NOW   Aggregate worksheet metadata and chart inventory for one dashboard sheet.
+│   ├── create-config            NOW   Create a dashboard worksheet and compose charts from one spec.
+│   ├── validate                 NOW   Validate dashboard layout, worksheet target, and chart source fields locally.
+│   └── refresh                  NOW   Upsert dashboard charts from one spec and re-verify chart inventory.
 │
 │
-├── excel_worksheet style
-│   ├── cell batch-set           API   Apply cell style batches from JSON.
-│   ├── columns-width            API   Set column widths.
-│   ├── rows-height              API   Set row heights.
-│   ├── freeze-panes             API   Freeze rows/columns using an A1 boundary.
-│   ├── gridlines toggle         API   Toggle worksheet gridlines.
-│   ├── auto-filter set          API   Set worksheet auto-filter range.
-│   ├── auto-filter remove       API   Remove worksheet auto-filter.
-│   ├── filter-values            API   Apply filter values.
-│   ├── conditional-formats set  API   Set conditional formatting rules.
-│   ├── worksheet plan           API   Generate a worksheet styling plan.
-│   └── worksheet apply          API   Apply a worksheet styling plan.
+├── excel-worksheet style
+│   ├── cell batch-set           NOW   Apply cell style batches from JSON.
+│   ├── columns-width            NOW   Set column widths.
+│   ├── rows-height              NOW   Set row heights.
+│   ├── freeze-panes             NOW   Freeze rows/columns using an A1 boundary.
+│   ├── gridlines toggle         NOW   Toggle worksheet gridlines.
+│   ├── auto-filter set          NOW   Set worksheet auto-filter range.
+│   ├── auto-filter remove       NOW   Remove worksheet auto-filter.
+│   ├── filter-values            NOW   Apply filter values.
+│   ├── conditional-formats set  NOW   Set conditional formatting rules.
+│   ├── worksheet plan           NOW   Generate a worksheet styling plan.
+│   └── worksheet apply          NOW   Apply a worksheet styling plan.
 │
-├── excel_worksheet  image
-│   ├── read                     API   Read worksheet images.
-│   ├── insert                      API   Add an image file.
-│   └── delete                   API   Delete an image.
+├── excel_worksheet image
+│   ├── list                     NOW   List worksheet images from worksheet formatting metadata.
+│   ├── read                     NOW   Read one worksheet image by cell or picture id.
+│   ├── replace                  NOW   Replace one worksheet image in place.
+│   ├── insert                   NOW   Add an image file.
+│   └── delete                   NOW   Delete an image.
 │
 ├── version
 │   ├── list                     API   List workbook history with bounded output.
@@ -394,24 +425,65 @@ mbs excel-worksheet column append --doc-id abc123 --worksheet-name Actuals --val
 mbs excel-worksheet range lineage --doc-id abc123 --worksheet-name Model --cell E2 --format tree  # API
 
 # formula
+mbs workbook calculate --doc-id abc123  # API
+mbs excel-worksheet calculate --doc-id abc123 --worksheet-name Model  # API
 mbs excel-worksheet range calculate --doc-id abc123 --worksheet-name Model --cell E2 --formula "=SUM(B2:D2)"  # API
 mbs excel-worksheet range set-formula --doc-id abc123 --worksheet-name Model --cell E2 --formula "=SUM(B2:D2)"  # API
 
 # chart
-mbs excel-worksheet chart create-config --doc-id abc123 --worksheet-name Dashboard --cell J2 --spec chart.json  # API
-mbs excel-worksheet chart refresh --doc-id abc123 --worksheet-name Dashboard --chart-id chart_monthly_revenue  # PLAN
+mbs excel-worksheet chart list --doc-id abc123 --worksheet-name Dashboard  # NOW
+mbs excel-worksheet chart get --doc-id abc123 --worksheet-name Dashboard --cell J2  # NOW
+mbs excel-worksheet chart create-config --doc-id abc123 --worksheet-name Dashboard --cell J2 --spec chart.json  # NOW
+mbs excel-worksheet chart update --doc-id abc123 --worksheet-name Dashboard --cell J2 --chart-id rId1 --spec chart.json  # NOW
+mbs excel-worksheet chart delete --doc-id abc123 --worksheet-name Dashboard --chart-id rId1  # NOW
+
+# recommended chart.json shape
+# prefer top-level `"type": "json"` and put the renderer in `html`
+# do not treat `"type": "line"` / `"bar"` / `"pie"` as the default authored form
+# {
+#   "type": "json",
+#   "sql": "select Month, Revenue from Sheet1",
+#   "title": "Monthly Revenue",
+#   "legend": "bottom",
+#   "html": "{ library: 'echarts', handler: (data) => ({ xAxis: { type: 'category', data: data.map(r => r.Month) }, yAxis: { type: 'value' }, series: [{ type: 'line', data: data.map(r => Number(r.Revenue) || 0) }] }) }",
+#   "spec": { "style": { "title": "Monthly Revenue" } }
+# }
 
 # dashboard
-mbs excel-worksheet dashboard manifest --doc-id abc123 --worksheet-name Dashboard --dashboard-id dash_revenue  # PLAN
-mbs excel-worksheet dashboard create-config --doc-id abc123 --worksheet-name Dashboard --name "Revenue Dashboard" --spec dashboard.json  # PLAN
-mbs excel-worksheet dashboard refresh --doc-id abc123 --worksheet-name Dashboard --dashboard-id dash_revenue  # PLAN
+mbs excel-worksheet dashboard validate --spec dashboard.json  # NOW
+mbs excel-worksheet dashboard manifest --doc-id abc123 --worksheet-name Dashboard  # NOW
+mbs excel-worksheet dashboard create-config --doc-id abc123 --spec dashboard.json --create-worksheet  # NOW
+mbs excel-worksheet dashboard refresh --doc-id abc123 --spec dashboard.json  # NOW
+
+# recommended dashboard.json chart entries
+# {
+#   "worksheet_name": "Dashboard",
+#   "charts": [
+#     {
+#       "cell": "J2",
+#       "chart": {
+#         "type": "json",
+#         "sql": "select Month, Revenue from Sheet1",
+#         "title": "Monthly Revenue",
+#         "legend": "bottom",
+#         "html": "{ library: 'echarts', handler: (data) => ({ xAxis: { type: 'category', data: data.map(r => r.Month) }, yAxis: { type: 'value' }, series: [{ type: 'line', data: data.map(r => Number(r.Revenue) || 0) }] }) }"
+#       }
+#     }
+#   ]
+# }
 
 # style
-mbs excel-worksheet style freeze-panes --doc-id abc123 --worksheet-name Actuals --cell B2  # API
-mbs excel-worksheet style conditional-formats set --doc-id abc123 --worksheet-name Actuals --spec conditional_formats.json  # API
+mbs excel-worksheet style freeze-panes --doc-id abc123 --worksheet-name Actuals --cell B2  # NOW
+mbs excel-worksheet style cell batch-set --doc-id abc123 --worksheet-name Actuals --range A1:G1 --style header_style.json  # NOW
+mbs excel-worksheet style conditional-formats set --doc-id abc123 --worksheet-name Actuals --spec conditional_formats.json  # NOW
+mbs excel-worksheet style worksheet apply --doc-id abc123 --worksheet-name Actuals --mode auto_detect --spec worksheet_style.json  # NOW
 
 # image
-mbs excel-worksheet image insert --doc-id abc123 --worksheet-name Dashboard --cell A1 --file logo.png  # API
+mbs excel-worksheet image list --doc-id abc123 --worksheet-name Dashboard  # NOW
+mbs excel-worksheet image read --doc-id abc123 --worksheet-name Dashboard --cell A1 --out logo.png  # NOW
+mbs excel-worksheet image insert --doc-id abc123 --worksheet-name Dashboard --cell A1 --file logo.png  # NOW
+mbs excel-worksheet image replace --doc-id abc123 --worksheet-name Dashboard --cell A1 --file logo_v2.png  # NOW
+mbs excel-worksheet image delete --doc-id abc123 --worksheet-name Dashboard --cell A1  # NOW
 
 # version
 mbs version list --doc-id abc123 --limit 10  # API
@@ -463,15 +535,14 @@ Relationship guide:
 - Use `excel-worksheet row` and `excel-worksheet column` for structural
   row/column changes.
 - Use `excel-worksheet style` for worksheet layout operations like freeze
-  panes, filter ranges, widths, and heights.
-- Use `excel-table style` when the same styling operation should be scoped to a
-  table's resolved worksheet range.
-- Use `excel-worksheet chart` for CRUD, preview, and refresh of individual
-  source-backed visualizations before composing dashboards.
-- Use `excel-worksheet dashboard` to compose chart ids/specs into BI asset or
-  dashboard worksheet lifecycles.
-- Use `excel-worksheet image` for lower-level report workflows after routed
-  public API verification.
+  panes, filter ranges, widths, heights, gridlines, conditional formats, and
+  worksheet style planning/apply.
+- Use `excel-worksheet chart` for list/get/create/update/delete of individual
+  source-backed visualizations.
+- Use `excel-worksheet dashboard` for local validation and worksheet-level chart
+  orchestration such as manifest, create-config, and refresh.
+- Use `excel-worksheet image` for list/read/insert/replace/delete image
+  workflows.
 - Use `version` for workbook history inspection and restore.
 - Use `share` for visibility and collaborator access.
 

{maybeai_sheet_cli-0.7.0 → maybeai_sheet_cli-0.9.0}/README.md

@@ -64,6 +64,12 @@ Optional global flags:
 - `--timeout <seconds>`
 - `--verbose`
 
+Alias note:
+
+- Prefer nested worksheet media/layout commands such as `mbs excel-worksheet style ...`
+- The CLI also exposes compatibility shortcuts `mbs style ...`, `mbs image ...`,
+  `mbs chart ...`, and `mbs dashboard ...` for the same command groups
+
 ## Quick Start
 
 The examples below follow the target protocol names.
@@ -143,11 +149,33 @@ Search, style, inspect history, and export:
 ```bash
 mbs excel-worksheet range search --doc-id abc123 --worksheet-name Sheet1 --query revenue --max-results 20
 mbs excel-worksheet style freeze-panes --doc-id abc123 --worksheet-name Sheet1 --cell B2
+mbs excel-worksheet style worksheet plan --doc-id abc123 --worksheet-name Sheet1 --mode auto_detect --spec worksheet_style.json
+mbs excel-worksheet style worksheet apply --doc-id abc123 --worksheet-name Sheet1 --mode auto_detect --spec worksheet_style.json
+mbs excel-worksheet image list --doc-id abc123 --worksheet-name Dashboard
+mbs excel-worksheet chart list --doc-id abc123 --worksheet-name Dashboard
+mbs excel-worksheet dashboard manifest --doc-id abc123 --worksheet-name Dashboard
+mbs workbook calculate --doc-id abc123
+mbs excel-worksheet calculate --doc-id abc123 --worksheet-name Sheet1
 mbs excel-worksheet range calculate --doc-id abc123 --worksheet-name Sheet1 --cell E2 --formula "=SUM(B2:D2)"
 mbs version list --doc-id abc123 --limit 10
 mbs workbook export --doc-id abc123 --out workbook.xlsx
 ```
 
+The worksheet media/layout groups are available in both forms:
+
+```bash
+mbs excel-worksheet chart list --doc-id abc123 --worksheet-name Dashboard
+mbs chart list --doc-id abc123 --worksheet-name Dashboard
+```
+
+Prefer the nested `excel-worksheet ...` form in docs and agent prompts when you
+want the object model to stay explicit.
+
+For chart specs authored as `type: "json"`, keep metadata `title` when the chart
+needs an internal or custom-rendered title, and hide the visible container title
+with `hide_title: true` or `spec.style.showContainerTitle: false` rather than
+deleting `title`.
+
 ## Relationship
 1 workbok
  |                         \
@@ -192,6 +220,7 @@ mbs
 │   ├── list-user-workbooks       API   List user workbooks with bounded output.
 |       list-worksheets           API   List worksheets, including engine.
 │   ├── search                   NOW   Search user workbooks with bounded output.
+│   ├── calculate                NOW   Recalculate formulas across the workbook.
 │   ├── export                   API   Export workbook bytes.
 │   └── copy                     API   Copy a workbook.
 │   ├── upload                   API   Upload a file through workbook import flow.
@@ -202,6 +231,7 @@ mbs
 │
 ├── excel_worksheet
 │   ├── read                     API   Read the full range of the worksheet.
+│   ├── calculate                NOW   Recalculate formulas in one worksheet.
 │   ├── list-table               API   Detect content-backed tables in a worksheet.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
@@ -257,39 +287,40 @@ mbs
 │   └── append                   API   Append columns.
 │
 ├── excel_worksheet chart
-│   ├── list                     API   List charts in a workbook or dashboard.
-│   ├── get                      API   Read one chart spec and source binding.
+│   ├── list                     NOW   List charts in one worksheet.
+│   ├── get                      NOW   Read one chart spec and source binding.
 │   ├── preview                  PLAN  Preview one chart from its spec/source binding.
-│   ├── create-config                     API   Create one chart from a chart spec.
-│   ├── update                   API   Update one chart from a chart spec.
+│   ├── create-config            NOW   Create one chart from a chart spec.
+│   ├── update                   NOW   Update one chart from a chart spec.
 │   ├── refresh                  PLAN  Refresh one chart from its current source binding.
-│   └── delete                   API   Delete one chart.
+│   └── delete                   NOW   Delete one chart.
 │
 ├── excel_worksheet dashboard
-│   ├── manifest                 PLAN  Read dashboard, chart, metric, layout, and lineage metadata.
-│   ├── create-config            PLAN  Compose chart ids/specs into a dashboard config.
-│   ├── validate                 PLAN  Validate dashboard layout, permissions, filters, and metrics.
-│   └── refresh                  PLAN  Refresh dashboard charts from their current source bindings.
-│   └── delete  
+│   ├── manifest                 NOW   Aggregate worksheet metadata and chart inventory for one dashboard sheet.
+│   ├── create-config            NOW   Create a dashboard worksheet and compose charts from one spec.
+│   ├── validate                 NOW   Validate dashboard layout, worksheet target, and chart source fields locally.
+│   └── refresh                  NOW   Upsert dashboard charts from one spec and re-verify chart inventory.
 │
 │
-├── excel_worksheet style
-│   ├── cell batch-set           API   Apply cell style batches from JSON.
-│   ├── columns-width            API   Set column widths.
-│   ├── rows-height              API   Set row heights.
-│   ├── freeze-panes             API   Freeze rows/columns using an A1 boundary.
-│   ├── gridlines toggle         API   Toggle worksheet gridlines.
-│   ├── auto-filter set          API   Set worksheet auto-filter range.
-│   ├── auto-filter remove       API   Remove worksheet auto-filter.
-│   ├── filter-values            API   Apply filter values.
-│   ├── conditional-formats set  API   Set conditional formatting rules.
-│   ├── worksheet plan           API   Generate a worksheet styling plan.
-│   └── worksheet apply          API   Apply a worksheet styling plan.
+├── excel-worksheet style
+│   ├── cell batch-set           NOW   Apply cell style batches from JSON.
+│   ├── columns-width            NOW   Set column widths.
+│   ├── rows-height              NOW   Set row heights.
+│   ├── freeze-panes             NOW   Freeze rows/columns using an A1 boundary.
+│   ├── gridlines toggle         NOW   Toggle worksheet gridlines.
+│   ├── auto-filter set          NOW   Set worksheet auto-filter range.
+│   ├── auto-filter remove       NOW   Remove worksheet auto-filter.
+│   ├── filter-values            NOW   Apply filter values.
+│   ├── conditional-formats set  NOW   Set conditional formatting rules.
+│   ├── worksheet plan           NOW   Generate a worksheet styling plan.
+│   └── worksheet apply          NOW   Apply a worksheet styling plan.
 │
-├── excel_worksheet  image
-│   ├── read                     API   Read worksheet images.
-│   ├── insert                      API   Add an image file.
-│   └── delete                   API   Delete an image.
+├── excel_worksheet image
+│   ├── list                     NOW   List worksheet images from worksheet formatting metadata.
+│   ├── read                     NOW   Read one worksheet image by cell or picture id.
+│   ├── replace                  NOW   Replace one worksheet image in place.
+│   ├── insert                   NOW   Add an image file.
+│   └── delete                   NOW   Delete an image.
 │
 ├── version
 │   ├── list                     API   List workbook history with bounded output.
@@ -370,24 +401,65 @@ mbs excel-worksheet column append --doc-id abc123 --worksheet-name Actuals --val
 mbs excel-worksheet range lineage --doc-id abc123 --worksheet-name Model --cell E2 --format tree  # API
 
 # formula
+mbs workbook calculate --doc-id abc123  # API
+mbs excel-worksheet calculate --doc-id abc123 --worksheet-name Model  # API
 mbs excel-worksheet range calculate --doc-id abc123 --worksheet-name Model --cell E2 --formula "=SUM(B2:D2)"  # API
 mbs excel-worksheet range set-formula --doc-id abc123 --worksheet-name Model --cell E2 --formula "=SUM(B2:D2)"  # API
 
 # chart
-mbs excel-worksheet chart create-config --doc-id abc123 --worksheet-name Dashboard --cell J2 --spec chart.json  # API
-mbs excel-worksheet chart refresh --doc-id abc123 --worksheet-name Dashboard --chart-id chart_monthly_revenue  # PLAN
+mbs excel-worksheet chart list --doc-id abc123 --worksheet-name Dashboard  # NOW
+mbs excel-worksheet chart get --doc-id abc123 --worksheet-name Dashboard --cell J2  # NOW
+mbs excel-worksheet chart create-config --doc-id abc123 --worksheet-name Dashboard --cell J2 --spec chart.json  # NOW
+mbs excel-worksheet chart update --doc-id abc123 --worksheet-name Dashboard --cell J2 --chart-id rId1 --spec chart.json  # NOW
+mbs excel-worksheet chart delete --doc-id abc123 --worksheet-name Dashboard --chart-id rId1  # NOW
+
+# recommended chart.json shape
+# prefer top-level `"type": "json"` and put the renderer in `html`
+# do not treat `"type": "line"` / `"bar"` / `"pie"` as the default authored form
+# {
+#   "type": "json",
+#   "sql": "select Month, Revenue from Sheet1",
+#   "title": "Monthly Revenue",
+#   "legend": "bottom",
+#   "html": "{ library: 'echarts', handler: (data) => ({ xAxis: { type: 'category', data: data.map(r => r.Month) }, yAxis: { type: 'value' }, series: [{ type: 'line', data: data.map(r => Number(r.Revenue) || 0) }] }) }",
+#   "spec": { "style": { "title": "Monthly Revenue" } }
+# }
 
 # dashboard
-mbs excel-worksheet dashboard manifest --doc-id abc123 --worksheet-name Dashboard --dashboard-id dash_revenue  # PLAN
-mbs excel-worksheet dashboard create-config --doc-id abc123 --worksheet-name Dashboard --name "Revenue Dashboard" --spec dashboard.json  # PLAN
-mbs excel-worksheet dashboard refresh --doc-id abc123 --worksheet-name Dashboard --dashboard-id dash_revenue  # PLAN
+mbs excel-worksheet dashboard validate --spec dashboard.json  # NOW
+mbs excel-worksheet dashboard manifest --doc-id abc123 --worksheet-name Dashboard  # NOW
+mbs excel-worksheet dashboard create-config --doc-id abc123 --spec dashboard.json --create-worksheet  # NOW
+mbs excel-worksheet dashboard refresh --doc-id abc123 --spec dashboard.json  # NOW
+
+# recommended dashboard.json chart entries
+# {
+#   "worksheet_name": "Dashboard",
+#   "charts": [
+#     {
+#       "cell": "J2",
+#       "chart": {
+#         "type": "json",
+#         "sql": "select Month, Revenue from Sheet1",
+#         "title": "Monthly Revenue",
+#         "legend": "bottom",
+#         "html": "{ library: 'echarts', handler: (data) => ({ xAxis: { type: 'category', data: data.map(r => r.Month) }, yAxis: { type: 'value' }, series: [{ type: 'line', data: data.map(r => Number(r.Revenue) || 0) }] }) }"
+#       }
+#     }
+#   ]
+# }
 
 # style
-mbs excel-worksheet style freeze-panes --doc-id abc123 --worksheet-name Actuals --cell B2  # API
-mbs excel-worksheet style conditional-formats set --doc-id abc123 --worksheet-name Actuals --spec conditional_formats.json  # API
+mbs excel-worksheet style freeze-panes --doc-id abc123 --worksheet-name Actuals --cell B2  # NOW
+mbs excel-worksheet style cell batch-set --doc-id abc123 --worksheet-name Actuals --range A1:G1 --style header_style.json  # NOW
+mbs excel-worksheet style conditional-formats set --doc-id abc123 --worksheet-name Actuals --spec conditional_formats.json  # NOW
+mbs excel-worksheet style worksheet apply --doc-id abc123 --worksheet-name Actuals --mode auto_detect --spec worksheet_style.json  # NOW
 
 # image
-mbs excel-worksheet image insert --doc-id abc123 --worksheet-name Dashboard --cell A1 --file logo.png  # API
+mbs excel-worksheet image list --doc-id abc123 --worksheet-name Dashboard  # NOW
+mbs excel-worksheet image read --doc-id abc123 --worksheet-name Dashboard --cell A1 --out logo.png  # NOW
+mbs excel-worksheet image insert --doc-id abc123 --worksheet-name Dashboard --cell A1 --file logo.png  # NOW
+mbs excel-worksheet image replace --doc-id abc123 --worksheet-name Dashboard --cell A1 --file logo_v2.png  # NOW
+mbs excel-worksheet image delete --doc-id abc123 --worksheet-name Dashboard --cell A1  # NOW
 
 # version
 mbs version list --doc-id abc123 --limit 10  # API
@@ -439,15 +511,14 @@ Relationship guide:
 - Use `excel-worksheet row` and `excel-worksheet column` for structural
   row/column changes.
 - Use `excel-worksheet style` for worksheet layout operations like freeze
-  panes, filter ranges, widths, and heights.
-- Use `excel-table style` when the same styling operation should be scoped to a
-  table's resolved worksheet range.
-- Use `excel-worksheet chart` for CRUD, preview, and refresh of individual
-  source-backed visualizations before composing dashboards.
-- Use `excel-worksheet dashboard` to compose chart ids/specs into BI asset or
-  dashboard worksheet lifecycles.
-- Use `excel-worksheet image` for lower-level report workflows after routed
-  public API verification.
+  panes, filter ranges, widths, heights, gridlines, conditional formats, and
+  worksheet style planning/apply.
+- Use `excel-worksheet chart` for list/get/create/update/delete of individual
+  source-backed visualizations.
+- Use `excel-worksheet dashboard` for local validation and worksheet-level chart
+  orchestration such as manifest, create-config, and refresh.
+- Use `excel-worksheet image` for list/read/insert/replace/delete image
+  workflows.
 - Use `version` for workbook history inspection and restore.
 - Use `share` for visibility and collaborator access.
 

{maybeai_sheet_cli-0.7.0 → maybeai_sheet_cli-0.9.0}/pyproject.toml

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

{maybeai_sheet_cli-0.7.0 → maybeai_sheet_cli-0.9.0}/src/maybeai_sheet/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.7.0"
+__version__ = "0.9.0"

maybeai_sheet_cli-0.9.0/src/maybeai_sheet/chart_config.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from copy import deepcopy
+from typing import Any
+
+from .errors import UsageError
+
+
+def normalize_chart_payload(chart: dict[str, Any]) -> dict[str, Any]:
+    normalized = deepcopy(chart)
+    hide_title = _pop_optional_bool(normalized, "hide_title")
+    show_container_title = _pop_optional_bool(normalized, "show_container_title")
+
+    if hide_title is not None and show_container_title is not None:
+        expected_show = not hide_title
+        if show_container_title != expected_show:
+            raise UsageError("chart.hide_title conflicts with chart.show_container_title.")
+
+    desired_show: bool | None = None
+    if hide_title is not None:
+        desired_show = not hide_title
+    if show_container_title is not None:
+        desired_show = show_container_title
+    if desired_show is None and normalized.get("title") == "":
+        desired_show = False
+
+    spec = normalized.get("spec")
+    if spec is None:
+        spec_obj: dict[str, Any] = {}
+    elif isinstance(spec, dict):
+        spec_obj = deepcopy(spec)
+    else:
+        raise UsageError("chart.spec must be an object.")
+
+    style = spec_obj.get("style")
+    if style is None:
+        style_obj: dict[str, Any] = {}
+    elif isinstance(style, dict):
+        style_obj = deepcopy(style)
+    else:
+        raise UsageError("chart.spec.style must be an object.")
+
+    if desired_show is not None:
+        style_obj["showContainerTitle"] = desired_show
+
+    if style_obj:
+        spec_obj["style"] = style_obj
+    if spec_obj or "spec" in normalized:
+        normalized["spec"] = spec_obj
+    return normalized
+
+
+def _pop_optional_bool(payload: dict[str, Any], key: str) -> bool | None:
+    value = payload.pop(key, None)
+    if value is None:
+        return None
+    if isinstance(value, bool):
+        return value
+    raise UsageError(f"chart.{key} must be a boolean.")