@spinabot/brigade 0.1.2 → 1.0.1

package/dist/system-prompt/org/escalation-inbox.js

@@ -0,0 +1,71 @@
+/**
+ * Brigade virtual-office layer — top-of-org escalation inbox (Stage D).
+ *
+ * When the agent receiving the turn is the `topOrder` AND the session
+ * inbox has pending events tagged with `kind === "escalation"`, the
+ * assembler emits an additional `## Escalation Inbox` block listing
+ * each escalation by sender + role. This is purely an attention-shaping
+ * surface — the events themselves still flow through the existing
+ * formatted-events block (drained by `drainFormattedSessionEvents`), so
+ * the legacy code path is preserved bit-for-bit.
+ *
+ * STAGE-D CONTRACT
+ * ----------------
+ *   - Returns `undefined` when:
+ *       - `callerAgentId !== graph.topOrder` (this section only fires
+ *         for the top-of-org caller — non-top callers see only the
+ *         per-event receiver-hint blocks).
+ *       - No event in the batch carries `kind === "escalation"`.
+ *   - Block is at most `1 heading + 8 lines`. Older escalations beyond
+ *     the cap get a "+N more" tail — the receiver-hint section already
+ *     lists every event individually so the inbox is a summary view.
+ *
+ * No external agent-codebase identifiers
+ * are referenced from this file.
+ */
+import { decodeDeliveryKindContextKey, } from "../../agents/org/delivery-kind.js";
+/** Max escalations listed before the "+N more" tail kicks in. */
+export const ESCALATION_INBOX_LIST_CAP = 5;
+/**
+ * Render the `## Escalation Inbox` block. Returns `undefined` when the
+ * caller is NOT the top-of-org OR no event is tagged as an escalation.
+ */
+export function renderEscalationInbox(params) {
+    if (!params.graph)
+        return undefined;
+    if (params.callerAgentId !== params.graph.topOrder)
+        return undefined;
+    if (params.events.length === 0)
+        return undefined;
+    const escalations = [];
+    for (const event of params.events) {
+        const metadata = decodeDeliveryKindContextKey(event.contextKey);
+        if (!metadata)
+            continue;
+        if (metadata.kind !== "escalation")
+            continue;
+        escalations.push(metadata);
+    }
+    if (escalations.length === 0)
+        return undefined;
+    const lines = ["## Escalation Inbox"];
+    const shown = escalations.slice(0, ESCALATION_INBOX_LIST_CAP);
+    for (const metadata of shown) {
+        lines.push(renderOne(metadata));
+    }
+    const overflow = escalations.length - shown.length;
+    if (overflow > 0) {
+        lines.push(`(+${overflow} more escalation${overflow === 1 ? "" : "s"})`);
+    }
+    return lines.join("\n");
+}
+function renderOne(metadata) {
+    const sender = metadata.fromRole
+        ? `${metadata.fromRole} (${metadata.fromAgentId})`
+        : metadata.fromAgentId;
+    if (metadata.fromDepartment) {
+        return `- ${sender} from ${metadata.fromDepartment}`;
+    }
+    return `- ${sender}`;
+}
+//# sourceMappingURL=escalation-inbox.js.map

package/dist/system-prompt/org/escalation-inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-inbox.js","sourceRoot":"","sources":["../../../src/system-prompt/org/escalation-inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,4BAA4B,GAE7B,MAAM,mCAAmC,CAAC;AAI3C,iEAAiE;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAqB3C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC;IAEnC,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACrE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEjD,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,4BAA4B,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY;YAAE,SAAS;QAC7C,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,KAAK,GAAa,CAAC,qBAAqB,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAC9D,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACnD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,mBAAmB,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,QAA8B;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ;QAC9B,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,WAAW,GAAG;QAClD,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;IACzB,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC5B,OAAO,KAAK,MAAM,SAAS,QAAQ,CAAC,cAAc,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,MAAM,EAAE,CAAC;AACvB,CAAC"}

