[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75V4Y2KFXJ49C2AB9KXJ4YX":3,"skill-same:01M75V4Y2KFXJ49C2AB9KXJ4YX":120},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M75V4Y2KFXJ49C2AB9KXJ4YX","input",null,"Maps Puck input: channels, inputModes, sub-tick ingress, tap\u002Fhold\u002Fchords\u002Fsequences (inputPatterns), bindings and overlays, the always-active plane, devices, haptics. Grammar: puck-dsl.","ByteTerrace\u002FPuck","ByteTerrace","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F18753984?v=4","01M75V2WCB9PGGC3H7RZC7AXPS","01M75V2WD0NJPRNP5HJ75VZGD0",2,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: input\ndescription: \"Maps Puck input: channels, inputModes, sub-tick ingress, tap\u002Fhold\u002Fchords\u002Fsequences (inputPatterns), bindings and overlays, the always-active plane, devices, haptics. Grammar: puck-dsl.\"\n---\n\n# Input\n\nA map of how a physical press becomes authoritative semantic input and what\njudges it. Input has two layers, and most mistakes come from picking the wrong\none:\n\n- **The host's physical layer.** `Puck.Input` reads devices and window events;\n  `Puck.Commands`' `InputRouter` resolves each source through the composed\n  binding profile (pages, chords, toggles, wheels, activators) per seat. It is\n  presentation-side: it never decides a rule, and its gesture state is not\n  replayed authority.\n- **The authority's semantic layer.** `WorldInputRuntime` and one\n  `WorldInputOwner` per admitted seat or session hold modes, epochs, timed\n  event history and pattern matches. Rules read it; checkpoints, hashes and\n  replay carry it.\n\n[Input channels](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md) owns the model and\nits reasoning; [commands](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcommands.md) and\n[device input](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Finput.md) are the human references;\n[references\u002Fbindings.md](references\u002Fbindings.md) holds the binding composition\ncontracts. When this file and the code disagree, the code wins and this file\nis corrected in the same change.\n\n## Find the owner by what you need\n\n| You need | Owner | Read |\n|---|---|---|\n| Name an action and give it a shape (button, axis, relative look, text) | `channels` rows → `WorldChannel`, `WorldChannelTable`; `ChannelShape` (`PlayerIntent.cs`); motion `ChannelRole`; shared names in `worlds\u002Fstandard\u002Finputs.puck` | [semantic names](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#semantic-names-and-typed-values) |\n| Decide which actions are live while walking, flying, seated or engaged, and what survives a switch | `inputModes` → `WorldInputModes`, `WorldInputCatalog` (one `WorldInputMapping` per allowed tuple), `WorldInputSelector`, `WorldInputOwner.Switch`; the debug policy is `worlds\u002Fdebug\u002Finput-modes.puck` | [modes](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#modes-are-simulation-state), [switching](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#switching-releases-input) |\n| The time of a press inside a tick, several presses per tick, typed text | `WorldInputProducer` → `WorldInputBatch` → `WorldInputRuntime.TryAdmit` → `WorldInputOwner.TryAdmit`; `WorldInputInterval`; `inputHistory` (`WorldInputHistory`) | [sub-tick time](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#sub-tick-time-and-clocks) |\n| Tell a tap from a hold; a double tap, a fighting motion, a simultaneous press, a buffered attack, a rhythm note | `inputPatterns` (`WorldInputPattern`, compiled by `CompiledWorldInputPattern.Compile`), matched by `WorldInputOwner.TryMatch`, read by `inputMatch`, consumed by `consumeInput` | [below](#press-release-tap-hold-chords-sequences-and-rhythm) |\n| Map a key or button to an action or command; pages, chords, autorun toggles, wheels | `bindingOverlays` → `WorldBindingComposer.Compose` → `BindingProfile.Compile` → `PagedInputBindings` inside `InputRouter`, composed per seat by `WorldSeatBindings`; the standard's rows in `worlds\u002Fstandard\u002Fcontrols.puck` | [bindings.md](references\u002Fbindings.md), [commands: bindings](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcommands.md#bindings) |\n| A control no page or overlay can take (the console key, the pause menu) | `IAlwaysActiveInputBindings`, implemented by `TerminalInputBindings` (`Puck.Launcher`) | [below](#the-always-active-plane-and-reserved-gestures) |\n| Read a controller, keyboard or mouse; rumble, lights, adaptive triggers | `Puck.Input` (`GamepadManager`, `InputArbiter`, `GamepadCaptureSource`, `WindowInputMapper`, `InputSources`, `IGamepadOutput`); OS transports in `Puck.Platform.Windows` | [device input](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Finput.md) |\n| A machine's buttons while a seat is engaged | the route's kit `pad` map (`WorldKit`, `WorldPadElement`) | [engagement](..\u002Fpuck-world\u002Freferences\u002Fengagement.md) (`puck-world`) |\n\n## Semantic channels and typed values\n\n- A world declares each action once in `channels`; modules, bindings, kits,\n  rules, engagement maps and grants name it. The standard's shared vocabulary\n  is `worlds\u002Fstandard\u002Finputs.puck`; world-specific actions stay in the world\n  (the debug world's `suit.puck`, `noclip.puck`). Different meanings get\n  different names: chess uses the shared `confirm` and `cancel`, independently\n  of a machine's `select`. The engine\n  knows only the motion roles (`ChannelRole`), never a genre's vocabulary.\n- Each active input owner has 32 numeric slots (Q48.16 levels, or Q32.32\n  `Relative` displacement) and 64 packed buttons, budgeted per allowed mode\n  tuple; target registers have their own reach mask and spend none of it.\n  `Text` is event-only and takes no slot.\n- Resolve names through `WorldChannelTable` or the owner's published mapping. A\n  declaration index is not a storage address, and a slot may hold different\n  actions in different tuples. Read relative input with the table's checked\n  `ReadRelative`, never a held-level reader.\n- `Relative` input (mouse look) shares the numeric bank as Q32.32\n  displacement: the host accumulates samples and drains them once per routed\n  tick, rules read a Q48.16 projection whose fractional residue stays in\n  authority state, and it is never kept across a switch, toggled, or used by an\n  activator. Binding compilation must receive the routed channel shapes.\n\n- **A seat in one token is `seat\u003Cn>`** (1-based, case-insensitive, `seat1`..`seat4`), parsed once by\n  `PrincipalTokens.TryParseSeat`: principals and grantees, `world.hud seat\u003Cn>`, `audio.listener` and a scenario's\n  `seat1:` labels. A grant subject `seat:\u003Cn>` is a different grammar (a `kind:value` subject, zero-based); a\n  keyword argument (`screen.source ... seat \u003Cn>`) and a HUD binding path (`seat.\u003Cn>.position.x`) keep their own\n  shapes.\n\n## Modes and what survives a switch\n\n- A family's selector reads authoritative state only: `ActiveKit`,\n  `Engagement`, `BodyState` (a finite or range-partitioned register) or\n  `SeatState` (`WorldInputModeSelectorKind`). Never a binding page, the camera\n  layout or wall time. `player.mode` changes a `SeatState` family through\n  `WorldCommand.SelectInputState`.\n- The live set is the global names plus every selected, unsuspended state's\n  names. `suspendedBy` suppresses a family by another's selection;\n  `combinations` restricts the allowed tuples, checked on every transition.\n- **A switch releases by default.** A family's `transitions` row keeps named\n  actions (`conditionalKeep` adds tuple-conditioned ones); with several changed\n  families an action must be kept by every one, so an engagement row with an\n  empty keep wins. The barrier (`WorldInputOwner.Switch`) advances the epoch,\n  consumes the edge that caused it, and admits fresh input from the next tick;\n  a kept hold continues with no new press.\n- A binding page or `contexts` row changes which binding group a seat uses,\n  never simulation eligibility. Install the barrier with the firing's commit,\n  before another rule reads channels ([bindings.md](references\u002Fbindings.md)).\n\n## Timed ingress and sub-tick time\n\n- The host quantizes each device event once to a simulation interval and a\n  Q48.16 offset (`WorldInputInterval`) on the 50,400 Hz engine clock\n  (`FixedTickConversion`). No wall clock reaches simulation.\n- Producers send `Press`, `Release`, `AxisSample` and `Text` events; the\n  authority derives `AxisCrossing` from `inputHistory.crossings` (thresholds,\n  hysteresis, an optional `facingState`) and records `Cancel` for a reset hold\n  (`WorldInputEventKind`).\n- `inputHistory` sizes retention, ring capacity, events per step, lateness,\n  calibration and the judged clock (`Capture` or `Admission`). An overflowing\n  batch is refused whole and resets the owner into a new epoch; history is\n  never truncated. Size it for the rate and sample density\n  ([bindings.md](references\u002Fbindings.md)).\n- In a scenario, `seat1: player.signal \u003Csource> press at:\u003Cseconds>` places a\n  press at a sub-tick offset; `keyboard.text` commits text as ordered Unicode\n  scalar events.\n\n## Press, release, tap, hold, chords, sequences and rhythm\n\nPick the layer by who must agree on the answer:\n\n| You want | Use | Not |\n|---|---|---|\n| A gesture the simulation judges, replays and consumes once: tap versus hold, double tap, a motion, a buffered attack, a note | an `inputPatterns` row, read with `inputMatch(owner, pattern)` and claimed with `consumeInput` | a binding activator, a chord row or `BindingChordTracker` held state, which are host-only and not authority |\n| The newest edge of an action, its time or its age | `inputEdge`, `inputTime`, `inputAge(owner, name, kind, occurrence)` | comparing two tick images, which loses a press and release inside one tick |\n| How long the current hold has lasted, including across a kept switch | `inputHeldSince`, `inputHeldPress`, guarded by a current held level | |\n| A page or command while modifiers are held (trigger pages) | chord rows: `held` is a set, `chord` an ordered sequence ([bindings.md](references\u002Fbindings.md)) | |\n| A host-side tap code that fires a command | `BindingActivatorDefinition` with `Mode: Tapped` and `TimeoutTicks` (engine ticks), tracked by `RowActivatorTracker` | |\n| An action latched on (autorun, autofly) | a `mode: Toggle` entry or chord row on the channel | a new command or state register |\n\nThe pattern contract (`WorldInputPattern.cs`, `WorldInputOwner.Patterns.cs`):\n\n- A row has ordered `steps` (a channel, an event kind, an optional raw value,\n  crossing or `simultaneousGroup`, tolerance and tick gaps),\n  `maximumDurationSeconds`, `maximumGapSeconds`, optional `bufferTicks`,\n  `held` (binary actions that must be down now) and `consumptionGroup`.\n  `Compile` refuses more than 64 rows, a row outside 1 to 16 steps, a duration\n  beyond retention, a kind that disagrees with the channel's shape, and\n  overlapping or non-contiguous simultaneous predicates.\n- Matching reads only the current epoch, picks the earliest-ending match, then\n  the latest start, then the lowest event ids. Within one consumption group an\n  earlier row has priority: its match removes those events from later rows'\n  candidates. A read never consumes; `consumeInput` claims the range only when\n  the firing commits (the arm in `WorldRuleHost.Arms.cs` preflights\n  `TryMatch`), and a refused firing claims nothing. Claims and cursors are in\n  the checkpoint and hash.\n- `worlds\u002Fdebug\u002Finput-pattern-tests.puck` is the worked example: a crossing\n  motion consumed by a rule, and a `bufferTicks` attack whose rule adds an\n  `inputAge` guard.\n- **Tap versus hold.** The tap is a pattern of a press then a release within a\n  window shorter than the hold; the hold and the tap share one\n  `consumptionGroup` so one press cannot be both. The pause menu's Menu button\n  is specified this way ([hub plan](..\u002F..\u002F..\u002Fdocs\u002Fplans\u002Fhub-and-saves.md#11-menu-routing)).\n  A pattern step matches events only, so no step means \"still held after N\n  seconds\": today the duration goes in the rule (a press pattern whose `held`\n  names the action, plus an `inputAge` guard like the buffered example's), not\n  in the pattern's data. That composition is an inference from the matcher's\n  code, not a run scenario.\n\n## Bindings and overlays\n\n- Layers compose base first: the engine's build layer\n  (`WorldEditorBindings.Layer`), each world `bindingOverlays` row in order\n  (a `when` gate that fails skips it), the seat profile's `bindings`, then\n  live rebinds. `BindingProfile.Compile` is the one compiler; never copy it.\n- An overlay replaces only the pages it declares; everything else stays the\n  player's ([the owner's ruling](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#an-overlay-replaces-only-what-it-declares)).\n- Concrete designs (bar layouts, wheels, trigger pages, keys) are standard\n  data: `worlds\u002Fstandard\u002Fcontrols.puck` (`bare`, `play-wheel`, `pad-pages`),\n  `pad-kit.puck`'s modifiers; the debug world refines them in\n  `worlds\u002Fdebug\u002Fcontrols.puck`. None belongs in engine code.\n- `BindingVocabularyCheck.Validate` and `puck compile --validate` refuse an\n  unknown source, an unknown or unbindable command and a mismatched value kind.\n- Live surface: `player.bind`, `player.bindings` (leads with the group\n  derivation), `player.signal`, `world.affordances`, `body.rig`,\n  `body.channels`, `world.binding-bar`. `player.signal` drives the same binding\n  path a device does, headless included.\n- The router delivers every edge it synthesizes (an impulse's inactive twin, a\n  cancellation from focus loss, reload or a map change) on the next tick\n  ([commands](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcommands.md#quick-start)).\n\n## The always-active plane and reserved gestures\n\n- `InputRouter` resolves `IAlwaysActiveInputBindings` beside the active page\n  for every source. Today `TerminalInputBindings.Resolve` answers only\n  `keyboard.backtick` (the `console` command). While the console holds\n  terminal focus, signals enter through `InputRouter.CaptureFocusExempt`: only\n  commands declaring `CommandInputScope.FocusExempt` dispatch and only the\n  plane answers presses.\n- Host-reserved gestures outside the binding profile: Control+Alt+Escape\n  returns keyboard focus from a passthrough source (`SourceFocus`), and Escape\n  closes an open console (`ConsoleInputSink`).\n- Ruled but not yet built: the pad's Menu (`gamepad.start`) and Escape always\n  reach the pause menu, and no binding may name them\n  ([play decisions](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Fplay.md#the-game)). Nothing\n  enforces it yet: `BindingProfile.Compile` refuses neither source, no `menu`\n  verb exists, and the standard's `start` row binds `gamepad.start`. Hub plan\n  step H4 owns it.\n\n## Devices and haptics\n\n- Acquisition feeds `GamepadManager`; `InputArbiter` drains it once per host\n  frame; `GamepadCaptureSource` appends timestamped `InputSignal`s to the\n  router; `WindowInputMapper` maps keys, text and mouse. Source ids come from\n  `InputSources` and resolve case-insensitively (`InputSourceVocabulary`).\n- An agent's World passes `--devices none`: no pad opens and every OS event is\n  dropped before a seat (`WorldWindowInputFilters.ConsumesEveryEvent`), while\n  scripted input still drives it\n  ([the ruling](..\u002Fpuck-world\u002FSKILL.md#an-agents-world-opens-no-physical-device)).\n  Never inject real input to test.\n- Output goes through `IGamepadOutput` (capability-gated; rumble is finite by\n  contract). Protocol work consults several independent sources and cites each\n  (AGENTS.md); hardware evidence and owed runs are in\n  [device input](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Finput.md#limits-and-hardware-evidence).\n\n## Where each contract is enforced\n\n| Contract | Enforced by |\n|---|---|\n| Names, shapes and the 32\u002F64 budget per allowed tuple | `WorldInputCatalog` compilation and `WorldDefinitionValidator.Channels.cs`, `.Modes.cs` |\n| A selector reads only finite authoritative state | the closed `WorldInputModeSelectorKind` and `WorldInputSelector`'s partition proof |\n| A switch releases what no keep set names, and consumes its edge | `WorldInputOwner.Switch`, the one barrier door |\n| A stale-epoch or malformed batch is refused atomically | `WorldInputOwner.TryAdmit` |\n| A pattern is bounded and well-formed | `CompiledWorldInputPattern.Compile` |\n| Consumption happens only on a committed firing | the `consumeInput` arm in `WorldRuleHost.Arms.cs` |\n| A binding names known sources and bindable commands | `BindingVocabularyCheck` |\n| Same input, same state | history, holds and claims in `WorldInputOwner.Checkpoint.cs`; `puck test --reproduce` |\n| Menu and Escape are reserved | nothing yet (H4) |\n\n## Open gaps\n\n- **A hold completes with no closing event.** A pattern stage is satisfied\n  only by an event, so a hold of N seconds cannot be pattern data; a term\n  satisfied by time with the action still held (or a tick event closing the\n  stage) is the hub plan's H4 work.\n- **The matcher runs only in the authority.** `WorldInputOwner` lives in\n  `Puck.World.Server` and only `WorldRuleHost` calls `TryMatch`; the\n  always-active plane runs no matcher, so a remote authority decides every\n  pattern. H4 runs the one matcher on the plane over its local events.\n- **No world drives device output.** No `Puck.World*` code calls\n  `IGamepadOutput`, and a cartridge's `IFeedbackMachine.MotorLevel` has no\n  consumer. Keep both: an unreached capability is wired, not deleted.\n- The typing tutor and chat exhibits, the owed hardware runs and the decision's\n  raw-slot wording are in [the input packet](..\u002F..\u002F..\u002Fdocs\u002Fplans\u002Fopen-items.md#input-channels).\n\n## Verify\n\n- Scenarios: `puck test worlds\u002Fdebug\u002Finput-pattern-tests.puck --jobs 1` and\n  the other `worlds\u002Fdebug\u002Finput-*-tests.puck`; add `--reproduce` for a timing,\n  history or continuity change.\n- Genre sweeps: `puck sweep --plan worlds\u002Fdebug\u002F\u003Cplan>.sweep.json --world\n  \u003Csource>` with the five plans the\n  [genre check](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#genre-check) lists.\n- Unit suites: `tests\u002FPuck.World.Server.Tests\u002FInputPatternTests.cs`,\n  `tests\u002FPuck.Commands.Tests`, `tests\u002FPuck.Input.Tests`.\n- Look-alike: the document's `patterns` section (`CompiledPatterns`, the\n  `$match` operand, `world.match`) matches words over board cells, not input\n  history.\n\n## Route adjacent work\n\n| Skill | Route there for |\n|---|---|\n| `puck-world` | Running and verifying a World, engagement and kit `pad` maps, the seat camera's input feel (`seatCameraFeel`), rules and grants. |\n| `puck-dsl` | `.puck` grammar, `let`\u002F`for`, compile and lint verbs, PUCKnnn diagnostics. |\n| `gaming-bricks` | An emulated machine's own pad registers and input timing inside the core. |\n| `platform` | The OS side of a device: window messages, Raw Input, pointer lock, HID and Xbox transports, lamp arrays. |\n| `maths-usage` | Fixed-point types for offsets, calibration and judgement windows. |\n| `verification` | Leases, the private CLI copy, flaky versus failing scenarios. |\n","# Input\n\nA map of how a physical press becomes authoritative semantic input and what\njudges it. Input has two layers, and most mistakes come from picking the wrong\none:\n\n- **The host's physical layer.** `Puck.Input` reads devices and window events;\n  `Puck.Commands`' `InputRouter` resolves each source through the composed\n  binding profile (pages, chords, toggles, wheels, activators) per seat. It is\n  presentation-side: it never decides a rule, and its gesture state is not\n  replayed authority.\n- **The authority's semantic layer.** `WorldInputRuntime` and one\n  `WorldInputOwner` per admitted seat or session hold modes, epochs, timed\n  event history and pattern matches. Rules read it; checkpoints, hashes and\n  replay carry it.\n\n[Input channels](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md) owns the model and\nits reasoning; [commands](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcommands.md) and\n[device input](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Finput.md) are the human references;\n[references\u002Fbindings.md](references\u002Fbindings.md) holds the binding composition\ncontracts. When this file and the code disagree, the code wins and this file\nis corrected in the same change.\n\n## Find the owner by what you need\n\n| You need | Owner | Read |\n|---|---|---|\n| Name an action and give it a shape (button, axis, relative look, text) | `channels` rows → `WorldChannel`, `WorldChannelTable`; `ChannelShape` (`PlayerIntent.cs`); motion `ChannelRole`; shared names in `worlds\u002Fstandard\u002Finputs.puck` | [semantic names](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#semantic-names-and-typed-values) |\n| Decide which actions are live while walking, flying, seated or engaged, and what survives a switch | `inputModes` → `WorldInputModes`, `WorldInputCatalog` (one `WorldInputMapping` per allowed tuple), `WorldInputSelector`, `WorldInputOwner.Switch`; the debug policy is `worlds\u002Fdebug\u002Finput-modes.puck` | [modes](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#modes-are-simulation-state), [switching](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#switching-releases-input) |\n| The time of a press inside a tick, several presses per tick, typed text | `WorldInputProducer` → `WorldInputBatch` → `WorldInputRuntime.TryAdmit` → `WorldInputOwner.TryAdmit`; `WorldInputInterval`; `inputHistory` (`WorldInputHistory`) | [sub-tick time](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#sub-tick-time-and-clocks) |\n| Tell a tap from a hold; a double tap, a fighting motion, a simultaneous press, a buffered attack, a rhythm note | `inputPatterns` (`WorldInputPattern`, compiled by `CompiledWorldInputPattern.Compile`), matched by `WorldInputOwner.TryMatch`, read by `inputMatch`, consumed by `consumeInput` | [below](#press-release-tap-hold-chords-sequences-and-rhythm) |\n| Map a key or button to an action or command; pages, chords, autorun toggles, wheels | `bindingOverlays` → `WorldBindingComposer.Compose` → `BindingProfile.Compile` → `PagedInputBindings` inside `InputRouter`, composed per seat by `WorldSeatBindings`; the standard's rows in `worlds\u002Fstandard\u002Fcontrols.puck` | [bindings.md](references\u002Fbindings.md), [commands: bindings](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcommands.md#bindings) |\n| A control no page or overlay can take (the console key, the pause menu) | `IAlwaysActiveInputBindings`, implemented by `TerminalInputBindings` (`Puck.Launcher`) | [below](#the-always-active-plane-and-reserved-gestures) |\n| Read a controller, keyboard or mouse; rumble, lights, adaptive triggers | `Puck.Input` (`GamepadManager`, `InputArbiter`, `GamepadCaptureSource`, `WindowInputMapper`, `InputSources`, `IGamepadOutput`); OS transports in `Puck.Platform.Windows` | [device input](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Finput.md) |\n| A machine's buttons while a seat is engaged | the route's kit `pad` map (`WorldKit`, `WorldPadElement`) | [engagement](..\u002Fpuck-world\u002Freferences\u002Fengagement.md) (`puck-world`) |\n\n## Semantic channels and typed values\n\n- A world declares each action once in `channels`; modules, bindings, kits,\n  rules, engagement maps and grants name it. The standard's shared vocabulary\n  is `worlds\u002Fstandard\u002Finputs.puck`; world-specific actions stay in the world\n  (the debug world's `suit.puck`, `noclip.puck`). Different meanings get\n  different names: chess uses the shared `confirm` and `cancel`, independently\n  of a machine's `select`. The engine\n  knows only the motion roles (`ChannelRole`), never a genre's vocabulary.\n- Each active input owner has 32 numeric slots (Q48.16 levels, or Q32.32\n  `Relative` displacement) and 64 packed buttons, budgeted per allowed mode\n  tuple; target registers have their own reach mask and spend none of it.\n  `Text` is event-only and takes no slot.\n- Resolve names through `WorldChannelTable` or the owner's published mapping. A\n  declaration index is not a storage address, and a slot may hold different\n  actions in different tuples. Read relative input with the table's checked\n  `ReadRelative`, never a held-level reader.\n- `Relative` input (mouse look) shares the numeric bank as Q32.32\n  displacement: the host accumulates samples and drains them once per routed\n  tick, rules read a Q48.16 projection whose fractional residue stays in\n  authority state, and it is never kept across a switch, toggled, or used by an\n  activator. Binding compilation must receive the routed channel shapes.\n\n- **A seat in one token is `seat\u003Cn>`** (1-based, case-insensitive, `seat1`..`seat4`), parsed once by\n  `PrincipalTokens.TryParseSeat`: principals and grantees, `world.hud seat\u003Cn>`, `audio.listener` and a scenario's\n  `seat1:` labels. A grant subject `seat:\u003Cn>` is a different grammar (a `kind:value` subject, zero-based); a\n  keyword argument (`screen.source ... seat \u003Cn>`) and a HUD binding path (`seat.\u003Cn>.position.x`) keep their own\n  shapes.\n\n## Modes and what survives a switch\n\n- A family's selector reads authoritative state only: `ActiveKit`,\n  `Engagement`, `BodyState` (a finite or range-partitioned register) or\n  `SeatState` (`WorldInputModeSelectorKind`). Never a binding page, the camera\n  layout or wall time. `player.mode` changes a `SeatState` family through\n  `WorldCommand.SelectInputState`.\n- The live set is the global names plus every selected, unsuspended state's\n  names. `suspendedBy` suppresses a family by another's selection;\n  `combinations` restricts the allowed tuples, checked on every transition.\n- **A switch releases by default.** A family's `transitions` row keeps named\n  actions (`conditionalKeep` adds tuple-conditioned ones); with several changed\n  families an action must be kept by every one, so an engagement row with an\n  empty keep wins. The barrier (`WorldInputOwner.Switch`) advances the epoch,\n  consumes the edge that caused it, and admits fresh input from the next tick;\n  a kept hold continues with no new press.\n- A binding page or `contexts` row changes which binding group a seat uses,\n  never simulation eligibility. Install the barrier with the firing's commit,\n  before another rule reads channels ([bindings.md](references\u002Fbindings.md)).\n\n## Timed ingress and sub-tick time\n\n- The host quantizes each device event once to a simulation interval and a\n  Q48.16 offset (`WorldInputInterval`) on the 50,400 Hz engine clock\n  (`FixedTickConversion`). No wall clock reaches simulation.\n- Producers send `Press`, `Release`, `AxisSample` and `Text` events; the\n  authority derives `AxisCrossing` from `inputHistory.crossings` (thresholds,\n  hysteresis, an optional `facingState`) and records `Cancel` for a reset hold\n  (`WorldInputEventKind`).\n- `inputHistory` sizes retention, ring capacity, events per step, lateness,\n  calibration and the judged clock (`Capture` or `Admission`). An overflowing\n  batch is refused whole and resets the owner into a new epoch; history is\n  never truncated. Size it for the rate and sample density\n  ([bindings.md](references\u002Fbindings.md)).\n- In a scenario, `seat1: player.signal \u003Csource> press at:\u003Cseconds>` places a\n  press at a sub-tick offset; `keyboard.text` commits text as ordered Unicode\n  scalar events.\n\n## Press, release, tap, hold, chords, sequences and rhythm\n\nPick the layer by who must agree on the answer:\n\n| You want | Use | Not |\n|---|---|---|\n| A gesture the simulation judges, replays and consumes once: tap versus hold, double tap, a motion, a buffered attack, a note | an `inputPatterns` row, read with `inputMatch(owner, pattern)` and claimed with `consumeInput` | a binding activator, a chord row or `BindingChordTracker` held state, which are host-only and not authority |\n| The newest edge of an action, its time or its age | `inputEdge`, `inputTime`, `inputAge(owner, name, kind, occurrence)` | comparing two tick images, which loses a press and release inside one tick |\n| How long the current hold has lasted, including across a kept switch | `inputHeldSince`, `inputHeldPress`, guarded by a current held level | |\n| A page or command while modifiers are held (trigger pages) | chord rows: `held` is a set, `chord` an ordered sequence ([bindings.md](references\u002Fbindings.md)) | |\n| A host-side tap code that fires a command | `BindingActivatorDefinition` with `Mode: Tapped` and `TimeoutTicks` (engine ticks), tracked by `RowActivatorTracker` | |\n| An action latched on (autorun, autofly) | a `mode: Toggle` entry or chord row on the channel | a new command or state register |\n\nThe pattern contract (`WorldInputPattern.cs`, `WorldInputOwner.Patterns.cs`):\n\n- A row has ordered `steps` (a channel, an event kind, an optional raw value,\n  crossing or `simultaneousGroup`, tolerance and tick gaps),\n  `maximumDurationSeconds`, `maximumGapSeconds`, optional `bufferTicks`,\n  `held` (binary actions that must be down now) and `consumptionGroup`.\n  `Compile` refuses more than 64 rows, a row outside 1 to 16 steps, a duration\n  beyond retention, a kind that disagrees with the channel's shape, and\n  overlapping or non-contiguous simultaneous predicates.\n- Matching reads only the current epoch, picks the earliest-ending match, then\n  the latest start, then the lowest event ids. Within one consumption group an\n  earlier row has priority: its match removes those events from later rows'\n  candidates. A read never consumes; `consumeInput` claims the range only when\n  the firing commits (the arm in `WorldRuleHost.Arms.cs` preflights\n  `TryMatch`), and a refused firing claims nothing. Claims and cursors are in\n  the checkpoint and hash.\n- `worlds\u002Fdebug\u002Finput-pattern-tests.puck` is the worked example: a crossing\n  motion consumed by a rule, and a `bufferTicks` attack whose rule adds an\n  `inputAge` guard.\n- **Tap versus hold.** The tap is a pattern of a press then a release within a\n  window shorter than the hold; the hold and the tap share one\n  `consumptionGroup` so one press cannot be both. The pause menu's Menu button\n  is specified this way ([hub plan](..\u002F..\u002F..\u002Fdocs\u002Fplans\u002Fhub-and-saves.md#11-menu-routing)).\n  A pattern step matches events only, so no step means \"still held after N\n  seconds\": today the duration goes in the rule (a press pattern whose `held`\n  names the action, plus an `inputAge` guard like the buffered example's), not\n  in the pattern's data. That composition is an inference from the matcher's\n  code, not a run scenario.\n\n## Bindings and overlays\n\n- Layers compose base first: the engine's build layer\n  (`WorldEditorBindings.Layer`), each world `bindingOverlays` row in order\n  (a `when` gate that fails skips it), the seat profile's `bindings`, then\n  live rebinds. `BindingProfile.Compile` is the one compiler; never copy it.\n- An overlay replaces only the pages it declares; everything else stays the\n  player's ([the owner's ruling](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#an-overlay-replaces-only-what-it-declares)).\n- Concrete designs (bar layouts, wheels, trigger pages, keys) are standard\n  data: `worlds\u002Fstandard\u002Fcontrols.puck` (`bare`, `play-wheel`, `pad-pages`),\n  `pad-kit.puck`'s modifiers; the debug world refines them in\n  `worlds\u002Fdebug\u002Fcontrols.puck`. None belongs in engine code.\n- `BindingVocabularyCheck.Validate` and `puck compile --validate` refuse an\n  unknown source, an unknown or unbindable command and a mismatched value kind.\n- Live surface: `player.bind`, `player.bindings` (leads with the group\n  derivation), `player.signal`, `world.affordances`, `body.rig`,\n  `body.channels`, `world.binding-bar`. `player.signal` drives the same binding\n  path a device does, headless included.\n- The router delivers every edge it synthesizes (an impulse's inactive twin, a\n  cancellation from focus loss, reload or a map change) on the next tick\n  ([commands](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcommands.md#quick-start)).\n\n## The always-active plane and reserved gestures\n\n- `InputRouter` resolves `IAlwaysActiveInputBindings` beside the active page\n  for every source. Today `TerminalInputBindings.Resolve` answers only\n  `keyboard.backtick` (the `console` command). While the console holds\n  terminal focus, signals enter through `InputRouter.CaptureFocusExempt`: only\n  commands declaring `CommandInputScope.FocusExempt` dispatch and only the\n  plane answers presses.\n- Host-reserved gestures outside the binding profile: Control+Alt+Escape\n  returns keyboard focus from a passthrough source (`SourceFocus`), and Escape\n  closes an open console (`ConsoleInputSink`).\n- Ruled but not yet built: the pad's Menu (`gamepad.start`) and Escape always\n  reach the pause menu, and no binding may name them\n  ([play decisions](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Fplay.md#the-game)). Nothing\n  enforces it yet: `BindingProfile.Compile` refuses neither source, no `menu`\n  verb exists, and the standard's `start` row binds `gamepad.start`. Hub plan\n  step H4 owns it.\n\n## Devices and haptics\n\n- Acquisition feeds `GamepadManager`; `InputArbiter` drains it once per host\n  frame; `GamepadCaptureSource` appends timestamped `InputSignal`s to the\n  router; `WindowInputMapper` maps keys, text and mouse. Source ids come from\n  `InputSources` and resolve case-insensitively (`InputSourceVocabulary`).\n- An agent's World passes `--devices none`: no pad opens and every OS event is\n  dropped before a seat (`WorldWindowInputFilters.ConsumesEveryEvent`), while\n  scripted input still drives it\n  ([the ruling](..\u002Fpuck-world\u002FSKILL.md#an-agents-world-opens-no-physical-device)).\n  Never inject real input to test.\n- Output goes through `IGamepadOutput` (capability-gated; rumble is finite by\n  contract). Protocol work consults several independent sources and cites each\n  (AGENTS.md); hardware evidence and owed runs are in\n  [device input](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Finput.md#limits-and-hardware-evidence).\n\n## Where each contract is enforced\n\n| Contract | Enforced by |\n|---|---|\n| Names, shapes and the 32\u002F64 budget per allowed tuple | `WorldInputCatalog` compilation and `WorldDefinitionValidator.Channels.cs`, `.Modes.cs` |\n| A selector reads only finite authoritative state | the closed `WorldInputModeSelectorKind` and `WorldInputSelector`'s partition proof |\n| A switch releases what no keep set names, and consumes its edge | `WorldInputOwner.Switch`, the one barrier door |\n| A stale-epoch or malformed batch is refused atomically | `WorldInputOwner.TryAdmit` |\n| A pattern is bounded and well-formed | `CompiledWorldInputPattern.Compile` |\n| Consumption happens only on a committed firing | the `consumeInput` arm in `WorldRuleHost.Arms.cs` |\n| A binding names known sources and bindable commands | `BindingVocabularyCheck` |\n| Same input, same state | history, holds and claims in `WorldInputOwner.Checkpoint.cs`; `puck test --reproduce` |\n| Menu and Escape are reserved | nothing yet (H4) |\n\n## Open gaps\n\n- **A hold completes with no closing event.** A pattern stage is satisfied\n  only by an event, so a hold of N seconds cannot be pattern data; a term\n  satisfied by time with the action still held (or a tick event closing the\n  stage) is the hub plan's H4 work.\n- **The matcher runs only in the authority.** `WorldInputOwner` lives in\n  `Puck.World.Server` and only `WorldRuleHost` calls `TryMatch`; the\n  always-active plane runs no matcher, so a remote authority decides every\n  pattern. H4 runs the one matcher on the plane over its local events.\n- **No world drives device output.** No `Puck.World*` code calls\n  `IGamepadOutput`, and a cartridge's `IFeedbackMachine.MotorLevel` has no\n  consumer. Keep both: an unreached capability is wired, not deleted.\n- The typing tutor and chat exhibits, the owed hardware runs and the decision's\n  raw-slot wording are in [the input packet](..\u002F..\u002F..\u002Fdocs\u002Fplans\u002Fopen-items.md#input-channels).\n\n## Verify\n\n- Scenarios: `puck test worlds\u002Fdebug\u002Finput-pattern-tests.puck --jobs 1` and\n  the other `worlds\u002Fdebug\u002Finput-*-tests.puck`; add `--reproduce` for a timing,\n  history or continuity change.\n- Genre sweeps: `puck sweep --plan worlds\u002Fdebug\u002F\u003Cplan>.sweep.json --world\n  \u003Csource>` with the five plans the\n  [genre check](..\u002F..\u002F..\u002Fdocs\u002Fdecisions\u002Finput-channels.md#genre-check) lists.\n- Unit suites: `tests\u002FPuck.World.Server.Tests\u002FInputPatternTests.cs`,\n  `tests\u002FPuck.Commands.Tests`, `tests\u002FPuck.Input.Tests`.\n- Look-alike: the document's `patterns` section (`CompiledPatterns`, the\n  `$match` operand, `world.match`) matches words over board cells, not input\n  history.\n\n## Route adjacent work\n\n| Skill | Route there for |\n|---|---|\n| `puck-world` | Running and verifying a World, engagement and kit `pad` maps, the seat camera's input feel (`seatCameraFeel`), rules and grants. |\n| `puck-dsl` | `.puck` grammar, `let`\u002F`for`, compile and lint verbs, PUCKnnn diagnostics. |\n| `gaming-bricks` | An emulated machine's own pad registers and input timing inside the core. |\n| `platform` | The OS side of a device: window messages, Raw Input, pointer lock, HID and Xbox transports, lamp arrays. |\n| `maths-usage` | Fixed-point types for offsets, calibration and judgement windows. |\n| `verification` | Leases, the private CLI copy, flaky versus failing scenarios. |\n",{"name":5,"description":7},"main","2ef814b84c9595144e052c6dcd300badb619ee2f",".claude\u002Fskills\u002Finput",0,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck","https:\u002F\u002Fgithub.com\u002FByteTerrace","https:\u002F\u002Fbyteterrace.com","2026-11-12 13:59:16",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add ByteTerrace\u002FPuck --skill input",{"tool":37,"command":38},"bunx","bunx skills add ByteTerrace\u002FPuck --skill input",{"tool":40,"command":41},"pnpm","pnpm dlx skills add ByteTerrace\u002FPuck --skill input","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002FSKILL.md",true,[45,51,55,59,63,67,71,75,79,83,87,90,94,98,102,106,109,112,116],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"evals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fnames-input-patterns.md","REFERENCE","参考文档",88,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fnames-input-patterns.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"evals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fnames-the-hold-gap.md",865,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fnames-the-hold-gap.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"evals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fno-second-hold-detector.md",825,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fno-second-hold-detector.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"evals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fone-consumption-group.md",93,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fone-consumption-group.md",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"evals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fskill-fired.md",36,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi01-tap-versus-hold\u002Fgraders\u002Fskill-fired.md",{"path":68,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":70},"evals\u002Fi01-tap-versus-hold\u002Fprompt.md",927,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi01-tap-versus-hold\u002Fprompt.md",{"path":72,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":73,"sourceHtmlUrl":74},"evals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fauthored-not-engine.md",812,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fauthored-not-engine.md",{"path":76,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":77,"sourceHtmlUrl":78},"evals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fkeep-on-a-transition.md",126,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fkeep-on-a-transition.md",{"path":80,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":81,"sourceHtmlUrl":82},"evals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fnames-input-modes.md",67,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fnames-input-modes.md",{"path":84,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":85,"sourceHtmlUrl":86},"evals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Freleases-by-default.md",744,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Freleases-by-default.md",{"path":88,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":89},"evals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fskill-fired.md","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi02-board-entry-releases-autorun\u002Fgraders\u002Fskill-fired.md",{"path":91,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":92,"sourceHtmlUrl":93},"evals\u002Fi02-board-entry-releases-autorun\u002Fprompt.md",842,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi02-board-entry-releases-autorun\u002Fprompt.md",{"path":95,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":96,"sourceHtmlUrl":97},"evals\u002Fi03-motion-input-layer\u002Fgraders\u002Factivator-is-host-layer.md",1014,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi03-motion-input-layer\u002Fgraders\u002Factivator-is-host-layer.md",{"path":99,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":100,"sourceHtmlUrl":101},"evals\u002Fi03-motion-input-layer\u002Fgraders\u002Faxis-crossings.md",96,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi03-motion-input-layer\u002Fgraders\u002Faxis-crossings.md",{"path":103,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":104,"sourceHtmlUrl":105},"evals\u002Fi03-motion-input-layer\u002Fgraders\u002Fmatch-and-consume.md",69,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi03-motion-input-layer\u002Fgraders\u002Fmatch-and-consume.md",{"path":107,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":108},"evals\u002Fi03-motion-input-layer\u002Fgraders\u002Fnames-input-patterns.md","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi03-motion-input-layer\u002Fgraders\u002Fnames-input-patterns.md",{"path":110,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":111},"evals\u002Fi03-motion-input-layer\u002Fgraders\u002Fskill-fired.md","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi03-motion-input-layer\u002Fgraders\u002Fskill-fired.md",{"path":113,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":114,"sourceHtmlUrl":115},"evals\u002Fi03-motion-input-layer\u002Fprompt.md",898,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Fevals\u002Fi03-motion-input-layer\u002Fprompt.md",{"path":117,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":118,"sourceHtmlUrl":119},"references\u002Fbindings.md",37579,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Finput\u002Freferences\u002Fbindings.md",[121,128,135,142,149,156],{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":18},"01M75V6X1GBYDMSMJC8VXXPFAP","verification","Verifies Puck changes: landing bar, builds, stale DLLs, flaky tests, GPU\u002Fheavy leases, coverage, source-scan or regex laws versus type\u002Fcompiler enforcement, and writing tests.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fverification\u002FSKILL.md",[],[],{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":18},"01M75V6TM3F9A7ZMA0Q43RVJSF","tooling","Maps shared build\u002FCLI architecture, compiler assembly identity, candidate installation, generated sections, and host admission.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling\u002FSKILL.md",[],[],{"skillNo":136,"name":137,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":141,"publishedAt":18},"01M75V6R4E6AY73X27MC6EE5X5","tooling-files","Maps shared repository tooling for files, paths, Git queries, project ownership and Markdown fences. Load before adding or changing a helper in these areas.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling-files\u002FSKILL.md",[],[],{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":148,"publishedAt":18},"01M75V6N2P9XWWPH7EHRKMBTEC","symbol-analysis","Answers C# structure questions with puck references and declarations: which types derive from, implement or override a symbol, who references it, safe to delete or rename. Text: content-search.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsymbol-analysis\u002FSKILL.md",[],[],{"skillNo":150,"name":151,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":155,"publishedAt":18},"01M75V6HRKM57BD8Q7A4N8QN0C","state","Maps Puck's state and rule engine (Puck.State, .Rules, .Search, .Topology, .Vectors, .Generators): arena, journal scopes, undo, hashing, rule compiler, faults, transforms, search, draws.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fstate\u002FSKILL.md",[],[],{"skillNo":157,"name":158,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":18},"01M75V6CE3X73KNZYFRT9A5W8F","sdf-authoring","Authors creations: shape rows, primitives, blends, folds, palettes, paints, render lanes, rigs, bake work and bytes, creation stats. Use to sculpt or fix a part. Grammar: puck-dsl; GPU: rendering.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsdf-authoring\u002FSKILL.md",[],[]]