@pixerate/editor 0.223.1 → 0.223.3

package/skills/pixerate-diagram-process-flow/evals/order-process.json

@@ -0,0 +1,73 @@
+{
+	"prompt": "Draw our order process as a flowchart: it starts when an order arrives, we validate it, then check whether it's paid. If it is, we ship it and the process ends; if not, we send a reminder and check payment again.",
+	"fixture": {
+		"editor": "diagram"
+	},
+	"checks": [
+		{
+			"why": "a flowchart with one direction",
+			"tool": "get_diagram",
+			"expect": {
+				"family": "flowchart",
+				"direction": {
+					"$in": [
+						"LR",
+						"TB",
+						"TD"
+					]
+				}
+			}
+		},
+		{
+			"why": "the payment check is a decision (diamond)",
+			"tool": "get_diagram",
+			"expect": {
+				"nodes": {
+					"$some": {
+						"shape": "diam",
+						"label": {
+							"$match": [
+								"paid|payment",
+								"i"
+							]
+						}
+					}
+				}
+			}
+		},
+		{
+			"why": "the decision's two exits are labelled",
+			"tool": "get_diagram",
+			"expect": {
+				"$expr": "(() => { const d = v.nodes.find((n) => n.shape === 'diam'); const out = v.edges.filter((e) => e.source === d.id); return out.length === 2 && out.every((e) => e.label); })()"
+			}
+		},
+		{
+			"why": "the reminder loops back to the decision",
+			"tool": "get_diagram",
+			"expect": {
+				"$expr": "(() => { const d = v.nodes.find((n) => n.shape === 'diam'); const r = v.nodes.find((n) => /remind/i.test(n.label)); return !!r && v.edges.some((e) => e.source === r.id && e.target === d.id); })()"
+			}
+		},
+		{
+			"why": "start and end are terminals (stadium or rounded)",
+			"tool": "get_diagram",
+			"expect": {
+				"nodes": {
+					"$expr": "v.filter((n) => ['stadium', 'rounded', 'circle', 'dbl-circ'].includes(n.shape)).length >= 2"
+				}
+			}
+		}
+	],
+	"solution": [
+		{
+			"tool": "load_diagram_mermaid",
+			"args": {
+				"source": "flowchart LR\n  start([Start]) --> validate[Validate order]\n  validate --> paid{Paid?}\n  paid -->|yes| ship[Ship order]\n  paid -->|no| remind[Send reminder]\n  remind --> paid\n  ship --> done([End])"
+			}
+		},
+		{
+			"tool": "get_diagram"
+		}
+	]
+}

package/skills/pixerate-diagram-process-flow/evals/swimlanes.json

@@ -0,0 +1,74 @@
+{
+	"prompt": "Put this process into swimlanes: the customer places and pays for the order, the shop validates and ships it.",
+	"fixture": {
+		"editor": "diagram",
+		"setup": [
+			{
+				"tool": "load_diagram_mermaid",
+				"args": {
+					"source": "flowchart LR\n  place[Place order] --> pay[Pay]\n  pay --> validate[Validate order]\n  validate --> ship[Ship order]"
+				}
+			}
+		]
+	},
+	"checks": [
+		{
+			"why": "two lanes, Customer and Shop",
+			"tool": "get_diagram",
+			"expect": {
+				"groups": {
+					"$length": 2,
+					"$some": {
+						"label": {
+							"$match": [
+								"customer",
+								"i"
+							]
+						}
+					},
+					"$expr": "v.some((g) => /shop/i.test(g.label))"
+				}
+			}
+		},
+		{
+			"why": "each step in its lane",
+			"tool": "get_diagram",
+			"expect": {
+				"$expr": "(() => { const lane = (re) => v.groups.find((g) => re.test(g.label)).id; const c = lane(/customer/i), s = lane(/shop/i); const p = (id) => v.nodes.find((n) => n.id === id).parentId; return p('place') === c && p('pay') === c && p('validate') === s && p('ship') === s; })()"
+			}
+		},
+		{
+			"why": "the flow is unchanged",
+			"tool": "get_diagram",
+			"expect": {
+				"edges": {
+					"$length": 3
+				}
+			}
+		}
+	],
+	"solution": [
+		{
+			"tool": "group_diagram_nodes",
+			"args": {
+				"nodeIds": [
+					"place",
+					"pay"
+				],
+				"label": "Customer",
+				"id": "customer"
+			}
+		},
+		{
+			"tool": "group_diagram_nodes",
+			"args": {
+				"nodeIds": [
+					"validate",
+					"ship"
+				],
+				"label": "Shop",
+				"id": "shop"
+			}
+		}
+	]
+}