package/dist/system-prompt/org/receiver-hint.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Brigade virtual-office layer — receiver-side hint render (Stage D).
+ *
+ * When a session-inbox event lands carrying `brigade-org-kind:<kind>:…`
+ * metadata on its `contextKey`, the receiving turn gets a one-paragraph
+ * ephemeral block describing WHO sent the message and WHY framing
+ * (delegation / escalation / review). This is the receiver-side counterpart
+ * to the `delegate_to_department` tool (Stage D):
+ *
+ *   - The sender writes a kind-tagged event into the receiver's inbox.
+ *   - The receiver's turn peeks the inbox before draining, calls
+ *     `renderReceiverHint(event)` on each pending event, and appends the
+ *     returned string (when defined) to the per-turn ephemeral suffix.
+ *
+ * STAGE-D CONTRACT
+ * ----------------
+ *   - Returns `undefined` for any event whose contextKey does NOT decode
+ *     to a `DeliveryKindMetadata`. Legacy events (no kind tag) pass
+ *     through unchanged — the agent loop's existing `combinedPrefix`
+ *     wiring is the only thing that renders them, and the new
+ *     additive-gate adds nothing on top.
+ *   - Block is one heading + 1-3 lines, NEVER more. The receiver-side
+ *     budget mirrors the sender-side org block's discipline (≤15 lines
+ *     for the static org section) — these run BELOW the cache boundary
+ *     so they're cheap, but bloating the model with redundant context
+ *     is still a regression.
+ *
+ * No external agent-codebase identifiers
+ * are referenced from this file.
+ */
+import { type DeliveryKindMetadata } from "../../agents/org/delivery-kind.js";
+import type { SystemEvent } from "../../agents/session-inbox.js";
+/**
+ * Shape of the inbound event the renderer needs. Accepts a subset of
+ * `SystemEvent` so callers can pass either the full event or a stub
+ * carrying just `text + contextKey`.
+ */
+export interface ReceiverHintEventLike {
+    text?: string;
+    contextKey?: string | null | undefined;
+}
+/**
+ * Render a per-event ephemeral hint. Returns `undefined` when the event
+ * is not kind-tagged (legacy or non-org event) so the caller can simply
+ * skip it without additional conditional handling.
+ *
+ * The output is a single multi-line string:
+ *
+ *   ## New work from <sender.department>
+ *   <Role-or-id> sent you this as <kind framing>.
+ *
+ * The optional `text` field is NOT echoed here — the formatted system-
+ * event block (drained by `drainFormattedSessionEvents`) already carries
+ * the message body. The hint exists only to FRAME that body so the model
+ * picks the right verb on its reply.
+ */
+export declare function renderReceiverHint(event: ReceiverHintEventLike): string | undefined;
+/**
+ * Internal: render directly from already-decoded metadata. Exposed
+ * separately for unit tests that prefer to construct the metadata
+ * inline rather than build a full event.
+ */
+export declare function renderReceiverHintFromMetadata(metadata: DeliveryKindMetadata): string;
+/**
+ * Convenience: drain-format the receiver hints for a list of events.
+ * Returns `undefined` when no event in the batch carries kind metadata,
+ * so the caller can omit the section entirely instead of emitting an
+ * empty block.
+ */
+export declare function renderReceiverHints(events: readonly ReceiverHintEventLike[]): string | undefined;
+export type { SystemEvent };
+//# sourceMappingURL=receiver-hint.d.ts.map

package/dist/system-prompt/org/receiver-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiver-hint.d.ts","sourceRoot":"","sources":["../../../src/system-prompt/org/receiver-hint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACxC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,GAC3B,MAAM,GAAG,SAAS,CAIpB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAER;AA0CD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,qBAAqB,EAAE,GACvC,MAAM,GAAG,SAAS,CASpB;AAID,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/system-prompt/org/receiver-hint.js

