mex-memory/mex / skills/mex-statechart
mex-statechart
VerifiedExplain complicated existing behavior using checked state diagrams. Use when asked for a state diagram, to diagram the previous explanation, show a bug or recovery path, compare a proposed fix or existing TLA+ spec, or derive a model from an agreed chart. Generates native Mermaid and a readable terminal fallback; optionally view and explicitly save in MEX Hub.
upstream/scripts/read-check.mjs
View on GitHubimport { isRecord } from "./lib.mjs";
import { SEP } from "./chart-parts.mjs";
const kindOf = (v) => (isRecord(v) ? "record" : Array.isArray(v) ? "list" : typeof v);
function shapeOf(graph, traces) {
const shape = new Map();
const walk = (o, path) => {
for (const [k, v] of Object.entries(o)) {
const p = [...path, k];
const id = p.join(SEP);
if (!shape.has(id)) shape.set(id, { path: p, kinds: new Set() });
shape.get(id).kinds.add(kindOf(v));
if (isRecord(v)) walk(v, p);
}
};
for (const n of graph.nodes.values()) walk(n.vars, []);
for (const t of traces) for (const s of t.steps) walk(s.vars, []);
return shape;
}
const disjoint = (a, b) => ![...b.kinds].some((k) => a.kinds.has(k));
const foreign = (a, b) => [...b.kinds].some((k) => !a.kinds.has(k));
function lacking(a, b) {
const out = [];
for (const [id, x] of a) {
const within = out.some((p) => id.startsWith(`${p.join(SEP)}${SEP}`));
if (!within && (!b.has(id) || disjoint(x, b.get(id)))) out.push(x.path);
}
return out;
}
const unreadOf = (a, b) =>
[...a].flatMap(([id, x]) =>
!b.has(id) || foreign(x, b.get(id)) ? [{ ...x, somewhere: b.has(id) }] : [],
);
function guard(vars, unread, label, at = "v") {
if (!unread.length || !isRecord(vars)) return vars;
const here = new Map();
const deeper = new Map();
for (const { path, ...x } of unread) {
const [k, ...rest] = path;
if (!rest.length) here.set(k, x);
else deeper.set(k, [...(deeper.get(k) ?? []), { ...x, path: rest }]);
}
const check = (target, k, listing) => {
const x = here.get(k);
const absent = !Object.hasOwn(target, k);
if (!x || (absent ? x.somewhere : x.kinds.has(kindOf(target[k])))) return;
const name = `${at}.${k}`.slice(2);
const has = absent ? `no ${name}` : `${name} as a value of another type`;
const does = listing ? `lists the fields of ${at}` : `reads ${at}.${k}`;
const hint = listing
? ", and read the fields it needs by name"
: absent
? `, or test "${k}" in ${at} first`
: "";
throw new Error(
`${label} has ${has}, and the mapping ${does} on its states. Label states and steps only from what both models have${hint}.`,
);
};
return new Proxy(vars, {
get(target, k) {
check(target, k, false);
return deeper.has(k) ? guard(target[k], deeper.get(k), label, `${at}.${k}`) : target[k];
},
ownKeys(target) {
for (const k of here.keys()) check(target, k, true);
return Reflect.ownKeys(target);
},
});
}
export function readCheck({ graph, rawTraces, secondGraph, rawSecondTraces, L }) {
const [a, b] = [shapeOf(graph, rawTraces), shapeOf(secondGraph, rawSecondTraces)];
const unread = unreadOf(a, b);
return {
lacks: lacking(a, b),
extra: lacking(b, a),
guard: (vars) => guard(vars, unread, L),
};
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |