runcc-buddy

runcc-buddy is a standalone npm package extracted from the hidden BUDDY feature inside the RunCc codebase.

It does two things:

• packages the buddy core that is actually present and source-verifiable
• preserves an audit trail of what works, what is hidden, and what is still missing in the open-source tree

Conclusion first

The default external RunCc build cannot use buddy.

The verified usable form is:

• source version: 2.1.888
• source commit: b1c6249
• variant build: feature-buddy or suite-ui-hidden

What "usable" means here:

• BUDDY flag is on
• teaser/live dates work
• /buddy trigger detection works
• deterministic companion generation works
• sprite rendering works
• companion intro prompt attachment works

What is still missing in the open-source tree:

• the real /buddy command implementation
• the companion hatching/writing path
• the internal fireCompanionObserver(...) implementation
• any open-source path that updates companionPetAt

So this package intentionally exposes the verified buddy core, not a fake full clone of the missing internal implementation.

Node support

Tested with real tarball install and smoke runs on:

• Node 20.20.2
• Node 22.22.2
• Node 24.14.0

Package policy:

• supported runtime: Node >=20
• package format: ESM
• recommended local dev version: 24.14.0 via .nvmrc

If you use nvm:

nvm use

or install one of the validated versions:

nvm install 20
nvm install 22
nvm install 24

Install

cd /Users/rogn/Documents/code/buaa/VibeAnything/runcc-buddy
npm install
npm test

This package is not published to the npm registry yet. For a real consumer install, use the local tarball:

cd /Users/rogn/Documents/code/buaa/VibeAnything/runcc-buddy
npm pack
npm install ./runcc-buddy-0.1.0.tgz

npm pack now runs prepack, so the tarball always rebuilds dist first.

Use

import {
  createBuddyAuditReport,
  createCompanion,
  findBuddyTriggerPositions,
  renderSprite,
} from "runcc-buddy"

const report = createBuddyAuditReport()
const buddy = createCompanion("demo-user", {
  name: "Mochi",
  personality: "Dry wit, observant, likes short comments.",
  hatchedAt: Date.UTC(2026, 3, 1),
})

console.log(report.summary)
console.log(findBuddyTriggerPositions("hello /buddy world"))
console.log(renderSprite(buddy, 0))

CLI

./node_modules/.bin/runcc-buddy audit
./node_modules/.bin/runcc-buddy profile --user-id demo-user --name Mochi
./node_modules/.bin/runcc-buddy cases

Included modules

• companion: deterministic seed-based buddy generation and stored soul merge
• runtime: teaser/live window checks, /buddy trigger detection, intro attachment logic, layout reservation
• sprites: ASCII face and sprite rendering
• audit: source-backed report of verified features, hidden settings and missing pieces
• cases: typical multi-turn dialogue cases derived from the surviving prompt/UI logic

Hidden settings

See docs/hidden-settings.md.

Audit notes

See docs/source-audit.md.

Node validation

See docs/node-version-validation.md.

Typical cases

See docs/cases.md.