@@ -0,0 +1,116 @@
+/**
+ * Brigade virtual-office layer — receiver-side hint render (Stage D).
+ *
+ * When a session-inbox event lands carrying `brigade-org-kind:<kind>:…`
+ * metadata on its `contextKey`, the receiving turn gets a one-paragraph
+ * ephemeral block describing WHO sent the message and WHY framing
+ * (delegation / escalation / review). This is the receiver-side counterpart
+ * to the `delegate_to_department` tool (Stage D):
+ *
+ *   - The sender writes a kind-tagged event into the receiver's inbox.
+ *   - The receiver's turn peeks the inbox before draining, calls
+ *     `renderReceiverHint(event)` on each pending event, and appends the
+ *     returned string (when defined) to the per-turn ephemeral suffix.
+ *
+ * STAGE-D CONTRACT
+ * ----------------
+ *   - Returns `undefined` for any event whose contextKey does NOT decode
+ *     to a `DeliveryKindMetadata`. Legacy events (no kind tag) pass
+ *     through unchanged — the agent loop's existing `combinedPrefix`
+ *     wiring is the only thing that renders them, and the new
+ *     additive-gate adds nothing on top.
+ *   - Block is one heading + 1-3 lines, NEVER more. The receiver-side
+ *     budget mirrors the sender-side org block's discipline (≤15 lines
+ *     for the static org section) — these run BELOW the cache boundary
+ *     so they're cheap, but bloating the model with redundant context
+ *     is still a regression.
+ *
+ * No external agent-codebase identifiers
+ * are referenced from this file.
+ */
+import { decodeDeliveryKindContextKey, } from "../../agents/org/delivery-kind.js";
+/**
+ * Render a per-event ephemeral hint. Returns `undefined` when the event
+ * is not kind-tagged (legacy or non-org event) so the caller can simply
+ * skip it without additional conditional handling.
+ *
+ * The output is a single multi-line string:
+ *
+ *   ## New work from <sender.department>
+ *   <Role-or-id> sent you this as <kind framing>.
+ *
+ * The optional `text` field is NOT echoed here — the formatted system-
+ * event block (drained by `drainFormattedSessionEvents`) already carries
+ * the message body. The hint exists only to FRAME that body so the model
+ * picks the right verb on its reply.
+ */
+export function renderReceiverHint(event) {
+    const metadata = decodeDeliveryKindContextKey(event.contextKey);
+    if (!metadata)
+        return undefined;
+    return renderHintFromMetadata(metadata);
+}
+/**
+ * Internal: render directly from already-decoded metadata. Exposed
+ * separately for unit tests that prefer to construct the metadata
+ * inline rather than build a full event.
+ */
+export function renderReceiverHintFromMetadata(metadata) {
+    return renderHintFromMetadata(metadata);
+}
+function renderHintFromMetadata(metadata) {
+    const heading = buildHeading(metadata);
+    const body = buildBody(metadata);
+    return [heading, body].filter((line) => line.length > 0).join("\n");
+}
+function buildHeading(metadata) {
+    if (metadata.fromDepartment) {
+        return `## New work from ${metadata.fromDepartment}`;
+    }
+    return `## New work from ${metadata.fromAgentId}`;
+}
+function buildBody(metadata) {
+    const sender = metadata.fromRole
+        ? `${metadata.fromRole} (${metadata.fromAgentId})`
+        : metadata.fromAgentId;
+    return `${sender} sent you this as a ${framingFor(metadata.kind)}.`;
+}
+/**
+ * Map the kind to a human-readable framing the model can act on. Stable
+ * strings — tests pin them so prompt drift is caught.
+ */
+function framingFor(kind) {
+    switch (kind) {
+        case "delegation":
+            return "delegation (please own the work)";
+        case "escalation":
+            return "escalation (a downstream member needs your call)";
+        case "review":
+            return "review request (feedback only — do not execute)";
+        default:
+            // Defensive: future kinds fall through to a neutral framing rather
+            // than throwing. The `DeliveryKind` union is closed today so this
+            // branch is unreachable, but keeping it stable is cheap.
+            return "message";
+    }
+}
+/**
+ * Convenience: drain-format the receiver hints for a list of events.
+ * Returns `undefined` when no event in the batch carries kind metadata,
+ * so the caller can omit the section entirely instead of emitting an
+ * empty block.
+ */
+export function renderReceiverHints(events) {
+    if (events.length === 0)
+        return undefined;
+    const blocks = [];
+    for (const event of events) {
+        const block = renderReceiverHint(event);
+        if (block)
+            blocks.push(block);
+    }
+    if (blocks.length === 0)
+        return undefined;
+    return blocks.join("\n\n");
+}
+//# sourceMappingURL=receiver-hint.js.map

