ggaction 0.0.9 → 0.0.11

package/knowledge/mcp-resources.json

@@ -1,95 +1 @@
-{
-  "schemaVersion": 2,
-  "overview": {
-    "title": "ggaction compact authoring overview",
-    "text": "Use search_ggaction once with only the exact user chart request; do not append dataset contents or code scaffolding. The result contains exact authoring imports, chart() initialization, non-duplicated createCanvas and createData prerequisites, immutable executable steps with deterministic runtime dependencies closed, ordered actionPlan entries, exactCalls, required option names, canonical routes, terminal unsupported constraints, and open unresolved decisions. Do not preload the full documentation. Read an action card when one exact action needs more detail. Read only the resource URIs attached to unresolved entries; unsupported entries are terminal and require no documentation read. The server is read-only and never executes chart code."
-  },
-  "recipes": [
-    {
-      "id": "scatter-svg",
-      "title": "Scatterplot with a bottom color legend and SVG output",
-      "summary": "Selects the chart facade, legend layout action, and browser-safe SVG renderer in execution order.",
-      "query": "scatter plot with a color legend at bottom as svg"
-    },
-    {
-      "id": "moving-average-line-png",
-      "title": "Moving-average line chart as PNG",
-      "summary": "Combines a window transform, line facade, guides, and the Node PNG renderer.",
-      "query": "moving average line chart with axes and export png"
-    },
-    {
-      "id": "binned-heatmap",
-      "title": "Binned heatmap with guides",
-      "summary": "Uses the heatmap facade to own 2D binning, position, color, axes, and legend requirements.",
-      "query": "binned heatmap with color legend and axes"
-    },
-    {
-      "id": "regression-scatterplot",
-      "title": "Scatterplot with a regression layer",
-      "summary": "Builds the scatterplot before adding the statistical regression layer.",
-      "query": "scatter plot with a regression line"
-    },
-    {
-      "id": "selection-highlight",
-      "title": "Stored selection and highlight",
-      "summary": "Stores a named mark selection before applying a graphical highlight to that selection.",
-      "query": "store selection then highlight marks"
-    },
-    {
-      "id": "parallel-svg",
-      "title": "Styled parallel coordinates as SVG",
-      "summary": "Combines parallel coordinates, color and dash encodings, guides, and SVG output.",
-      "query": "parallel coordinates with color encoding, stroke dash encoding, axes, and legend as svg"
-    },
-    {
-      "id": "facet-shared-guides",
-      "title": "Small multiples with shared guides",
-      "summary": "Uses the facet action as the owner of the small-multiple layout and shared guides.",
-      "query": "small multiples with shared legend and axes"
-    },
-    {
-      "id": "horizontal-composition-svg",
-      "title": "Horizontal chart composition as SVG",
-      "summary": "Composes complete programs horizontally before serializing the parent program to SVG.",
-      "query": "put charts side by side and export svg"
-    }
-  ],
-  "docs": [
-    {
-      "id": "choose-chart-type",
-      "title": "Choose a chart or mark type",
-      "route": "/api/basic-charts/",
-      "text": "# Choose a chart or mark type\n\nName the intended chart or mark. Common complete chart facades are `createScatterPlot`, `createLinePlot`, `createBarPlot`, `createHistogram`, and `createHeatmap`. For lower-level authoring, choose a mark such as point, line, area, bar, rect, rule, tick, text, or arc, then add its required position encodings. Run `search_ggaction` again with the chosen chart type."
-    },
-    {
-      "id": "choose-renderer",
-      "title": "Choose an output renderer",
-      "route": "/api/rendering/",
-      "text": "# Choose an output renderer\n\nUse `render(program, context)` for Browser Canvas, `renderToSVG(program)` for a browser-safe SVG string, `renderToPNG(program, output)` for Node PNG output, or `renderToPDF(program, output)` for a single-page vector PDF. Run `search_ggaction` again with one explicit format. JPEG output is not currently supported."
-    },
-    {
-      "id": "legend-layout",
-      "title": "Resolve legend layout requirements",
-      "route": "/api/legends/",
-      "text": "# Resolve legend layout requirements\n\nA single legend resource can occupy one position at a time. Choose `top`, `bottom`, `left`, or `right`, or give distinct legends explicit IDs and edit each target separately. Run `search_ggaction` again with one position per legend."
-    },
-    {
-      "id": "unsupported-capabilities",
-      "title": "Current static-chart limitations",
-      "route": "/supported-features/",
-      "text": "# Current static-chart limitations\n\nThe current authoring contract does not provide geographic maps, animation, interactive event handling, 3D charts, or JPEG rendering. The compact resolver reports these requirements explicitly instead of substituting a different chart. Consult the supported-features route before redesigning the task with current static actions."
-    },
-    {
-      "id": "getting-started",
-      "title": "Clarify an unrecognized authoring request",
-      "route": "/getting-started/",
-      "text": "# Clarify an authoring request\n\nDescribe the chart or mark, its data/transform needs, position and appearance encodings, guides or layout, and output format in one request. Exact action names are also accepted. Example: `scatter plot with x and y, a bottom color legend, and SVG output`."
-    },
-    {
-      "id": "action-reference",
-      "title": "Resolve a current action gap",
-      "route": "/reference/actions/",
-      "text": "# Resolve a current action gap\n\nUse the complete action reference only for a constraint that the compact resolver recognized but could not cover. Confirm the exact action signature, required resource ID, and supported options, then rerun `search_ggaction` with the exact action name and complete task request."
-    }
-  ]
-}
+{"schemaVersion":2,"packageVersion":"0.0.11","overview":{"title":"ggaction compact authoring overview","text":"Use search_ggaction once with only the exact user chart request; do not append dataset contents or code scaffolding. The result contains exact authoring imports, chart() initialization, non-duplicated createCanvas and createData prerequisites, syntax-valid immutable steps with deterministic runtime dependencies closed, ordered actionPlan entries, applied options, explicit placeholder bindings, unmatched requirements, canonical routes, terminal unsupported constraints, and open unresolved decisions. Do not treat template field names as inferred dataset facts. Do not preload the full documentation. Read an action card when one exact action needs more detail. Read only the resource URIs attached to unresolved entries; unsupported entries are terminal and require no documentation read. The server is read-only and never executes chart code."},"recipes":[{"id":"scatter-svg","title":"Scatterplot with a bottom color legend and SVG output","summary":"Selects the chart facade, legend layout action, and browser-safe SVG renderer in execution order.","query":"scatter plot with a color legend at bottom as svg"},{"id":"moving-average-line-png","title":"Moving-average line chart as PNG","summary":"Combines a window transform, line facade, guides, and the Node PNG renderer.","query":"moving average line chart with axes and export png"},{"id":"binned-heatmap","title":"Binned heatmap with guides","summary":"Uses the heatmap facade to own 2D binning, position, color, axes, and legend requirements.","query":"binned heatmap with color legend and axes"},{"id":"regression-scatterplot","title":"Scatterplot with a regression layer","summary":"Builds the scatterplot before adding the statistical regression layer.","query":"scatter plot with a regression line"},{"id":"selection-highlight","title":"Stored selection and highlight","summary":"Stores a named mark selection before applying a graphical highlight to that selection.","query":"store selection then highlight marks"},{"id":"parallel-svg","title":"Styled parallel coordinates as SVG","summary":"Combines parallel coordinates, color and dash encodings, guides, and SVG output.","query":"parallel coordinates with color encoding, stroke dash encoding, axes, and legend as svg"},{"id":"facet-shared-guides","title":"Small multiples with shared guides","summary":"Uses the facet action as the owner of the small-multiple layout and shared guides.","query":"small multiples with shared legend and axes"},{"id":"horizontal-composition-svg","title":"Horizontal chart composition as SVG","summary":"Composes complete programs horizontally before serializing the parent program to SVG.","query":"put charts side by side and export svg"}],"docs":[{"id":"choose-chart-type","title":"Choose a chart or mark type","route":"/api/basic-charts/","text":"# Choose a chart or mark type\n\nName the intended chart or mark. Common complete chart facades are `createScatterPlot`, `createLinePlot`, `createBarPlot`, `createHistogram`, and `createHeatmap`. For lower-level authoring, choose a mark such as point, line, area, bar, rect, rule, tick, text, or arc, then add its required position encodings. Run `search_ggaction` again with the chosen chart type."},{"id":"choose-renderer","title":"Choose an output renderer","route":"/api/rendering/","text":"# Choose an output renderer\n\nUse `render(program, context)` for Browser Canvas, `renderToSVG(program)` for a browser-safe SVG string, `renderToPNG(program, output)` for Node PNG output, or `renderToPDF(program, output)` for a single-page vector PDF. Run `search_ggaction` again with one explicit format. JPEG output is not currently supported."},{"id":"legend-layout","title":"Resolve legend layout requirements","route":"/api/legends/","text":"# Resolve legend layout requirements\n\nA single legend resource can occupy one position at a time. Choose `top`, `bottom`, `left`, or `right`, or give distinct legends explicit IDs and edit each target separately. Run `search_ggaction` again with one position per legend."},{"id":"unsupported-capabilities","title":"Current static-chart limitations","route":"/supported-features/","text":"# Current static-chart limitations\n\nThe current authoring contract does not provide geographic maps, animation, interactive event handling, 3D charts, or JPEG rendering. The compact resolver reports these requirements explicitly instead of substituting a different chart. Consult the supported-features route before redesigning the task with current static actions."},{"id":"getting-started","title":"Clarify an unrecognized authoring request","route":"/getting-started/","text":"# Clarify an authoring request\n\nDescribe the chart or mark, its data/transform needs, position and appearance encodings, guides or layout, and output format in one request. Exact action names are also accepted. Example: `scatter plot with x and y, a bottom color legend, and SVG output`."},{"id":"action-reference","title":"Resolve a current action gap","route":"/reference/actions/","text":"# Resolve a current action gap\n\nUse the complete action reference only for a constraint that the compact resolver recognized but could not cover. Confirm the exact action signature, required resource ID, and supported options, then rerun `search_ggaction` with the exact action name and complete task request."},{"id":"responsive-layout","title":"Resolve responsive size and pixel density","route":"/responsive-charts/","text":"# Resolve responsive layout\n\nA ggaction program is immutable and has concrete Canvas dimensions. Measure the host container, choose the intended aspect ratio and pixel ratio, rebuild with `editCanvas`, and rerender from a `ResizeObserver`. Do not rely on CSS scaling as chart layout. Run `search_ggaction` again only after concrete dimensions or a host resize policy are known."},{"id":"accessibility","title":"Resolve output accessibility requirements","route":"/accessibility/","text":"# Resolve output accessibility\n\nChoose an output-specific accessible name and description, provide a data-table or textual alternative, and avoid color-only meaning. SVG supports explicit `title` and `description` renderer options. Canvas requires host ARIA and fallback content. Static output does not add keyboard interaction or tooltips."}]}