package/skills/pixerate-diagram-process-flow/evals/tidy-decision.json

@@ -0,0 +1,76 @@
+{
+	"prompt": "The decision in this flowchart is hard to read: the condition and the outcomes are crammed into the node. Tidy it up.",
+	"fixture": {
+		"editor": "diagram",
+		"setup": [
+			{
+				"tool": "load_diagram_mermaid",
+				"args": {
+					"source": "flowchart LR\n  check{Has the payment been received? If yes ship, otherwise remind} --> ship[Ship order]\n  check --> remind[Send reminder]"
+				}
+			}
+		]
+	},
+	"checks": [
+		{
+			"why": "a short question in the decision (at most six words)",
+			"tool": "get_diagram",
+			"expect": {
+				"nodes": {
+					"$some": {
+						"id": "check",
+						"shape": "diam",
+						"label": {
+							"$expr": "v.trim().split(/\\s+/).length <= 6 && /\\?$/.test(v.trim())"
+						}
+					}
+				}
+			}
+		},
+		{
+			"why": "the outcomes are on the edges",
+			"tool": "get_diagram",
+			"expect": {
+				"edges": {
+					"$every": {
+						"label": {
+							"$match": [
+								"^(yes|no|paid|unpaid|received|not received)$",
+								"i"
+							]
+						}
+					}
+				}
+			}
+		}
+	],
+	"solution": [
+		{
+			"tool": "rename_diagram_node",
+			"args": {
+				"id": "check",
+				"label": "Payment received?"
+			}
+		},
+		{
+			"tool": "set_diagram_edge_label",
+			"args": {
+				"id": {
+					"$read": "get_diagram",
+					"path": "edges.0.id"
+				},
+				"label": "yes"
+			}
+		},
+		{
+			"tool": "set_diagram_edge_label",
+			"args": {
+				"id": {
+					"$read": "get_diagram",
+					"path": "edges.1.id"
+				},
+				"label": "no"
+			}
+		}
+	]
+}

package/skills/pixerate-spreadsheet/SKILL.md

@@ -21,6 +21,8 @@ For these jobs, load the workflow skill too: it has the method, the checks betwe
 the pitfalls, and uses the tools below.
 
 - `pixerate-spreadsheet-clean-import`: tidying imported or pasted data: structure, headers, types, dates, duplicates.
+- `pixerate-spreadsheet-analysis`: summaries, growth, shares and rankings as formulas that reconcile.
+- `pixerate-spreadsheet-financial-model`: inputs, consistent calculation rows, scenarios and audits.
 
 ## Working method
 