package/dist/system-prompt/org/receiver-hint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiver-hint.js","sourceRoot":"","sources":["../../../src/system-prompt/org/receiver-hint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EACL,4BAA4B,GAG7B,MAAM,mCAAmC,CAAC;AAa3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA4B;IAE5B,MAAM,QAAQ,GAAG,4BAA4B,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAA8B;IAE9B,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,sBAAsB,CAAC,QAA8B;IAC5D,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,QAA8B;IAClD,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC5B,OAAO,oBAAoB,QAAQ,CAAC,cAAc,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,oBAAoB,QAAQ,CAAC,WAAW,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,SAAS,CAAC,QAA8B;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ;QAC9B,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,WAAW,GAAG;QAClD,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;IACzB,OAAO,GAAG,MAAM,uBAAuB,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,IAAkB;IACpC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,kCAAkC,CAAC;QAC5C,KAAK,YAAY;YACf,OAAO,kDAAkD,CAAC;QAC5D,KAAK,QAAQ;YACX,OAAO,iDAAiD,CAAC;QAC3D;YACE,mEAAmE;YACnE,kEAAkE;YAClE,yDAAyD;YACzD,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAwC;IAExC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/system-prompt/org/render-org-block.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Brigade virtual-office layer — single-line org anchor.
+ *
+ * `renderOrgBlock(graph, callerAgentId, opts)` produces ONE line of
+ * prompt text that gets injected into the assembled system prompt
+ * when `cfg.org` is present (i.e. when `deriveOrgGraph(cfg)` returns a
+ * defined graph).
+ *
+ * ANCHOR CONTRACT
+ * ---------------
+ *   - When `graph === undefined`, this helper returns `undefined`. The
+ *     assembler treats that as "do not emit a block" — so a vanilla
+ *     install (no `cfg.org`) gets ZERO new bytes in the assembled prompt.
+ *     This is the load-bearing invariant for the additive-conditional
+ *     constraint: existing behaviour is preserved bit-for-bit.
+ *   - When `graph` is defined but `callerAgentId` isn't a known member
+ *     of the graph (e.g. an ad-hoc agent that wasn't given a
+ *     `cfg.agents.<id>.org` block in a multi-agent install), we again
+ *     return `undefined` rather than emitting a half-rendered block.
+ *     The model gets the legacy "no org context" shape for that turn.
+ *   - The render is EXACTLY ONE line — no embedded newlines. The model
+ *     gets a terse pointer to the new consolidated `org` tool for the
+ *     full peer / reachability picture; the prompt itself stays lean.
+ *
+ * NO external agent-codebase IDENTIFIERS.
+ * All literal text in this module is fully Brigade-native.
+ */
+import type { OrgGraph } from "../../agents/org/types.js";
+export interface RenderOrgBlockOpts {
+    /** Reserved for forward-compat. Currently unused — the single-line
+     *  anchor has no toggles. Kept on the signature so callers passing
+     *  `opts` continue to compile across the consolidation. */
+    readonly compact?: boolean;
+}
+/**
+ * Render the per-agent single-line org anchor. Returns `undefined`
+ * when no anchor should be emitted (legacy mode OR caller agent not in
+ * the org). The string return shape is the EXACT line content — no
+ * trailing newline; the assembler appends its own blank-line padding.
+ */
+export declare function renderOrgBlock(graph: OrgGraph | undefined, callerAgentId: string, _opts?: RenderOrgBlockOpts): string | undefined;
+//# sourceMappingURL=render-org-block.d.ts.map

