docs(runicnpc): stage 4 built and walked; protocol 13 §19.12; API 3 #307

wtclaude · 2026-09-30T13:47:03Z

wtclaude commented

2026-09-30 13:47:03 +00:00

What

These are the docs for RunicNPC stage 4, as built and walked. Merge docs#306 (D249–D252) first, because this PR cites them.

rust-link/PROTOCOL.md §19.12: RunicNPC over the bridge.
- integrations.runicNpc.
- The four npc.* commands and their refusals.
- The frames npc.died, npc.health and npc.placement.changed.
- world.place with a profile, attackerNpc/attackerProfile, and npcProfileKills.
- The sidecar routes and overlay.toml's runicnpc_api.
runicnpc/API.md: API 3, which adds RunicNpc_AddPlacement, RenamePlacement, RespawnPlacement and OnRunicNpcPlacementChanged.
runicnpc/PLAN.md stage 4, as built:
- The five PRs.
- The walk on both rigs, row by row.
- What was not walked: the killfeed name and a player's own kills, which need a real player, and the installer and egg, which need releases.
- What building it found: a phase gate cannot name its run, so byEvent/runId; the feed lowercasing an NPC's name; and two rig notes.
rust-link/INSTALL.md: RunicNPC as the bundle's third file, installed by hand, by the egg, in doctor and on uninstall.

The PRs this documents

runicnpc-rust feat/stage-4-api3 → edge
Rust-Plugins, Rust-Link and Module-Rust feat/runicnpc-stage4 → edge
installer feat/runicnpc-stage4 → main

Checklist

AI-assisted: written with Claude Code (Claude Opus 5.5); the commit carries the trailer.

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

## What These are the docs for RunicNPC stage 4, as built and walked. **Merge docs#306 (D249–D252) first**, because this PR cites them. - **`rust-link/PROTOCOL.md` §19.12**: RunicNPC over the bridge. - `integrations.runicNpc`. - The four `npc.*` commands and their refusals. - The frames `npc.died`, `npc.health` and `npc.placement.changed`. - `world.place` with a `profile`, `attackerNpc`/`attackerProfile`, and `npcProfileKills`. - The sidecar routes and `overlay.toml`'s `runicnpc_api`. - **`runicnpc/API.md`**: API 3, which adds `RunicNpc_AddPlacement`, `RenamePlacement`, `RespawnPlacement` and `OnRunicNpcPlacementChanged`. - **`runicnpc/PLAN.md` stage 4, as built**: - The five PRs. - The walk on both rigs, row by row. - What was not walked: the killfeed name and a player's own kills, which need a real player, and the installer and egg, which need releases. - What building it found: a phase gate cannot name its run, so `byEvent`/`runId`; the feed lowercasing an NPC's name; and two rig notes. - **`rust-link/INSTALL.md`**: RunicNPC as the bundle's third file, installed by hand, by the egg, in `doctor` and on `uninstall`. ## The PRs this documents - runicnpc-rust `feat/stage-4-api3` → edge - Rust-Plugins, Rust-Link and Module-Rust `feat/runicnpc-stage4` → edge - installer `feat/runicnpc-stage4` → main ## Checklist - [x] AI-assisted: written with Claude Code (Claude Opus 5.5); the commit carries the trailer. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude added 1 commit 2026-09-30 13:47:06 +00:00

docs(runicnpc): stage 4 built and walked; protocol 13 §19.12; API 3 2ad2043060

PROTOCOL.md §19.12: RunicNPC over the bridge — integrations.runicNpc, the
npc.profiles, npc.profiles.set, npc.placements and npc.placement commands and
their refusals, the npc.died, npc.health and npc.placement.changed frames,
world.place with a profile, attackerNpc and attackerProfile, the tally's
npcProfileKills, the four sidecar routes, and overlay.toml's runicnpc_api.

API.md: API 3 — RunicNpc_AddPlacement, RunicNpc_RenamePlacement,
RunicNpc_RespawnPlacement and OnRunicNpcPlacementChanged.

PLAN.md stage 4: what was built in five repositories, the walk on both rigs
row by row, what was not walked and why, and what building it found.

rust-link/INSTALL.md: RunicNPC as the bundle's third file, by hand, the egg,
doctor and uninstall.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

whitlocktech merged commit 337451f9f7 into main

2026-09-30 19:51:38 +00:00

whitlocktech deleted branch docs/runicnpc-stage4-built

2026-09-30 19:51:39 +00:00

whitlocktech referenced this issue from a commit

2026-09-30 19:51:40 +00:00

Merge pull request 'docs(runicnpc): stage 4 built and walked; protocol 13 §19.12; API 3' (#307) from docs/runicnpc-stage4-built into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/docs#307