# Changelog

## [2.1.0](https://github.com/Gemma-Analytics/gemma-agentic-toolkit/compare/gemma-lightdash-v2.0.0...gemma-lightdash-v2.1.0) (2026-04-02)


### Features

* **gemma-lightdash:** add lightdash semantic layer and dashboard management plugin ([156df22](https://github.com/Gemma-Analytics/gemma-agentic-toolkit/commit/156df224314ff70afff5413a60bb73f0f5ee67f4))
* **gemma-lightdash:** add Lightdash semantic layer and dashboard plugin ([a08516e](https://github.com/Gemma-Analytics/gemma-agentic-toolkit/commit/a08516e22ad803f2ff4b1c292e9c8ace1c1a3832))


### Bug Fixes

* **gemma-lightdash:** correct grid system (36-col) and add required YAML fields ([3b5b874](https://github.com/Gemma-Analytics/gemma-agentic-toolkit/commit/3b5b874bfa3764e8dc9b69afd07b894f83ef50c3))

## 2.0.0 — 2026-04-01

### Breaking: Restructured as Gemma-specific overlay

The plugin now complements the native `developing-in-lightdash` skill (installed via `lightdash install-skills --global`) instead of duplicating generic Lightdash documentation. This removes ~600 lines of redundant content while adding 11 new learnings from the native skill.

**Added:**
- SessionStart hook to auto-install native Lightdash skill when missing
- `gemma-conventions.md` — Gemma-specific column patterns, formats, and grouping conventions
- `gemma-dashboard-patterns.md` — Gemma chart tips, total labels workaround, tileTargets, heading tiles, REST API reference
- Common Mistakes sections in both skills (from native skill learnings)
- `contentType` field requirement in chart/dashboard YAML
- `dashboardSlug` for chart scoping
- `lightdash lint` before upload workflow
- `lightdash preview` for testing larger changes
- `lightdash sql` for filter value verification
- Dashboard tabs with UUID management
- Cross-explore filter targeting via `tileTargets`
- Heading tile type for section headers

**Changed:**
- `lightdash-semantics/SKILL.md` — rewritten to focus on Gemma workflow, cross-references native skill for generic Lightdash syntax
- `lightdash-dashboards/SKILL.md` — rewritten to focus on MCP-first workflow and Gemma patterns
- `lightdash-examples.md` → renamed to `gemma-examples.md` with format note
- Prominent `config.meta` vs bare `meta:` warning (Gemma uses `config.meta`, native skill uses `meta:`)

**Removed:**
- `lightdash-yaml-reference.md` — now covered by native skill's dimensions/metrics/tables/joins references
- `lightdash-dashboards-as-code.md` — now covered by native skill's dashboard-reference, charts-reference, cli-reference

## 1.1.0 — 2026-03-30

### lightdash-dashboards skill

- Add "YAML First" principle — prefer YAML files over API changes
- Document axis labels (`eChartsConfig.xAxis`/`yAxis`) for cartesian charts
- Document `stack100` layout mode for 100% normalized stacking
- Document `additionalMetrics` for chart-level custom calculated metrics
- Add REST API endpoint reference (create, update, delete charts and dashboards)
- Add API vs YAML drift warning and recommended sync workflow