Repository navigation
v0.8.0
Models can now be told how to write Scenet, and can check what they wrote: a spec pack, an
Agent Skill and an MCP server. A comic's marks — sweat, dizziness, oaths, dust — join the
language, and diagnostics in comic scripts and shared casts now point at the right line.
Added
- Emanata: what a comic draws around a character. A cast member takes
marks:, a list
from Mort Walker's Lexicon of Comicana:plewds(sweat flying off the head),squeans
(dizziness),grawlixes(an oath, as a spiral, a star, a bolt and a hash) andbriffits
(the dust of a hasty exit). A list rather than a secondexpression:, because they compose
— a character can be angry and sweating. Every puppet gets every mark; nothing new is
declared per puppet. Atlong_shoteach mark collapses to a dot, and a figure too small to
have a face has none. (#21) - Marks cost a balloon space, and never move anybody. They are drawn outside the head,
where balloons go, so each mark has a zone that balloons and captions pay to cover —
weighted above covering a body, with no discount for the speaker. They stay out of the
hull, so staging, the camera and every figure are exactly where they would be without them,
and a crowded panel still compiles. The camera makes no room for them either, so a mark
cropped by a tight shot is reported in the compile notes. The debug overlay draws the zones. scripts/contact_sheet.py --marksrenders every mark across the shot ladder, and the
gallery gains23-emanata.scene.yaml.- A way to tell a model how to write Scenet. The spec pack puts the language
reference, the shot types, the comic-script format, the shipped characters, every
diagnostic rule, the JSON Schema and the whole gallery in one file, published at
/scenet-spec.mdbeside an
llms.txt. It is what to hand a chat app
that cannot run code, such as NotebookLM, which can then write a comic script for you to
compile.skills/scenetis
an Agent Skill for coding agents. All of it is generated from
the compiler's own sources, and a test fails if a committed copy goes stale. (#11) scenet mcp, an MCP server, so a model can validate its own panel, read findings
that name the rule, the line and the fix, and render the result with nobody relaying
errors. Five read-only tools —get_spec,list_puppets,validate,compile,
render— over stdio or Streamable HTTP, on protocol revision 2026-07-28. It needs the
new optional extra:pip install 'scenet[mcp]'. Aserver.jsondescribes it for the
official MCP registry. (#11)- Driving Scenet from a model,
a how-to for each kind of client, and two entries in prior art: WordsEye, the ancestor of
text-to-scene, and Gumin et al. 2025, the strongest argument against a declarative
language, recorded for what it actually found. (#11)
Changed
- Panel Core actors gain
marks,emanataandemanata_zones. All default to empty, so
format_versionstays 1 and a Core document written before them still reads. Every actor
now serialises the three keys, so a golden file captured against 0.7.0 will differ by them
— and by nothing else: every example in the repository lays out byte-identically.
Fixed
- A comic script's line numbers counted from the end of its front matter, not from the
top of the file, soscenet checkand the playground pointed several lines above the
fault in any script with a cast block — which is nearly all of them. - A panel in a comic script that failed validation — a misspelled
@shot:, say — was
reported at line 1 whichever panel it was. It is now reported at that panel'sPANEL
heading. - A bad name in a shared cast was reported once per panel, every copy pointing at the
panel rather than at the line that was wrong — in a comic script's front matter, all
of them at line 1. A fault in a scene's defaults or a script's front matter is now
reported once, where it is written. A panel's own mistakes still carry its name. scenet buildprinted a traceback for a file with an unsupported extension, and
scenet checkcalled the same fileok. Both now report it as a usage error, exit 2.scenet build foo.panel.ymlwrotefoo.panel.yml.svg..ymlis now named
exactly as.yamlis:foo.svg.- The command-line reference's
scenet check examples/gallery/*.yamlexamples failed,
because the glob also matched the gallery's manifest. CI's gallery check now includes
the gallery's comic script, which it had skipped.
Install
pip install scenet==0.8.0The VS Code extension is the attached scenet.vsix:
Extensions -> ... -> Install from VSIX...