package/dist/system-prompt/org/render-org-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-org-block.d.ts","sourceRoot":"","sources":["../../../src/system-prompt/org/render-org-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC;;+DAE2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,kBAAuB,GAC7B,MAAM,GAAG,SAAS,CAwBpB"}

package/dist/system-prompt/org/render-org-block.js

@@ -0,0 +1,57 @@
+/**
+ * Brigade virtual-office layer — single-line org anchor.
+ *
+ * `renderOrgBlock(graph, callerAgentId, opts)` produces ONE line of
+ * prompt text that gets injected into the assembled system prompt
+ * when `cfg.org` is present (i.e. when `deriveOrgGraph(cfg)` returns a
+ * defined graph).
+ *
+ * ANCHOR CONTRACT
+ * ---------------
+ *   - When `graph === undefined`, this helper returns `undefined`. The
+ *     assembler treats that as "do not emit a block" — so a vanilla
+ *     install (no `cfg.org`) gets ZERO new bytes in the assembled prompt.
+ *     This is the load-bearing invariant for the additive-conditional
+ *     constraint: existing behaviour is preserved bit-for-bit.
+ *   - When `graph` is defined but `callerAgentId` isn't a known member
+ *     of the graph (e.g. an ad-hoc agent that wasn't given a
+ *     `cfg.agents.<id>.org` block in a multi-agent install), we again
+ *     return `undefined` rather than emitting a half-rendered block.
+ *     The model gets the legacy "no org context" shape for that turn.
+ *   - The render is EXACTLY ONE line — no embedded newlines. The model
+ *     gets a terse pointer to the new consolidated `org` tool for the
+ *     full peer / reachability picture; the prompt itself stays lean.
+ *
+ * NO external agent-codebase IDENTIFIERS.
+ * All literal text in this module is fully Brigade-native.
+ */
+/**
+ * Render the per-agent single-line org anchor. Returns `undefined`
+ * when no anchor should be emitted (legacy mode OR caller agent not in
+ * the org). The string return shape is the EXACT line content — no
+ * trailing newline; the assembler appends its own blank-line padding.
+ */
+export function renderOrgBlock(graph, callerAgentId, _opts = {}) {
+    if (!graph)
+        return undefined;
+    const caller = graph.members[callerAgentId];
+    if (!caller)
+        return undefined;
+    void _opts;
+    const role = caller.role && caller.role.trim().length > 0 ? caller.role.trim() : null;
+    // Top-of-org gets a distinct anchor (no "reports to X" clause).
+    if (callerAgentId === graph.topOrder) {
+        const head = role
+            ? `Org: you are ${callerAgentId}, ${role}, top-of-org.`
+            : `Org: you are ${callerAgentId}, top-of-org.`;
+        return `${head} Call org({action:"describe"}) for direct reports + departments.`;
+    }
+    // Non-top callers: phrase as "you are <id>, <role> in <department>, reports to <Y>".
+    const dept = caller.department;
+    const manager = caller.reportsTo ?? graph.topOrder;
+    const head = role
+        ? `Org: you are ${callerAgentId}, ${role} in ${dept}, reports to ${manager}.`
+        : `Org: you are ${callerAgentId} in ${dept}, reports to ${manager}.`;
+    return `${head} Call org({action:"describe"}) for peers + reachability.`;
+}
+//# sourceMappingURL=render-org-block.js.map

