surshar / claude-code

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

		@@ -2,10 +2,11 @@
2	2	import type { Backend, BackendHost, BackendProbe } from './types'
3	3
4	4	/**
5		- * The backend holding the session's directory: the first of `probes` that
6		- * answers one, else git when a git working tree holds it, else none. The
7		- * probes go first so a probe may claim a working copy by its own rule
8		- * (the nearer of two markers, say); a probe answers null wherever git
	5	+ * The backend holding the session's directory: another system's when its
	6	+ * probe answers first, else git when a git working tree holds it, else none.
	7	+ *
	8	+ * Other systems are asked first so one may claim a working copy by its own
	9	+ * rule (the nearer of two markers, say); each answers null wherever git
9	10	* should govern.
10	11	*
11	12	* @param host the bound host's runner and probes

		@@ -1,15 +1,12 @@
1	1	import type { BackendProbe } from './types'
2	2
3	3	/**
4		- * Where a host adds backends to the plugin: probes for version-control systems
5		- * other than git, consulted in insertion order before git (backendOf); a
6		- * probe answers null wherever git should govern. Empty as shipped, so the
7		- * plugin reads git alone. A host
8		- * that compiles the module in may add a probe once, before the plugin
9		- * registers; the module runs natively, so that probe is what
10		- * `session.start` sees. The module contract offers no other channel: the
11		- * options `register` receives are the manifest's userConfig, and the
12		- * shipped scan requires `register` itself to be a plain exported function.
	4	+ * Where a host adds backends: probes for version-control systems other than
	5	+ * git, asked in insertion order before git (backendOf). Empty as shipped.
	6	+ *
	7	+ * A host compiling the module in adds a probe once, before the plugin
	8	+ * registers: the module runs natively, and there is no other channel (the
	9	+ * options are the manifest's userConfig; the scan wants a plain function).
13	10	*/
14	11	// module-state-allow: module-evaluation code wiring — a compiling host adds its probe functions (code references, not runtime input) once before registration and never removes or rebinds them; tests pass probes to backendOf directly; a per-Host copy would hold the same functions
15	12	export const INSTALLED_BACKEND_PROBES = new Set<BackendProbe>()

		@@ -2,9 +2,8 @@
2	2	import type { BackendWords } from '../backend-words'
3	3
4	4	/**
5		- * The version-control system behind the pane, pinned once per session:
6		- * where its working tree is, which comparisons it offers, how it words
7		- * them, and the three reads the pane makes of it.
	5	+ * The version-control system behind the pane, pinned once per session: its
	6	+ * working tree, what it compares, how it words them, and the pane's reads.
8	7	*
9	8	* Git is the plugin's own backend; a host may install probes for others,
10	9	* consulted where no git working tree holds the directory (backendOf).
		@@ -16,7 +15,7 @@
16	15	repository: Pick<Git.Repository, 'toplevel'>
17	16
18	17	/**
19		- * The base modes the picker offers, in picker order.
	18	+ * What the picker offers to compare against, in its order.
20	19	*/
21	20	baseModes: readonly Git.BaseMode[]
22	21

		@@ -2,11 +2,12 @@