package/skills/pixerate-spreadsheet-analysis/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: pixerate-spreadsheet-analysis
+description: The analysis workflow in a Pixerate spreadsheet - turning tidy data into answers with live formulas - summary tables by category (SUMIFS, COUNTIFS, AVERAGEIFS), distinct lists with UNIQUE, ranked and filtered views with SORT and FILTER, period totals and growth, shares of a total, checks that the summary reconciles with the data, and handing the result to a chart. Use when asked to summarise, total, count, average, group, pivot, rank, compare, break down or analyse data in a spreadsheet, work out growth or percentages, find the top items, or prepare numbers for a chart, or when get_range and set_range are available. Load with pixerate-spreadsheet, which lists every tool.
+metadata:
+  kind: workflow
+  reference: pixerate-spreadsheet
+---
+
+# Analysing data in a spreadsheet
+
+An analysis is a set of formulas that answer a question from the data and keep answering it
+when the data changes. Start from tidy data (one header row, one record per row; clean it first
+with `pixerate-spreadsheet-clean-import` if needed), put each summary in its own block beside or
+below the data, and make every number a formula over the data, never a typed result.
+
+This skill is the method. `pixerate-spreadsheet` has the full tool reference and the supported
+functions; for the chart that shows the result, see `pixerate-chart-choose-and-build`.
+
+## Goal and quality bar
+
+- Every result is a formula over the data (`SUMIFS`, `COUNTIFS`, `AVERAGEIFS`, `FILTER`,
+  `UNIQUE`, `SORT`), with absolute references to the data range, so it updates and can be
+  checked.
+- Summaries have a header row and one row per group; nothing is typed over a formula.
+- The summary reconciles: group totals add up to the data's total.
+- No formula errors (`get_range` `errors` empty); expected errors handled explicitly
+  (`IFERROR` around a division by a possible zero), and blanks where a value does not apply.
+- The data itself is untouched.
+
+## Inputs to confirm
+
+- **The question** (totals by region, growth by month, top products) and the measure.
+- **Where the result goes** (a cell such as G1, or below the data).
+- **Groups:** a fixed list the user gives, or every distinct value in the data (`UNIQUE`).
+
+## Working method
+
+1. **Read the data.** `get_range` the header and a sample; note the data range, which column is
+   the group and which the measure, and whether it is tidy.
+   **Check:** one header row, one record per row, numbers as numbers.
+2. **Lay out the summary** in an empty area: a header row, then one row per group. List groups
+   yourself when there are few and fixed, or `=UNIQUE(B2:B500)` for every value (leave room for
+   it to spill).
+3. **Write the formulas in one block.** `set_range` with the header and a formula per row, each
+   with absolute data references and a relative group cell: `=SUMIFS($D$2:$D$500,$B$2:$B$500,G2)`.
+   **Check:** the returned `errors` is empty.
+4. **Reconcile.** Add a total row (`=SUM(H2:H5)`) and compare it with `=SUM($D$2:$D$500)`; for
+   counts, with `=COUNTA` of the key column.
+   **Check:** they match; if not, a group is missing or a value is text.
+5. **Derived measures**: growth `=B3/B2-1` (blank for the first period), share `=H2/SUM($H$2:$H$5)`,
+   rank `=RANK(H2,$H$2:$H$5)`, ranked lists `=SORT(G2:H5,2,-1)`.
+   **Check:** `get_range` values match a hand calculation for one row.
+6. **Hand over.** Tell the user where the summary is and what each column means; to chart it,
+   pass the summary block (categories and values) to the chart editor's `set_chart_data`.
+
+## Decision table
+
+| Question | Formula |
+| --- | --- |
+| Total per group | `SUMIFS(measure, group_range, group)` |
+| How many per group | `COUNTIFS(group_range, group)` |
+| Average per group | `AVERAGEIFS(measure, group_range, group)` |
+| Two conditions (region and month) | `SUMIFS` with two criteria pairs |
+| Every distinct group | `UNIQUE(group_range)`, spilled |
+| Rows that meet a condition | `FILTER(data, condition)` |
+| Top items | `SORT` (or `SORTBY`) the summary by its total, descending |
+| Change from the previous period | `=this/previous-1`, first period blank |
+| Share of total | `=value/SUM($total_range)` |
+
+## Recipes
+
+**Totals by region at G1.** `set_range` from G1 with `[["Region", "Total"], ["North",
+"=SUMIFS($D$2:$D$11,$B$2:$B$11,G2)"], ...]` (each row's formula pointing at its own G cell).
+
+**Month-over-month growth in C.** `set_range` from C1: `[["Growth"], [null], ["=B3/B2-1"],
+["=B4/B3-1"], ...]`.
+
+**Orders and average per product.** Columns `=COUNTIFS($C$2:$C$11,G2)` and
+`=AVERAGEIFS($D$2:$D$11,$C$2:$C$11,G2)`.
+
+## Pitfalls
+
+- **Typed results.** A number typed into a summary does not update; always a formula.
+- **Relative data references.** `D2:D11` shifts when you write the formula down; use `$D$2:$D$11`.
+- **Text numbers** in the measure column are skipped by `SUMIFS`; clean the data first.
+- **Spills blocked**: `UNIQUE`, `FILTER` and `SORT` need empty cells below and to the right.
+- **Totals inside the data range** double-count; keep summaries outside it.
+- **0 for "no previous period"** misleads averages; leave it blank.
+- **`set_range` writes formulas as given**: write each row's own references.
+
+## Tools used
+
+- `get_range`: read the data and check every result and error
+- `set_range`: write summary blocks with headers and formulas, one undo step
+- `set_cell`: fix one formula
+- `insert_columns`, `insert_rows`: make room for a summary
+- `undo_spreadsheet`: take back a step

package/skills/pixerate-spreadsheet-analysis/evals/count-and-average.json

@@ -0,0 +1,148 @@
+{
+	"prompt": "For each product, show how many orders there were and the average order amount, in a small table starting at G1 (Product, Orders, Average), with formulas.",
+	"fixture": {
+		"editor": "spreadsheet",
+		"rows": [
+			[
+				"Date",
+				"Region",
+				"Product",
+				"Amount"
+			],
+			[
+				"2026-01-05",
+				"North",
+				"Widget",
+				120
+			],
+			[
+				"2026-01-07",
+				"South",
+				"Gadget",
+				80
+			],
+			[
+				"2026-01-12",
+				"North",
+				"Gadget",
+				95
+			],
+			[
+				"2026-01-15",
+				"East",
+				"Widget",
+				60
+			],
+			[
+				"2026-01-20",
+				"West",
+				"Widget",
+				150
+			],
+			[
+				"2026-02-02",
+				"South",
+				"Widget",
+				110
+			],
+			[
+				"2026-02-08",
+				"East",
+				"Gadget",
+				70
+			],
+			[
+				"2026-02-11",
+				"North",
+				"Widget",
+				130
+			],
+			[
+				"2026-02-19",
+				"West",
+				"Gadget",
+				90
+			],
+			[
+				"2026-02-25",
+				"South",
+				"Gadget",
+				85
+			]
+		]
+	},
+	"checks": [
+		{
+			"why": "Widget: 5 orders averaging 114; Gadget: 5 orders averaging 84",
+			"tool": "get_range",
+			"args": {
+				"range": "G2:I10"
+			},
+			"expect": {
+				"values": {
+					"$nonEmpty": {
+						"$length": 2,
+						"$expr": "v.some((r) => r[0] === 'Widget' && r[1] === 5 && Math.abs(r[2] - 114) < 0.01) && v.some((r) => r[0] === 'Gadget' && r[1] === 5 && Math.abs(r[2] - 84) < 0.01)"
+					}
+				}
+			}
+		},
+		{
+			"why": "formulas for the counts and averages",
+			"tool": "get_range",
+			"args": {
+				"range": "H2:I3"
+			},
+			"expect": {
+				"raw": {
+					"$every": {
+						"$every": {
+							"$match": "^="
+						}
+					}
+				}
+			}
+		},
+		{
+			"why": "headers",
+			"tool": "get_range",
+			"args": {
+				"range": "G1:I1"
+			},
+			"expect": {
+				"values": [
+					{
+						"$every": {
+							"$match": "\\S"
+						}
+					}
+				]
+			}
+		}
+	],
+	"solution": [
+		{
+			"tool": "set_range",
+			"args": {
+				"start": "G1",
+				"values": [
+					[
+						"Product",
+						"Orders",
+						"Average"
+					],
+					[
+						"Widget",
+						"=COUNTIFS($C$2:$C$11,G2)",
+						"=AVERAGEIFS($D$2:$D$11,$C$2:$C$11,G2)"
+					],
+					[
+						"Gadget",
+						"=COUNTIFS($C$2:$C$11,G3)",
+						"=AVERAGEIFS($D$2:$D$11,$C$2:$C$11,G3)"
+					]
+				]
+			}
+		}
+	]
+}

package/skills/pixerate-spreadsheet-analysis/evals/month-over-month.json

@@ -0,0 +1,128 @@
+{
+	"prompt": "Add month-over-month growth in column C (header in C1) as a fraction (0.1 for 10 %), with formulas. January has no previous month.",
+	"fixture": {
+		"editor": "spreadsheet",
+		"rows": [
+			[
+				"Month",
+				"Revenue"
+			],
+			[
+				"Jan",
+				100
+			],
+			[
+				"Feb",
+				110
+			],
+			[
+				"Mar",
+				99
+			],
+			[
+				"Apr",
+				121
+			],
+			[
+				"May",
+				121
+			],
+			[
+				"Jun",
+				133
+			]
+		]
+	},
+	"checks": [
+		{
+			"why": "growth for February to June",
+			"tool": "get_range",
+			"args": {
+				"range": "C3:C7"
+			},
+			"expect": {
+				"values": {
+					"$expr": "[0.1, -0.1, 0.2222, 0, 0.0992].every((g, i) => Math.abs(v[i][0] - g) < 0.001)"
+				}
+			}
+		},
+		{
+			"why": "formulas, not typed numbers",
+			"tool": "get_range",
+			"args": {
+				"range": "C3:C7"
+			},
+			"expect": {
+				"raw": {
+					"$every": {
+						"$every": {
+							"$match": "^="
+						}
+					}
+				}
+			}
+		},
+		{
+			"why": "January is left empty, not 0 or an error",
+			"tool": "get_range",
+			"args": {
+				"range": "C2"
+			},
+			"expect": {
+				"values": [
+					[
+						""
+					]
+				],
+				"errors": []
+			}
+		},
+		{
+			"why": "a header",
+			"tool": "get_range",
+			"args": {
+				"range": "C1"
+			},
+			"expect": {
+				"values": [
+					[
+						{
+							"$match": "\\S"
+						}
+					]
+				]
+			}
+		}
+	],
+	"solution": [
+		{
+			"tool": "set_range",
+			"args": {
+				"start": "C1",
+				"values": [
+					[
+						"Growth"
+					],
+					[
+						null
+					],
+					[
+						"=B3/B2-1"
+					],
+					[
+						"=B4/B3-1"
+					],
+					[
+						"=B5/B4-1"
+					],
+					[
+						"=B6/B5-1"
+					],
+					[
+						"=B7/B6-1"
+					]
+				]
+			}
+		}
+	]
+}