package/dist/system-prompt/org/render-org-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-org-block.js","sourceRoot":"","sources":["../../../src/system-prompt/org/render-org-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAWH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA2B,EAC3B,aAAqB,EACrB,QAA4B,EAAE;IAE9B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,KAAK,KAAK,CAAC;IAEX,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3E,gEAAgE;IAChE,IAAI,aAAa,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI;YACf,CAAC,CAAC,gBAAgB,aAAa,KAAK,IAAI,eAAe;YACvD,CAAC,CAAC,gBAAgB,aAAa,eAAe,CAAC;QACjD,OAAO,GAAG,IAAI,kEAAkE,CAAC;IACnF,CAAC;IAED,qFAAqF;IACrF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI;QACf,CAAC,CAAC,gBAAgB,aAAa,KAAK,IAAI,OAAO,IAAI,gBAAgB,OAAO,GAAG;QAC7E,CAAC,CAAC,gBAAgB,aAAa,OAAO,IAAI,gBAAgB,OAAO,GAAG,CAAC;IACvE,OAAO,GAAG,IAAI,0DAA0D,CAAC;AAC3E,CAAC"}

package/dist/system-prompt/org/sub-agent-anchor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Brigade virtual-office layer — Stage B sub-agent anchor.
+ *
+ * The full `## Org` block (see `render-org-block.ts`) is operator-
+ * facing. Sub-agents inherit their spawner's department + a parent-
+ * report edge for the spawn's lifetime (derivation Rule vii), but
+ * they get a SHORTER context line that fits the minimal-mode prompt
+ * shape (banner + universal sections only — no operator directory).
+ *
+ * `renderSubAgentAnchor(graph, parentAgentId)` returns:
+ *   - `undefined` when `graph` is undefined (legacy mode → no anchor).
+ *   - `undefined` when the parent isn't a known graph member (defensive).
+ *   - A single one-line string otherwise, formatted as:
+ *
+ *       Spawned by <parent>, inheriting <department>.
+ *
+ * The line is fed into the assembler's existing `ephemeralSuffix`
+ * slot (below the cache boundary) so a sub-agent's prompt cache key
+ * isn't affected by inherited org membership — the cached prefix
+ * stays identical to the legacy sub-agent prompt.
+ *
+ * STAGE-B CONTRACT
+ *  - Stage A pinned Rule vii's edge shape; this Stage-B helper only
+ *    REFLECTS the spawner's existing record back at the model. It does
+ *    NOT mutate the graph and does NOT append a sub-agent member to
+ *    `graph.members`. Stage C+ may add that lifecycle wire-up.
+ */
+import type { OrgGraph } from "../../agents/org/types.js";
+export declare function renderSubAgentAnchor(graph: OrgGraph | undefined, parentAgentId: string): string | undefined;
+//# sourceMappingURL=sub-agent-anchor.d.ts.map

package/dist/system-prompt/org/sub-agent-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-anchor.d.ts","sourceRoot":"","sources":["../../../src/system-prompt/org/sub-agent-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAKpB"}

package/dist/system-prompt/org/sub-agent-anchor.js

@@ -0,0 +1,36 @@
+/**
+ * Brigade virtual-office layer — Stage B sub-agent anchor.
+ *
+ * The full `## Org` block (see `render-org-block.ts`) is operator-
+ * facing. Sub-agents inherit their spawner's department + a parent-
+ * report edge for the spawn's lifetime (derivation Rule vii), but
+ * they get a SHORTER context line that fits the minimal-mode prompt
+ * shape (banner + universal sections only — no operator directory).
+ *
+ * `renderSubAgentAnchor(graph, parentAgentId)` returns:
+ *   - `undefined` when `graph` is undefined (legacy mode → no anchor).
+ *   - `undefined` when the parent isn't a known graph member (defensive).
+ *   - A single one-line string otherwise, formatted as:
+ *
+ *       Spawned by <parent>, inheriting <department>.
+ *
+ * The line is fed into the assembler's existing `ephemeralSuffix`
+ * slot (below the cache boundary) so a sub-agent's prompt cache key
+ * isn't affected by inherited org membership — the cached prefix
+ * stays identical to the legacy sub-agent prompt.
+ *
+ * STAGE-B CONTRACT
+ *  - Stage A pinned Rule vii's edge shape; this Stage-B helper only
+ *    REFLECTS the spawner's existing record back at the model. It does
+ *    NOT mutate the graph and does NOT append a sub-agent member to
+ *    `graph.members`. Stage C+ may add that lifecycle wire-up.
+ */
+export function renderSubAgentAnchor(graph, parentAgentId) {
+    if (!graph)
+        return undefined;
+    const parent = graph.members[parentAgentId];
+    if (!parent)
+        return undefined;
+    return `Spawned by ${parentAgentId}, inheriting ${parent.department}.`;
+}
+//# sourceMappingURL=sub-agent-anchor.js.map