2	2	import type Host from '../../../host'
3	3
4	4	/**
5		- * What pinning a backend takes from the bound host: the raw process
6		- * runner (each backend names its own program, argv lead, environment and
7		- * timeout), the file probes, the engine's clock, the session's start as it
8		- * stands at each fetch (a later `session.start` moves it), and the
9		- * branch-base listener.
	5	+ * What pinning a backend takes from the bound host: its raw process runner,
	6	+ * file probes, clock, session start and branch-base listener.
	7	+ *
	8	+ * Each backend names its own program, argv lead, environment and timeout
	9	+ * to the runner; the session's start is read as it stands at each fetch
	10	+ * (a later `session.start` moves it).
10	11	*/
11	12	export type BackendHost = Pick<Host.Host, 'run' \| 'readFile'> &
12	13	Pick<Git.GitDeps, 'mtimeOf' \| 'entryKindsOf' \| 'onBranchBase'> & {

		@@ -3,7 +3,8 @@
3	3
4	4	/**
5	5	* Probes the session's directory for one backend's working tree: the
6		- * backend when it holds the directory, null when it does not or when git
7		- * should govern it instead (Git.gitBackendOf is git's).
	6	+ * backend when it holds the directory, else null.
	7	+ *
	8	+ * Null too where git should govern it instead (Git.gitBackendOf is git's).
8	9	*/
9	10	export type BackendProbe = (host: BackendHost) => Promise<Backend \| null>

		@@ -1,7 +1,9 @@
1	1	/**
2		- * The words the pane draws that name the backend: what uncommitted mode
3		- * compares against, the command whose failure the empty state names, the
4		- * tool that lists untracked files, and the note under an untracked row.
	2	+ * The words the pane draws that name the backend.
	3	+ *
	4	+ * What uncommitted mode compares against, the command whose failure the
	5	+ * empty state names, the tool that lists untracked files, and the note
	6	+ * under an untracked row.
5	7	*/
6	8	export type BackendWords = {
7	9	/**

		@@ -11,10 +11,11 @@
11	11
12	12	/**
13	13	* The git backend over the session's directory: the repository read with
14		- * one `rev-parse` in that directory, then every child pinned to it
15		- * (`--git-dir`, `--work-tree`, cwd the top) under the C locale and the
16		- * fetch's timeout (gitDiff.ts execPinnedGit).
	14	+ * one `rev-parse` in that directory, then every child pinned to it.
17	15	*
	16	+ * Each child runs with `--git-dir`, `--work-tree` and cwd the top, under
	17	+ * the C locale and the fetch's timeout (the built-in's execPinnedGit).
	18	+ *
18	19	* @param host the bound host's runner and probes
19	20	* @returns the backend, or null outside a git working tree
20	21	*/

		@@ -1,9 +1,10 @@
1	1	import type Backend from '../../backend'
2	2
3	3	/**
4		- * The pane's git words: compared with HEAD, read by `git diff`, untracked
5		- * files listed by git and staged with `git add :/…`, unquoted as
6		- * DiffDetailView words it.
	4	+ * The pane's git words, unquoted as DiffDetailView words them.
	5	+ *
	6	+ * Compared with HEAD, read by `git diff`, untracked files listed by git and
	7	+ * staged with `git add :/…`.
7	8	*/
8	9	export const GIT_WORDS: Backend.BackendWords = Object.freeze({
9	10	base: 'HEAD',

		@@ -3,12 +3,11 @@
3	3	import { MOST_UTF8_BYTES } from './most-utf8-bytes'
4	4
5	5	/**
6		- * Whether a listing arrived whole: every record terminated (NUL for git's
7		- * `-z` listings, a newline for line records) and the text short of the
8		- * host's output cap, so no record was cut or lost.
	6	+ * Whether a listing arrived whole, so no record was cut or lost.
9	7	*
10		- * A cut inside a multi-byte character costs the decoded text up to
11		- * MOST_UTF8_BYTES, hence the margin under the cap.
	8	+ * Every record is terminated (NUL for `-z` listings, a newline for line
	9	+ * records) and the text is short of the host's output cap by MOST_UTF8_BYTES,
	10	+ * what a cut inside a multi-byte character can cost the decoded text.
12	11	*
13	12	* @param stdout the listing as `$.process.run` returned it
14	13	* @param terminator what ends every record; NUL when absent

		@@ -3,10 +3,10 @@
3	3
4	4	/**
5	5	* A tier's tracked rows and totals with a listed set of untracked rows
6		- * after them (gitDiff.ts mergeSessionUntrackedFiles), or flagged withheld
7		- * when the lister gave no whole listing.
	6	+ * after them, or flagged withheld when the lister gave no whole listing.
8	7	*
9		- * A path a tracked row already holds keeps that row and counts once.
	8	+ * As the built-in's mergeSessionUntrackedFiles merges them, a path a
	9	+ * tracked row already holds keeps that row and counts once.
10	10	*
11	11	* @param result the tier's tracked rows and totals
12	12	* @param untracked the untracked rows, or null when their listing was withheld

		@@ -6,8 +6,7 @@
6	6
7	7	/**
8	8	* One settled fetch: the rows, the totals, what they compare, and what a
9		- * file's hunks must be read against so both agree, over the working tree's
10		- * top (every backend has one; git's other directories stay its own).
	9	+ * file's hunks are read against so both agree, over the working tree's top.
11	10	*
12	11	* `isUnborn`: a repository before its first commit (rows are the staged
13	12	* and new files, `baseRef` is `--cached`); `stalePaths`: files whose staged

		@@ -1,8 +1,9 @@
1	1	/**
2	2	* What a fetched diff compares: the working tree against its checked-out
3		- * commit (`base` names it as the pane should: `HEAD`, or a short sha where
4		- * the backend has no such word), or against the merge-base with the default
5		- * branch (`baseRef` the ref git was handed).
	3	+ * commit, or against the merge-base with the default branch.
	4	+ *
	5	+ * `base` names the commit as the pane should (`HEAD`, or a short sha where
	6	+ * the backend has no such word); `baseRef` is the ref git was handed.
6	7	*/
7	8	export type DiffSource =
8	9	\| { kind: 'working-tree'; base: string }

		@@ -105,7 +105,7 @@
105	105	registerCommand: (spec: CommandSpec) => Promise<unknown>
106	106
107	107	/**
108		- * `$.session.id`: the session the pane-shown row is latched to.
	108	+ * Which session the pane-shown row is latched to, as `$.session.id` says.
109	109	*/
110	110	sessionId: () => Promise<string>
111	111

		@@ -1,6 +1,8 @@
1	1	/**
2		- * The terminal width from which `/diff` opens the pane, and the first edit
3		- * opens it when the person kept it open before (the built-in sidebar's own
4		- * minimum).
	2	+ * The terminal width from which `/diff` opens the pane (the built-in
	3	+ * sidebar's own minimum).
	4	+ *
	5	+ * The first edit opens it from this width too, when the person kept it
	6	+ * open before.
5	7	*/
6	8	export const OPEN_MIN_COLUMNS = 110

		@@ -1,7 +1,9 @@
1	1	/**
2		- * `/diff`'s answer on a terminal narrower than the built-in panel shows on,
3		- * worded as the built-in words it; also the pane's one line where the
4		- * surface seats it inline (no room beside the transcript).
	2	+ * `/diff`'s answer on a terminal narrower than the built-in panel shows
	3	+ * on, worded as the built-in words it.
	4	+ *
	5	+ * Also the pane's one line where the surface seats it inline (no room
	6	+ * beside the transcript).
5	7	*/
6	8	export const RESIZE_TERMINAL_TEXT =
7	9	'Resize your terminal to at least 110 columns to show the diff panel'

		@@ -2,11 +2,12 @@
2	2	import type Git from '../../git'
3	3
4	4	/**
5		- * A requested mode's name for the base line; branch mode names its base
6		- * branch from the data, or says what stands in while none is known. A
7		- * working-tree diff names its own base (`HEAD`, a short sha); anything
8		- * else falls back to the backend's word for it.
	5	+ * A requested mode's name for the base line.
9	6	*
	7	+ * Branch mode names its base branch from the data, or says what stands in
	8	+ * while none is known. A working-tree diff names its own base (`HEAD`, a
	9	+ * short sha); anything else falls back to the backend's word for it.
	10	+ *
10	11	* @param requested the mode the person picked
11	12	* @param source what the data on screen compares
12	13	* @param phase `pending` while the requested mode's fetch has not landed

		@@ -6,9 +6,11 @@
6	6	import type { Source } from '../source'
7	7
8	8	/**
9		- * Everything one drawing of the pane reads: the last good fetch, what the
10		- * person picked, the selected file's body, the transcript's turns and todos,
11		- * and the pinned backend's words and base modes (git's until one is pinned).
	9	+ * Everything one drawing of the pane reads.
	10	+ *
	11	+ * The last good fetch, what the person picked, the selected file's body,
	12	+ * the transcript's turns and todos, and the pinned backend's words and
	13	+ * base modes (git's until one is pinned).
12	14	*/
13	15	export type PaneModel = {
14	16	words: Backend.BackendWords

		@@ -1,7 +1,8 @@
1	1	/**
2		- * What the plugin knows of its pane when `/diff` runs: whether it opened
3		- * it and never closed it, whether it drew when a redraw was asked, and the
4		- * terminal's width as last drawn (null before any draw).
	2	+ * What the plugin knows of its pane when `/diff` runs.
	3	+ *
	4	+ * Whether it opened it and never closed it, whether it drew when a redraw
	5	+ * was asked, and the terminal's width as last drawn (null before any draw).
5	6	*/
6	7	export type PaneBelief = {
7	8	isBelievedOpen: boolean

		@@ -3,12 +3,11 @@
3	3
4	4	/**
5	5	* What `/diff` does, the one place its toggle is decided: close only when
6		- * the plugin opened the pane and it still draws; otherwise open, focused,
7		- * unless the terminal is narrower than the built-in panel shows on, where
8		- * `/diff` answers the built-in's resize line instead (`too-narrow`).
	6	+ * the plugin opened the pane and it still draws; otherwise open, focused.
9	7	*
10		- * The person's close raises nothing this plugin hooks, so a pane believed
11		- * open is probed with a redraw first. A width not drawn yet opens.
	8	+ * Narrower than the built-in panel shows on, it answers the resize line
	9	+ * (`too-narrow`). The person's close raises nothing it hooks, so a pane
	10	+ * believed open is probed with a redraw first; a width not drawn yet opens.
12	11	*
13	12	* @param pane the plugin's belief, the probe's answer and the width
14	13	* @returns `close`, `open` or `too-narrow`

		@@ -7,9 +7,10 @@
7	7
8	8	/**
9	9	* The plugin's Recorder over the host: each row goes through the telemetry
10		- * built-in's `$.telemetry`, named and shaped as the built-in panel's own;
11		- * a missing noun or a refused row is dropped.
	10	+ * built-in's `$.telemetry`, named and shaped as the built-in panel's own.
12	11	*
	12	+ * A missing noun or a refused row is dropped.
	13	+ *
13	14	* @param host the engine as session.start bound it
14	15	* @returns the recorder
15	16	*/

		@@ -21,11 +21,9 @@
21	21	* Registers the diff pane: `/diff` once the built-in stands down, the
22	22	* pane's drawing and refresh, its opening on Claude's first edit, the ask.
23	23	*
24		- * `session.start` registers `/diff` (refused while the built-in holds it),
25		- * binds the host every pinned backend reads through, and pins the backend
26		- * (backendOf): one probe in flight, asked again on `/diff` until git answers.
27		- * On a terminal narrower than the built-in panel shows on, `/diff` answers
28		- * the built-in's resize line and opens nothing (paneToggleOf).
	24	+ * `session.start` registers `/diff`, binds the host every pinned backend
	25	+ * reads through (currentOf: the latest start's, the engine only before
	26	+ * bind()), and pins the backend (backendOf), asked again on `/diff`.
29	27	*
30	28	* @param on the engine's registrar
31	29	*/
		@@ -50,9 +48,6 @@
50	48	const timers = new Map<'refresh' \| 'redraw' \| 'poll', Timer>()
51	49	const loggedBaseKinds = new Set<'ok' \| 'sad'>()
52	50
53		- // The bound host once bind() has run (it sets `host` before pinning), so a
54		- // backend pinned under one session.start keeps reading through whatever
55		- // host a later session.start bound; `engine` only before that.
56	51	const currentOf = (engine: Host): Host => host ?? engine
57	52
58	53	const backendHostOf = (engine: Host): Backend.BackendHost => ({

		@@ -18,12 +18,9 @@
18	18	* The pane over the repository's diff now (ReplDiffSidebarBody, one file's
19	19	* body at a time): header, base line, todo bar, pickers, rows, detail.
20	20	*
21		- * The tests-and-generated toggle sits above the rows; the elision count, the
22		- * withheld-untracked note, the pre-session line and rows below them, a blank
23		- * row above that line and above its rows as the built-in leaves; the
24		- * selected file last. With no rows to list, the loading line, the empty
25		- * state or the too-many and only-hidden lines take the body instead
26		- * (messagePaneOf), the header keeping only the close.
	21	+ * The toggle sits above the rows; the elision count, withheld-untracked
	22	+ * note and pre-session line below, with blank rows as the built-in leaves.
	23	+ * With nothing to list, messagePaneOf draws the body, the header a close.
27	24	*
28	25	* @param kit the elements, the handlers, the width, the rows
29	26	* @param model the pane's state

		@@ -8,16 +8,11 @@
8	8
9	9	/**
10	10	* The pane while a message stands in for the list (ReplDiffSidebar's
11		- * centered body: the first fetch, the empty state, the too-many and
12		- * only-hidden states): the header block, the built-in's blank row under it,
13		- * the message with the pickers under it, the pre-session line.
	11	+ * centered body): the header, a blank row, the message, the pickers.
14	12	*
15		- * With nothing listed below and the rows to hold it, the message's lines
16		- * sit where the built-in centers them (half the spare rows above, rounded
17		- * down; each wrapped line centered on its own), the pickers right under
18		- * them and the pre-session line at the foot; otherwise it all stacks from
19		- * the top, the pickers on the blank row the built-in leaves above the
20		- * pre-session line (that blank row itself when there are none).
	13	+ * With nothing listed below and room, the lines sit where the built-in
	14	+ * centers them (half the spare rows above), the pickers under them;
	15	+ * otherwise all stacks from the top, the pickers over the pre-session line.
21	16	*
22	17	* @param kit the elements, the width, the body's rows
23	18	* @param pane the header block, the message's lines, the pickers, the

		@@ -3,9 +3,10 @@
3	3	import type PaneState from '../../../pane-state'
4	4
5	5	/**
6		- * The selected file as its body draws it: the path, what kind of row it is,
7		- * its hunks once read, whether it is armed for the next prompt, and the
8		- * backend's words for an untracked row's note.
	6	+ * The selected file as its body draws it.
	7	+ *
	8	+ * The path, what kind of row it is, its hunks once read, whether it is armed
	9	+ * for the next prompt, and the backend's words for an untracked row's note.
9	10	*/
10	11	export type DetailModel = {
11	12	words: Pick<Backend.BackendWords, 'untrackedNoteOf'>

		@@ -13,13 +13,12 @@
13	13	import { placeholderOf } from './placeholder-of'
14	14
15	15	/**
16		- * The selected file under the list: its bold path and asides, each name
17		- * cut from its start to the width, the ask Button, the built-in's dim rule
18		- * under them, the body.
	16	+ * The selected file under the list: its bold path and asides, the ask
	17	+ * Button, the built-in's dim rule under them, the body.
19	18	*
20		- * The body is a placeholder, or the hunks as the engine's diff `Code` blocks
21		- * (codeBlocksOf) named by the path, a dim divider where two meet at a hunk;
22		- * then the footer when anything was cut.
	19	+ * Each name is cut from its start to the width. The body is a placeholder,
	20	+ * or the hunks as the engine's diff `Code` blocks (codeBlocksOf), a dim
	21	+ * divider where two meet, then the footer when anything was cut.
23	22	*
24	23	* @param kit the elements and the width
25	24	* @param detail the selected file

		@@ -1,8 +1,8 @@
1	1	/**
2	2	* A file name safe to paste, unquoted, into a stage command in any shell
3		- * (POSIX, PowerShell, cmd): letters and digits of any script and `._/@+-`
4		- * only.
	3	+ * (POSIX, PowerShell, cmd).
5	4	*
6		- * No quote of any kind, no separator and no substitution can ride in it.
	5	+ * Letters and digits of any script and `._/@+-` only: no quote of any
	6	+ * kind, no separator and no substitution can ride in it.
7	7	*/
8	8	export const SAFE_PATHSPEC_PATTERN = /^[\p{L}\p{N}._/@+-]+$/u

		@@ -2,9 +2,10 @@
2	2	import type { Ui } from './ui'
3	3
4	4	/**
5		- * What every part of one drawing is handed: the surface's elements, the
6		- * controls' handlers, the body's width (`props.bodyColumns`) and its rows
7		- * (`props.scroll.bodyRows`).
	5	+ * What every part of one drawing is handed.
	6	+ *
	7	+ * The surface's elements, the controls' handlers, the body's width
	8	+ * (`props.bodyColumns`) and its rows (`props.scroll.bodyRows`).
8	9	*/
9	10	export type Kit = {
10	11	ui: Ui

		@@ -1,12 +1,14 @@
1	1	import { cellWidth } from '../cell-width'
2	2
3	3	/**
4		- * A line cut into rows of at most `columns` cells as Ink's `wrap` cuts the
5		- * built-in's empty state before it centers each row: at spaces, the space a
6		- * row breaks on kept at its end, a word wider than a row cut across rows.
	4	+ * A line cut into rows as Ink's `wrap` cuts the built-in's empty state
	5	+ * before it centers each row.
7	6	*
	7	+ * It cuts at spaces, keeping the space a row breaks on at its end; a word
	8	+ * wider than a row is cut across rows.
	9	+ *
8	10	* @param text one sanitized line
9		- * @param columns the width, at least one cell
	11	+ * @param columns the width, at least one cell; no row holds more
10	12	* @returns the rows, at least one
11	13	*/
12	14	export function wrappedLines(text: string, columns: number): string[] {

		@@ -15,10 +15,9 @@
15	15	* The diff pane's body for one `ui.render`: the repository's diff now, or
16	16	* the picked turn's edits while that turn still exists (a rewind drops it).
17	17	*
18		- * Seated inline (no room beside the transcript), only the built-in's line
19		- * asking for a wider terminal, as the built-in shows no panel there. Docked,
20		- * the body keeps the built-in's blank row above the header and blank last
21		- * column, so its rows sit and wrap where the built-in's do.
	18	+ * Seated inline, only the built-in's wider-terminal line, as it shows no
	19	+ * panel there; docked, the built-in's blank row above the header and blank
	20	+ * last column, so rows sit and wrap where the built-in's do.
22	21	*
23	22	* @param kit the elements, the handlers, the width
24	23	* @param model the pane's state

		@@ -12,9 +12,8 @@
12	12	* turn with edits, newest first) and, for the current source, the base.
13	13	*
14	14	* The source picker draws only when a turn exists, as DiffDialog hides its
15		- * tabs; the base picker is the built-in's ctrl+x b cycle as a Select over
16		- * the modes the backend offers, uncommitted mode naming the base as the
17		- * base line does (modeLabelOf).
	15	+ * tabs; the base picker is ctrl+x b's cycle as a Select over the backend's
	16	+ * modes, uncommitted naming the base as the base line does (modeLabelOf).
18	17	*
19	18	* @param kit the elements and the handlers
20	19	* @param model what is picked now and the turns to pick from

		@@ -11,9 +11,10 @@
11	11
12	12	/**
13	13	* The pane's first line (ReplDiffSidebar's header row): `N files changed
14		- * +A -R`, or nothing over an empty state, and the close `✕` at the right
15		- * edge either way.
	14	+ * +A -R`, or nothing over an empty state.
16	15	*
	16	+ * The close `✕` sits at the right edge either way.
	17	+ *
17	18	* @param kit the drawing's kit; its elements draw the line
18	19	* @param totals the header's counts, or null when there is nothing to count
19	20	* @returns the line

		@@ -1,6 +1,8 @@
1	1	/**
2		- * The shape of a Choice member: a snake_case token of at most 64 characters,
3		- * which may start with a digit (a bucket such as `110_to_143`), unlike a name
4		- * or a key (TOKEN).
	2	+ * The shape of a Choice member: a snake_case token of at most 64
	3	+ * characters.
	4	+ *
	5	+ * Unlike a name or a key (TOKEN), it may start with a digit (a bucket such
	6	+ * as `110_to_143`).
5	7	*/
6	8	export const CHOICE_TOKEN = /^[a-z0-9][a-z0-9_]{0,63}$/

		@@ -1,6 +1,7 @@
1	1	/**
2	2	* What an event's name starts with unless the caller named it as the CLI's
3		- * own (CORE_EVENT_PREFIX): the plugin-event convention. The calling
4		- * built-in's own name is already in the event it passes.
	3	+ * own (CORE_EVENT_PREFIX): the plugin-event convention.
	4	+ *
	5	+ * The calling built-in's own name is already in the event it passes.
5	6	*/
6	7	export const EVENT_PREFIX = 'tengu_plugin_'

		@@ -13,11 +13,9 @@
13	13	* Sends one event, `tengu_plugin_<event>`, as one first-party row;
14	14	* resolves once the ingest accepted it.
15	15	*
16		- * The noun cannot see its caller, so the calling built-in names itself in
17		- * `event` and this adds the prefix; an event already named `tengu_…`, a
18		- * built-in port's own row, is sent under that name. A value is a finite
19		- * number, a boolean or a Choice; free text is refused. One input, as every
20		- * op on `$` takes.
	16	+ * The calling built-in names itself in `event`; one already named `tengu_…`
	17	+ * is sent as named. A value is a finite number, a boolean or a Choice; free
	18	+ * text is refused. One input, as every op on `$` takes.
21	19	*
22	20	* @param entry the event's name, a snake_case token, and its properties by
23	21	* snake_case key