ggaction 0.0.8 → 0.0.10

package/CHANGELOG.md

@@ -4,6 +4,44 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.10] - 2026-08-11
+
+### Added
+
+- Added collision-safe import-time extension registration through
+  `registerExtension({ name, actions })`, including strict TypeScript module
+  augmentation for registered actions on the standard `chart()` program.
+- Added installed extension-authoring knowledge that guides LLM agents through
+  feature-first design, current ggaction reuse, lifecycle ownership, primitive
+  parity, and package-consumer verification.
+
+### Changed
+
+- Updated extension documentation and examples to make installable packages
+  compose through registration while retaining `ChartProgram` subclasses for
+  deliberately isolated programs.
+
+## [0.0.9] - 2026-08-10
+
+### Added
+
+- Added a package-local, read-only stdio MCP server with one bounded `search_ggaction` tool, selective resources,
+  executable authoring steps, and no hosted service, account, telemetry, chart execution, or arbitrary file access.
+- Added generated compact knowledge for all 173 current actions, deterministic multi-intent task resolution, explicit
+  unsupported and unresolved decisions, and exact Canvas, SVG, PNG, and PDF authoring bootstraps.
+
+### Changed
+
+- Added task-oriented LLM authoring and MCP documentation, installed-package MCP qualification, and a compact,
+  provenance-locked 576-run Terra/Luna/Nano benchmark record and benefit chart.
+- Kept per-request traces, intermediate checkpoints, aborted experimental generations, and obsolete paid runners out
+  of the default branch while retaining aggregate evidence and exact raw-result hashes.
+
+### Fixed
+
+- Treated materialized window-output fields as direct line values when no aggregate is requested, preserving moving
+  mean and sum results instead of reinterpreting them through the aggregate-line policy.
+
 ## [0.0.8] - 2026-08-04
 
 ### Added
@@ -176,6 +214,8 @@ All notable changes to `ggaction` are recorded in this file.
 - Cartesian charts are the complete current path. Polar semantic tokens exist only where explicitly documented and do
   not imply complete polar rendering.
 
+[0.0.10]: https://github.com/ggaction/ggaction/releases/tag/v0.0.10
+[0.0.9]: https://github.com/ggaction/ggaction/releases/tag/v0.0.9
 [0.0.8]: https://github.com/ggaction/ggaction/releases/tag/v0.0.8
 [0.0.7]: https://github.com/ggaction/ggaction/releases/tag/v0.0.7
 [0.0.6]: https://github.com/ggaction/ggaction/releases/tag/v0.0.6

package/README.md

@@ -51,6 +51,26 @@ const program = chart()
 - **Traceable** — retain high-level actions and the wrapped actions they invoke.
 - **Materialized** — actions create concrete backend-neutral graphics; rendering does not perform hidden semantic compilation.
 
+## MCP server for LLM
+
+ggaction includes a local, read-only MCP server that gives coding assistants
+current action names, exact call shapes, and task-specific authoring steps
+without loading the complete documentation.
+
+<p align="left">
+  <img src="./docs/assets/images/readme-mcp-benefits.svg" width="960" loading="lazy" alt="Across 576 fixed task runs, MCP with bounded fallback improved strict success and reduced tokens and model calls compared with public-documentation browsing for Terra, Luna, and Nano.">
+</p>
+
+Across a fixed 576-run evaluation, MCP-first authoring with bounded fallback
+improved strict task success while using fewer tokens and model calls for all
+three model sizes. The server runs locally over stdio and does not execute chart
+code, access arbitrary files, make network requests, require an account, or
+collect telemetry.
+
+[Set up the local MCP server](https://ggaction.github.io/ggaction/mcp/) ·
+[Inspect the benchmark record](./benchmarks/llm-authoring-v1/) ·
+[Read the complete evaluation report](./agent_docs/impl/roadmap5.4/phase6/ATTEMPT11.md)
+
 ## Quick start
 
 Install the current public release:
@@ -136,8 +156,9 @@ automatic undo stack; the application chooses which to retain or render.
 
 Use `createLinePlot`, `createBarPlot`, `createHistogram`, and `createHeatmap` for
 the other basic Cartesian charts. The `ggaction/basic` entry keeps this common
-creation path below a 120,000-byte gzip bundle budget while each facade still
-records its mark, encoding, and guide actions as trace children. Import from
+creation path at or below the current 120,000-byte gzip regression ceiling while
+each facade still records its mark, encoding, and guide actions as trace
+children. Import from
 `ggaction` when you need editing, selection, composition, alternative
 coordinates, or statistical layers. See the
 [Basic Charts API](https://ggaction.github.io/ggaction/api/basic-charts/).
@@ -177,19 +198,26 @@ The package is ESM-only and requires Node.js 20 or later.
 | --- | --- |
 | `ggaction` | Create chart programs and render them to Browser Canvas |
 | `ggaction/basic` | Create and render scatter, line, bar, histogram, and heatmap charts with a smaller browser bundle |
-| `ggaction/extension` | Author wrapped actions with public low-level primitives |
+| `ggaction/extension` | Author and register wrapped actions with public low-level primitives |
 | `ggaction/png` | Render a completed program to a PNG file in Node.js |
 | `ggaction/pdf` | Render a completed program to a single-page vector PDF file in Node.js |
 | `ggaction/svg` | Serialize a completed program to browser-safe SVG |
+| `ggaction-mcp` | Run the local read-only MCP authoring server over stdio in Node.js |
+
+All module entries include TypeScript declarations. The default, basic,
+extension, and SVG entries are browser-safe; the PNG and PDF adapters are
+Node-only.
 
-All entries include TypeScript declarations. The default, basic, extension, and
-SVG entries are browser-safe; the PNG and PDF adapters are Node-only.
+The installed package also includes the Node-only `ggaction-mcp` executable. It
+provides one local, read-only chart-authoring search tool and stays outside every
+browser entry. See the [local MCP guide](https://ggaction.github.io/ggaction/mcp/).
 
 ## Documentation
 
 - [Getting Started](https://ggaction.github.io/ggaction/getting-started/)
 - [Tutorials and Examples](https://ggaction.github.io/ggaction/tutorials/)
 - [Action Reference](https://ggaction.github.io/ggaction/reference/actions/)
+- [Local MCP for LLM Chart Authoring](https://ggaction.github.io/ggaction/mcp/)
 - [Concepts](https://ggaction.github.io/ggaction/concepts/chart-program/)
 - [Supported Features](https://ggaction.github.io/ggaction/supported-features/)
 
@@ -201,7 +229,7 @@ the extra discussion required before public API or architecture changes.
 
 ## Status and development
 
-> **Status:** `0.0.8` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
+> **Status:** `0.0.10` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
 
 ```bash
 npm install