package/knowledge/mcp-resources.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://ggaction.github.io/ggaction/schemas/mcp-resources.schema.json","title":"ggaction bounded MCP resource catalog","type":"object","additionalProperties":false,"required":["schemaVersion","packageVersion","overview","recipes","docs"],"properties":{"schemaVersion":{"const":2},"packageVersion":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"},"overview":{"type":"object","additionalProperties":false,"required":["title","text"],"properties":{"title":{"type":"string","minLength":3,"maxLength":120},"text":{"type":"string","minLength":40,"maxLength":3000}}},"recipes":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["id","title","summary","query"],"properties":{"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":3,"maxLength":120},"summary":{"type":"string","minLength":20,"maxLength":300},"query":{"type":"string","minLength":3,"maxLength":500}}}},"docs":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["id","title","route","text"],"properties":{"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":3,"maxLength":120},"route":{"type":"string","pattern":"^/"},"text":{"type":"string","minLength":40,"maxLength":3000}}}}}}

package/knowledge/task-packet.schema.json

@@ -1,159 +1 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://ggaction.github.io/ggaction/schemas/task-packet.schema.json",
-  "title": "ggaction compact task packet",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "query",
-    "matchedConstraints",
-    "actionPlan",
-    "exactCalls",
-    "authoring",
-    "unsupported",
-    "unresolved",
-    "candidates"
-  ],
-  "properties": {
-    "schemaVersion": { "const": 3 },
-    "query": { "type": "string", "minLength": 1, "maxLength": 500 },
-    "matchedConstraints": {
-      "type": "array",
-      "maxItems": 30,
-      "uniqueItems": true,
-      "items": { "type": "string", "minLength": 3, "maxLength": 100 }
-    },
-    "actionPlan": {
-      "type": "array",
-      "maxItems": 20,
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": [
-          "step",
-          "id",
-          "kind",
-          "name",
-          "constraints",
-          "requiredOptions",
-          "signature",
-          "route"
-        ],
-        "properties": {
-          "step": { "type": "integer", "minimum": 1 },
-          "id": { "type": "string", "minLength": 3 },
-          "kind": { "enum": ["action", "runtime"] },
-          "name": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9]*$" },
-          "constraints": {
-            "type": "array",
-            "minItems": 1,
-            "uniqueItems": true,
-            "items": { "type": "string", "minLength": 3 }
-          },
-          "requiredOptions": {
-            "type": "array",
-            "uniqueItems": true,
-            "items": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9]*$" }
-          },
-          "signature": { "type": "string", "minLength": 8 },
-          "route": { "type": "string", "pattern": "^/reference/" }
-        }
-      }
-    },
-    "exactCalls": {
-      "type": "array",
-      "maxItems": 20,
-      "items": { "type": "string", "minLength": 3, "maxLength": 700 }
-    },
-    "authoring": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["imports", "initialize", "prerequisites", "steps"],
-      "properties": {
-        "imports": {
-          "type": "array",
-          "minItems": 1,
-          "maxItems": 4,
-          "uniqueItems": true,
-          "items": { "type": "string", "minLength": 30, "maxLength": 90 }
-        },
-        "initialize": { "const": "let program = chart()" },
-        "prerequisites": {
-          "type": "array",
-          "minItems": 2,
-          "maxItems": 2,
-          "items": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["id", "signature", "call", "bindings"],
-            "properties": {
-              "id": { "enum": ["action.createCanvas", "action.createData"] },
-              "signature": { "type": "string", "minLength": 8, "maxLength": 180 },
-              "call": { "type": "string", "minLength": 12, "maxLength": 180 },
-              "bindings": {
-                "type": "array",
-                "maxItems": 4,
-                "uniqueItems": true,
-                "items": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9]*$" }
-              }
-            }
-          }
-        },
-        "steps": {
-          "type": "array",
-          "maxItems": 20,
-          "items": { "type": "string", "minLength": 3, "maxLength": 760 }
-        }
-      }
-    },
-    "unsupported": {
-      "type": "array",
-      "maxItems": 10,
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["constraint", "reason"],
-        "properties": {
-          "constraint": { "type": "string", "pattern": "^unsupported\\." },
-          "reason": { "type": "string", "minLength": 10, "maxLength": 240 }
-        }
-      }
-    },
-    "unresolved": {
-      "type": "array",
-      "maxItems": 30,
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["constraint", "reason", "resources"],
-        "properties": {
-          "constraint": { "type": "string", "minLength": 3 },
-          "reason": { "type": "string", "minLength": 10, "maxLength": 240 },
-          "resources": {
-            "type": "array",
-            "minItems": 1,
-            "maxItems": 2,
-            "uniqueItems": true,
-            "items": { "type": "string", "pattern": "^ggaction://docs/[a-z0-9-]+$" }
-          }
-        }
-      }
-    },
-    "candidates": {
-      "type": "array",
-      "maxItems": 3,
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["id", "kind", "name", "route"],
-        "properties": {
-          "id": { "type": "string", "minLength": 3 },
-          "kind": { "enum": ["action", "runtime"] },
-          "name": { "type": "string", "minLength": 2 },
-          "route": { "type": "string", "pattern": "^/reference/" }
-        }
-      }
-    }
-  }
-}
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://ggaction.github.io/ggaction/schemas/task-packet.schema.json","title":"ggaction compact task packet","type":"object","additionalProperties":false,"required":["schemaVersion","packageVersion","query","matchedConstraints","actionPlan","exactCalls","appliedOptions","placeholderBindings","unmatchedRequirements","authoring","unsupported","unresolved","candidates"],"properties":{"schemaVersion":{"const":4},"packageVersion":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"},"query":{"type":"string","minLength":1,"maxLength":500},"matchedConstraints":{"type":"array","maxItems":30,"uniqueItems":true,"items":{"type":"string","minLength":3,"maxLength":100}},"actionPlan":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["step","id","kind","name","constraints","requiredOptions","signature","route"],"properties":{"step":{"type":"integer","minimum":1},"id":{"type":"string","minLength":3},"kind":{"enum":["action","runtime"]},"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"},"constraints":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":3}},"requiredOptions":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"}},"signature":{"type":"string","minLength":8},"route":{"type":"string","pattern":"^/reference/"}}}},"exactCalls":{"type":"array","maxItems":20,"items":{"type":"string","minLength":3,"maxLength":700}},"appliedOptions":{"type":"array","maxItems":30,"items":{"type":"object","additionalProperties":false,"required":["owner","option","value","source"],"properties":{"owner":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"},"option":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"},"value":{"type":"string","minLength":1,"maxLength":300},"source":{"type":"string","minLength":1,"maxLength":180}}}},"placeholderBindings":{"type":"array","maxItems":30,"items":{"type":"object","additionalProperties":false,"required":["name","kind","required","usedBy","reason"],"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"kind":{"enum":["binding","field","program","resource","runtime","text"]},"required":{"type":"boolean"},"usedBy":{"type":"array","minItems":1,"maxItems":20,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":80}},"reason":{"type":"string","minLength":20,"maxLength":240}}}},"unmatchedRequirements":{"type":"array","maxItems":30,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":180}},"authoring":{"type":"object","additionalProperties":false,"required":["imports","initialize","prerequisites","steps"],"properties":{"imports":{"type":"array","minItems":1,"maxItems":4,"uniqueItems":true,"items":{"type":"string","minLength":30,"maxLength":90}},"initialize":{"const":"let program = chart()"},"prerequisites":{"type":"array","minItems":0,"maxItems":2,"items":{"type":"object","additionalProperties":false,"required":["id","signature","call","bindings"],"properties":{"id":{"enum":["action.createCanvas","action.createData"]},"signature":{"type":"string","minLength":8,"maxLength":180},"call":{"type":"string","minLength":12,"maxLength":180},"bindings":{"type":"array","maxItems":4,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"}}}}},"steps":{"type":"array","maxItems":20,"items":{"type":"string","minLength":3,"maxLength":760}}}},"unsupported":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["constraint","reason"],"properties":{"constraint":{"type":"string","pattern":"^unsupported\\."},"reason":{"type":"string","minLength":10,"maxLength":240}}}},"unresolved":{"type":"array","maxItems":30,"items":{"type":"object","additionalProperties":false,"required":["constraint","reason","resources"],"properties":{"constraint":{"type":"string","minLength":3},"reason":{"type":"string","minLength":10,"maxLength":240},"resources":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"type":"string","pattern":"^ggaction://docs/[a-z0-9-]+$"}}}}},"candidates":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["id","kind","name","route"],"properties":{"id":{"type":"string","minLength":3},"kind":{"enum":["action","runtime"]},"name":{"type":"string","minLength":2},"route":{"type":"string","pattern":"^/reference/"}}}}}}