@spinabot/brigade 0.1.2 → 1.0.1

package/dist/agents/org/pride-template.d.ts

@@ -0,0 +1,272 @@
+/**
+ * Brigade Pride hierarchy template — the single source of truth for
+ * org-chart rendering.
+ *
+ * Brigade taunt: "Run it like a pride, not a pyramid." The display is
+ * deliberately flattened to THREE tiers regardless of how deep the
+ * underlying org graph nests:
+ *
+ *   Tier 1 — Higher Office: the `topOrder` agent (exactly 1).
+ *   Tier 2 — Department leads: direct reports of `topOrder` that are
+ *            heads of a department (resolved via
+ *            `cfg.org.departmentHeads` pin, OR computed as the most-
+ *            senior member of each department — i.e. the member with
+ *            the shortest manager-chain to `topOrder`, tiebroken
+ *            alphabetically).
+ *   Tier 3 — Team: every other member of each department, FLATTENED.
+ *            Middle managers that sit between a department lead and a
+ *            leaf agent are HIDDEN by display — the leaf appears
+ *            directly under its lead. The derived A2A graph is NOT
+ *            changed; only the chart is collapsed.
+ *
+ * Callers:
+ *
+ *   - TUI `/org` slash command
+ *   - Channel handlers (WhatsApp, Slack, Discord — anywhere a
+ *     monospace code block renders)
+ *   - Model-facing `org({action:"show"})` tool
+ *
+ * All three call into the same `renderPrideChart` (or its channel
+ * wrapper) so the chart shape can never drift between surfaces.
+ *
+ * NO breaking changes are introduced to the `/agents` slash command or
+ * the `agents_list` tool — they keep their existing flat output. The
+ * Pride chart is an ADDITIVE rendering layer.
+ */
+import type { OrgGraph } from "./types.js";
+/**
+ * Legacy single-value constants — kept as compat shims so any caller
+ * that imported the literal strings doesn't break. The chart itself
+ * now rotates via `pickTaunt()` / `pickFooterRule()` from the bank in
+ * `pride-taunts.ts` (145 taunts, 48 footer rules, 142 stories — all
+ * M-word-banned, anonymised, internet-researched).
+ *
+ * Prefer the bank pickers for new code; these literals stay only so
+ * older imports don't snap.
+ */
+export declare const BRIGADE_TAUNT = "Run it like a pride, not a pyramid.";
+export declare const BRIGADE_FOOTER_RULE = "No managers, just leads and the team.";
+/**
+ * Note printed by `/org` when `cfg.org` is absent. Tests pin both the
+ * `brigade org init` reference and the `/agents` redirect so neither
+ * can be silently dropped.
+ */
+export declare const PRIDE_CHART_FLAT_CREW_NOTE: string;
+/** One member entry inside a flattened department. */
+export interface PrideMember {
+    id: string;
+    role?: string;
+    bio?: string;
+}
+/** One department in the 3-tier flatten. */
+export interface PrideDepartment {
+    /** Slug of the department (matches `OrgGraph.departments` key). */
+    slug: string;
+    /** Department lead (resolved via pin or computed seniority). */
+    lead: PrideMember;
+    /**
+     * Every other member of the department, FLATTENED. Middle managers
+     * collapse: a leaf that reports to a middle manager still appears
+     * here under the department lead. Order: alphabetical by id.
+     */
+    team: PrideMember[];
+}
+/** Result of `flattenToThreeTiers`. */
+export interface PrideFlatten {
+    /**
+     * Tier 1: the Higher Office band. Length >= 1. Index 0 is always
+     * the resolved top-of-org (kept stable for back-compat); subsequent
+     * entries are c-suite members (Chief X Officer / CEO / CFO / COO /
+     * CTO / CMO / CIO / CSO / CPO / CRO / CHRO / President) plus anyone
+     * whose department slug is in the executive set ("executive",
+     * "exec", "leadership", "higher-office", "office"), sorted by
+     * manager-chain depth then alphabetically. C-suite agents that
+     * were previously appearing as DEPARTMENT LEADS (e.g. CFO over
+     * finance-lead) are now promoted here — which strictly REMOVES
+     * a middle-manager render shape, not adds one (the Pride policy
+     * "no managers, just leads and the team" is reinforced).
+     */
+    higherOffice: PrideMember[];
+    /**
+     * Tier 1 alias — `higherOffice[0]`. Kept so existing callers that
+     * just want the single top-of-org agent (CLI flat-crew note path,
+     * `org({action:"describe"})`, etc.) compile and work unchanged.
+     */
+    topOrder: PrideMember;
+    /** Tier 2 + Tier 3 grouped by department slug. */
+    departments: PrideDepartment[];
+}
+/**
+ * Determine whether a member belongs in the Higher Office tier.
+ *
+ * Rules (in evaluation order):
+ *   1. The graph's `topOrder` is ALWAYS in Higher Office (even if its
+ *      dept/role doesn't match the rules below — defensive).
+ *   2. Department slug is in the executive set
+ *      (`HIGHER_OFFICE_DEPT_SLUGS`).
+ *   3. Role matches the C-suite regex
+ *      (`Chief X Officer` / `CEO` / `CFO` / `COO` / `CTO` / `CIO`
+ *      / `CMO` / `CSO` / `CPO` / `CRO` / `CHRO` / `President`).
+ *
+ * Tests pin: changing this rule changes the chart shape, so the rule
+ * is exported for direct unit testing.
+ */
+export declare function isHigherOfficeMember(id: string, topOrderId: string, member: {
+    department: string;
+    role?: string;
+} | undefined): boolean;
+/** Options for `renderPrideChart`. */
+export interface RenderPrideChartOptions {
+    /** Crew name to print after the lion in the header. */
+    crewName?: string;
+    /** Emoji decoration. When false, ASCII fallback tokens are used. */
+    emoji?: boolean;
+    /** ANSI color escapes. When false, the result is plain text. */
+    ansi?: boolean;
+    /**
+     * Random number generator for picking taunt / footer / story from the
+     * `pride-taunts.ts` bank. Defaults to a fresh-per-call live RNG so
+     * every render rotates. Tests pass a seeded RNG (see
+     * `createSeededRng(seed)`) to pin output.
+     */
+    rng?: () => number;
+    /**
+     * Story footer behaviour:
+     *   - undefined / "auto" (default): include a random story ~50% of
+     *     renders, gated by `rng()`. Keeps the chart from feeling cluttered
+     *     while making most views feel fresh.
+     *   - "always": render a story on every chart (good for /org --story).
+     *   - "never": suppress the story footer entirely (good for /org --no-story
+     *     or tests that want a deterministic chart-only render).
+     */
+    story?: "auto" | "always" | "never";
+}
+/**
+ * Flatten an OrgGraph to the 3-tier Pride shape.
+ *
+ * Rules (re-stated for clarity):
+ *   1. Tier 1 is always exactly `graph.topOrder` (or, defensively, the
+ *      first member when the topOrder reference is broken).
+ *   2. For each department, the lead is resolved by, in order:
+ *        a. Operator pin (`cfg.org.departmentHeads[slug]`) — but the
+ *           graph type doesn't carry that pin, so callers that have it
+ *           should pre-resolve and call `flattenToThreeTiersWithPins`;
+ *           the bare flatten falls through to (b) when no pin map is
+ *           supplied. See `flattenToThreeTiers` below — the bare form
+ *           uses (b) only.
+ *        b. Most-senior member: shortest manager-chain length to
+ *           `topOrder`. Tiebroken alphabetically by id.
+ *        c. If neither (a) nor (b) yield a member, the first
+ *           alphabetical member of the department is the implicit
+ *           lead.
+ *   3. Every other member of the department is placed in `team`,
+ *      ALPHABETICAL by id. Middle managers and sub-middle managers
+ *      collapse — they appear as ordinary team members under the
+ *      lead.
+ *   4. A member whose manager-chain does NOT terminate at `topOrder`
+ *      (orphaned) is folded into the closest department: walk up the
+ *      reportsTo chain until an ancestor that IS a department lead is
+ *      reached, and place the member in that lead's department. If no
+ *      such ancestor exists, the member's own `member.department`
+ *      bucket is used. If even that fails, the bucket "unassigned" is
+ *      synthesised.
+ */
+export declare function flattenToThreeTiers(graph: OrgGraph): PrideFlatten;
+/**
+ * Same as `flattenToThreeTiers`, but allows the caller (CLI / TUI /
+ * channel) to supply the `cfg.org.departmentHeads` pin map so the
+ * lead-resolution rule can honour operator-authored pins.
+ */
+export declare function flattenToThreeTiersWithPins(graph: OrgGraph, departmentHeads: Record<string, string> | undefined): PrideFlatten;
+/**
+ * Render the Pride chart as a single string. Default opts are
+ * `{ emoji: true, ansi: true }`.
+ */
+export declare function renderPrideChart(graph: OrgGraph, opts?: RenderPrideChartOptions): string;
+/**
+ * Render variant that accepts the operator pin map. Use this from the
+ * TUI / CLI / channel layer where `cfg.org.departmentHeads` is
+ * already in scope.
+ */
+export declare function renderPrideChartWithPins(graph: OrgGraph, departmentHeads: Record<string, string> | undefined, opts?: RenderPrideChartOptions): string;
+/**
+ * Render the Pride chart as a TREE with branch connectors (`├──`, `└──`,
+ * vertical-line continuation). Same data + same taunt/footer/story bank
+ * as `renderPrideChart`, but a more visual layout suited to wide
+ * monospace terminals (TUI default). Channels keep the tight list form
+ * because tree connectors look noisy on narrow mobile screens.
+ *
+ * Layout:
+ *
+ *     🦁 The Pride
+ *        <taunt>
+ *
+ *     👑 alex · Chief Executive Officer
+ *     │
+ *     ├── 🏛 engineering · priya · Engineering Lead
+ *     │   ├── keshav · Inventory Specialist
+ *     │   └── jordan · Senior Engineer
+ *     │
+ *     ├── 🏛 ops · rex · Operations Lead
+ *     │   └── zen · Logistics
+ *     │
+ *     └── 🏛 strategy · demand-planner · Strategy Lead
+ *
+ *     ──
+ *     ⚡ <footer rule>
+ *
+ *     📖 <name> · <role>     (optional, 50% gated)
+ *        <story>
+ *
+ * ASCII fallback (emoji:false) swaps connectors to `|--` / `'--` / `|`
+ * for terminals that don't render box-drawing chars.
+ */
+export declare function renderPrideTree(graph: OrgGraph, opts?: RenderPrideChartOptions): string;
+export declare function renderPrideTreeWithPins(graph: OrgGraph, departmentHeads: Record<string, string> | undefined, opts?: RenderPrideChartOptions): string;
+/**
+ * Render the Pride chart as a HORIZONTAL org-chart with boxes and a
+ * branching spine — the "real org chart" look from common BI tools.
+ * Top-of-org sits centered above the spine; department leads sit in a
+ * row below; team members listed as bullets under each lead.
+ *
+ *                  🦁 The Pride
+ *                  <taunt>
+ *
+ *                 ┌─────────────────────┐
+ *                 │   👑 alex           │
+ *                 │ Chief of Staff      │
+ *                 └──────────┬──────────┘
+ *                            │
+ *           ┌────────────────┼────────────────┐
+ *           │                │                │
+ *  ┌────────┴────────┐ ┌─────┴───────────┐ ┌──┴──────────────┐
+ *  │ 🏛 eng          │ │ 🏛 ops          │ │ 🏛 strat        │
+ *  │ priya           │ │ rex             │ │ planner         │
+ *  │ Eng Lead        │ │ Ops Lead        │ │ Strat Lead      │
+ *  └─────────────────┘ └─────────────────┘ └─────────────────┘
+ *    • keshav            • zen               (no team)
+ *      Inv Specialist      Logistics
+ *    • jordan
+ *      QA
+ *
+ *  ──
+ *  ⚡ <footer rule>
+ *
+ * Uses box-drawing glyphs (┌─┐│└─┘├┤┬┴┼) with emoji enabled, falls
+ * back to ASCII (+ - |) otherwise. Same 3-tier flatten, same taunt +
+ * footer bank as `renderPrideChart` / `renderPrideTree`.
+ *
+ * Width: ~57 chars for 3 departments at COL_WIDTH=17, fits in standard
+ * 80-col terminals. For >4 departments the horizontal layout starts to
+ * exceed common widths; callers should prefer `renderPrideTree` (vertical)
+ * or `renderPrideChart` (list) when `process.stdout.columns < width`.
+ */
+export declare function renderPrideColumns(graph: OrgGraph, opts?: RenderPrideChartOptions): string;
+export declare function renderPrideColumnsWithPins(graph: OrgGraph, departmentHeads: Record<string, string> | undefined, opts?: RenderPrideChartOptions): string;
+/**
+ * Channel-safe variant: forces `emoji: true, ansi: false` and wraps
+ * the output in a triple-backtick monospace code block. WhatsApp,
+ * Slack, and Discord all render this as a monospace block.
+ */
+export declare function renderPrideChartForChannel(graph: OrgGraph, opts?: Omit<RenderPrideChartOptions, "emoji" | "ansi">): string;
+//# sourceMappingURL=pride-template.d.ts.map

package/dist/agents/org/pride-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pride-template.d.ts","sourceRoot":"","sources":["../../../src/agents/org/pride-template.ts"],"names":[],"mappings":"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"}