package/dist/system-prompt/org/sub-agent-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-anchor.js","sourceRoot":"","sources":["../../../src/system-prompt/org/sub-agent-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,MAAM,UAAU,oBAAoB,CAClC,KAA2B,EAC3B,aAAqB;IAErB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,cAAc,aAAa,gBAAgB,MAAM,CAAC,UAAU,GAAG,CAAC;AACzE,CAAC"}

package/dist/system-prompt/override.d.ts

@@ -0,0 +1,7 @@
+import type { BrigadeConfig } from "../config/io.js";
+export interface OverrideArgs {
+    config: BrigadeConfig;
+    agentId: string;
+}
+export declare function resolveSystemPromptOverride(args: OverrideArgs): string | undefined;
+//# sourceMappingURL=override.d.ts.map

package/dist/system-prompt/override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"override.d.ts","sourceRoot":"","sources":["../../src/system-prompt/override.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQrD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CASlF"}

package/dist/system-prompt/override.js

@@ -0,0 +1,13 @@
+export function resolveSystemPromptOverride(args) {
+    const agents = args.config.agents;
+    const perAgent = agents?.[args.agentId]?.systemPromptOverride;
+    if (typeof perAgent === "string" && perAgent.trim())
+        return perAgent;
+    // Top-level defaults (NOT an agent literally named "defaults") apply when
+    // no agent-specific override is set.
+    const fallback = args.config.defaults?.systemPromptOverride;
+    if (typeof fallback === "string" && fallback.trim())
+        return fallback;
+    return undefined;
+}
+//# sourceMappingURL=override.js.map

