Pinky VV: newborn role doctrine + the first-class agent channel (v1.53.0) #81

Merged

ClaudiuSchuster merged 1 commit from oss-oo/pinky-vv-doctrine into main

2026-10-08 18:44:41 +00:00

ClaudiuSchuster commented

2026-10-08 18:43:43 +00:00

Owner

Round VV — steer #43 (owner-commissioned: "turns every future newborn from Honky-Donky into a natural") + steer #46 (the first-class agent channel).

D1 — the role briefs

Every genesis spawn (dialog AND API — the one staging path) attaches its role's compact ROLE BRIEF before the user's prompt text (doctrine first, mission second). One constant per role in one place (ROLE_BRIEFS, version-marker comment).
BRAIN brief: topology (owner = prime channel; pinkies talk only to the brain), bell protocol (systemd-run, END THE TURN, never wait in-turn), idling as CORRECT, the ordered doctrine list (AGENTS.md first, the skill, messenger pattern, validator pinkies, context-recycle gradient), the agent-channel pointer.
PINKY brief: the single-round worker essentials.
DOCTRINE: marker opts out (power users keep full control); injection is IDEEMPOTENT (the queue pump re-feeds staged files — guarded).

D2 — surfaces

Staged file = brief + verbatim text (byte layout unit-proven); a promptFile stages a briefed copy, the caller's file untouched.
Spawn record / queued entry / genesis status carry doctrine; the audit journal notes every injection; the review step shows one doctrine row; the status view hints 📜 doctrine attached.

Mission 3 — the agent channel (steer #46)

README §"For agents / inter-session steering": the steer endpoint shape, auto-detection, FIFO busy-queue semantics, the one-driver-per-cwd exit-3 cap, a runnable curl example.
GET /api/session/<sid>/info → {id, cwd, model, role, title} (read-only; honest 404).
Cross-note: recent zcode-dispatch versions auto-resolve on --resume — both doors documented.

Gates

G1 staging: byte-layout unit tests both roles + both prompt shapes, opt-out, API==dialog ✅
G2 behavioral: a REAL fake-HOME rig brain (real app-server) dispatched its pinky via systemd-run with the bell wired to itself, ENDED ITS TURN (the doorbell self-queued exit-3 — no in-turn waiting), and reported “done” when the bell woke it ✅
G3 pinky brief in transcript + AGENTS.md acknowledged (auto-injected system reminder), single round ✅
G4 README section + live-run curl against a fixture rig ✅
G5 suite 624 green (+25 new), Super-Linter station recipe green, CDP smoke 8/8 ✅

**Round VV** — steer #43 (owner-commissioned: "turns every future newborn from Honky-Donky into a natural") + steer #46 (the first-class agent channel). ## D1 — the role briefs - Every genesis spawn (dialog AND API — the one staging path) attaches its role's compact ROLE BRIEF **before** the user's prompt text (doctrine first, mission second). One constant per role in one place (`ROLE_BRIEFS`, version-marker comment). - BRAIN brief: topology (owner = prime channel; pinkies talk only to the brain), bell protocol (systemd-run, END THE TURN, never wait in-turn), idling as CORRECT, the ordered doctrine list (AGENTS.md first, the skill, messenger pattern, validator pinkies, context-recycle gradient), the agent-channel pointer. - PINKY brief: the single-round worker essentials. - `DOCTRINE:` marker opts out (power users keep full control); injection is IDEEMPOTENT (the queue pump re-feeds staged files — guarded). ## D2 — surfaces - Staged file = brief + verbatim text (byte layout unit-proven); a promptFile stages a briefed copy, the caller's file untouched. - Spawn record / queued entry / genesis status carry `doctrine`; the audit journal notes every injection; the review step shows one doctrine row; the status view hints 📜 doctrine attached. ## Mission 3 — the agent channel (steer #46) - README §"For agents / inter-session steering": the steer endpoint shape, auto-detection, FIFO busy-queue semantics, the one-driver-per-cwd exit-3 cap, a runnable curl example. - `GET /api/session/<sid>/info` → {id, cwd, model, role, title} (read-only; honest 404). - Cross-note: recent zcode-dispatch versions auto-resolve on --resume — both doors documented. ## Gates - **G1** staging: byte-layout unit tests both roles + both prompt shapes, opt-out, API==dialog ✅ - **G2** behavioral: a REAL fake-HOME rig brain (real app-server) dispatched its pinky via systemd-run with the bell wired to itself, ENDED ITS TURN (the doorbell self-queued exit-3 — no in-turn waiting), and reported “done” when the bell woke it ✅ - **G3** pinky brief in transcript + AGENTS.md acknowledged (auto-injected system reminder), single round ✅ - **G4** README section + live-run curl against a fixture rig ✅ - **G5** suite 624 green (+25 new), Super-Linter station recipe green, CDP smoke 8/8 ✅

ClaudiuSchuster added 1 commit

2026-10-08 18:43:43 +00:00

Pinky VV: newborn role doctrine + the first-class agent channel (v1.53.0)

Checks / Functional checks (pull_request) Successful in 34s

Details Explain this check

e06e2f2962

- genesis attaches each role's compact ROLE BRIEF before the user's
  prompt text (dialog AND API, one staging path; DOCTRINE: marker
  opts out; idempotent under the queue pump's re-feed)
- spawn record / queue entry / status carry the doctrine field; the
  audit journal notes every injection; the review step shows the
  doctrine row; the status view hints 'doctrine attached'
- GET /api/session/<sid>/info: {id, cwd, model, role, title} for the
  agent channel; README §'For agents / inter-session steering'
  documents the canonical steer endpoint, queue semantics, the cap
  and a curl example (the brain brief's pointer target)
- suite: +25 doctrine/agent-channel tests (624 green)

ClaudiuSchuster merged commit 6feb60f065 into main

2026-10-08 18:44:41 +00:00

ClaudiuSchuster deleted branch oss-oo/pinky-vv-doctrine

2026-10-08 18:44:41 +00:00

ClaudiuSchuster referenced this pull request from a commit

2026-10-08 18:44:41 +00:00

Pinky VV: newborn role doctrine + the first-class agent channel (v1.53.0) (#81)