package/dist/system-prompt/override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"override.js","sourceRoot":"","sources":["../../src/system-prompt/override.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,2BAA2B,CAAC,IAAkB;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAgD,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC9D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrE,0EAA0E;IAC1E,qCAAqC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrE,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/system-prompt/pi-injection.d.ts

@@ -0,0 +1,5 @@
+import type { AgentSession } from "@mariozechner/pi-coding-agent";
+export type PersonaOverride = string | ((defaultPrompt?: string) => string);
+export declare function applyPersonaOverrideToSession(session: AgentSession, override: PersonaOverride): void;
+export declare function createPersonaOverride(prompt: string): PersonaOverride;
+//# sourceMappingURL=pi-injection.d.ts.map

package/dist/system-prompt/pi-injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-injection.d.ts","sourceRoot":"","sources":["../../src/system-prompt/pi-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAqBlE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAS5E,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,eAAe,GACxB,IAAI,CA8BN;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAErE"}

package/dist/system-prompt/pi-injection.js

@@ -0,0 +1,33 @@
+// Latched once per process: the first applyPersonaOverrideToSession call
+// reads the three written fields back to confirm Pi accepted them. If a
+// future Pi minor renames any of those internals, the read-back verifier
+// catches it on first turn and warns the operator instead of letting the
+// agent silently revert to its stock prompt on turn 2.
+let readbackChecked = false;
+export function applyPersonaOverrideToSession(session, override) {
+    const prompt = typeof override === "function" ? override().trim() : override.trim();
+    if (!prompt)
+        return;
+    session.agent.state.systemPrompt = prompt;
+    const internal = session;
+    internal._baseSystemPrompt = prompt;
+    internal._rebuildSystemPrompt = () => prompt;
+    if (readbackChecked)
+        return;
+    readbackChecked = true;
+    const stateOk = session.agent.state.systemPrompt === prompt;
+    const baseOk = internal._baseSystemPrompt === prompt;
+    const rebuildOk = typeof internal._rebuildSystemPrompt === "function" &&
+        internal._rebuildSystemPrompt([]) === prompt;
+    if (!stateOk || !baseOk || !rebuildOk) {
+        console.error("brigade: persona pin not confirmed after applyPersonaOverrideToSession. " +
+            "Pi may have renamed an internal field — agent could revert to stock " +
+            `prompt on subsequent turns. (stateOk=${stateOk} baseOk=${baseOk} rebuildOk=${rebuildOk})`);
+    }
+}
+// Convenience builder: closes over an assembled prompt so callers can pass
+// the captured value through plumbing that expects a `() => string`.
+export function createPersonaOverride(prompt) {
+    return () => prompt;
+}
+//# sourceMappingURL=pi-injection.js.map

package/dist/system-prompt/pi-injection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-injection.js","sourceRoot":"","sources":["../../src/system-prompt/pi-injection.ts"],"names":[],"mappings":"AAuBA,yEAAyE;AACzE,wEAAwE;AACxE,yEAAyE;AACzE,yEAAyE;AACzE,uDAAuD;AACvD,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,UAAU,6BAA6B,CAC3C,OAAqB,EACrB,QAAyB;IAEzB,MAAM,MAAM,GACV,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC;IAE1C,MAAM,QAAQ,GAAG,OAGhB,CAAC;IACF,QAAQ,CAAC,iBAAiB,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,oBAAoB,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;IAE7C,IAAI,eAAe;QAAE,OAAO;IAC5B,eAAe,GAAG,IAAI,CAAC;IAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,iBAAiB,KAAK,MAAM,CAAC;IACrD,MAAM,SAAS,GACb,OAAO,QAAQ,CAAC,oBAAoB,KAAK,UAAU;QACnD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;IAE/C,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CACX,0EAA0E;YACxE,sEAAsE;YACtE,wCAAwC,OAAO,WAAW,MAAM,cAAc,SAAS,GAAG,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC;AACtB,CAAC"}

package/dist/system-prompt/runtime-params.d.ts

@@ -0,0 +1,34 @@
+export interface RuntimeParams {
+    agentId: string;
+    workspaceDir: string;
+    cwd: string;
+    hostName: string;
+    platform: NodeJS.Platform;
+    arch: string;
+    nodeVersion: string;
+    shell: string | undefined;
+    modelLabel: string;
+    channelLabel: string;
+    thinkingLevel: string;
+    timezone: string;
+    /** UTC ISO timestamp (machine-readable, kept for back-compat). */
+    nowIso: string;
+    /** Human-readable wall-clock time in the operator's local timezone
+     *  (e.g. "Tue 2026-06-03 15:46"). The model reads this directly so it
+     *  never has to convert UTC to local in its head. */
+    nowLocal: string;
+    repoRoot: string | undefined;
+}
+export interface ResolveRuntimeArgs {
+    agentId: string;
+    workspaceDir: string;
+    cwd: string;
+    modelLabel: string;
+    channelLabel?: string;
+    thinkingLevel?: string;
+}
+export declare function resolveRuntimeParams(args: ResolveRuntimeArgs): RuntimeParams;
+export declare function formatRuntimeLine(p: RuntimeParams): string;
+export declare function findGitRoot(start: string): string | undefined;
+export declare function formatLocalNow(now: Date, tz: string): string;
+//# sourceMappingURL=runtime-params.d.ts.map

package/dist/system-prompt/runtime-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-params.d.ts","sourceRoot":"","sources":["../../src/system-prompt/runtime-params.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf;;yDAEqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAoB5E;AAMD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAe1D;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS7D;AAcD,wBAAgB,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CA0B5D"}