@productbrain/cli 0.1.0-beta.1391 → 0.1.0-beta.13921

package/dist/lib/sessionNotices.js

@@ -0,0 +1,124 @@
+/**
+ * FEAT-1409 spine core — CLI rendering of the channel-agnostic session-start notice contract
+ * (convex/lib/notices/types.ts's `Notice`). Convex never renders a notice; this file owns the
+ * ONLY CLI-side mapping from a notice's neutral `action.verb` to a runnable `pb` command
+ * string (HARD CONSTRAINT 2 — no surface syntax in Convex).
+ *
+ * Distinct from `./notice-marker.ts`, which throttles the unrelated CLI version-update banner —
+ * do not conflate the two "notice" concepts.
+ */
+import { stripControlChars } from './strip.js';
+/**
+ * verb -> the exact `pb` command a person can copy-paste to act on the notice. `feedback.list`
+ * (S1, feedback-status) and `feedback.queue` (S4/TEN-2971, feedback-queue — the vendor triage
+ * standing notice replacing the legacy plain-text hint) both point at already-shipped commands
+ * — HARD CONSTRAINT 10, no new gateway route. Unrecognized verbs fall back to the raw verb
+ * string rather than throwing — a forward-compat seam for a producer landing before its CLI
+ * mapping does.
+ *
+ * WP-638 S4 (R24 — moved here from S5 so the mapping ships in the slice whose doneWhen quotes
+ * it, §16.2 S4(j)): the eight routed-question verbs. `question.list` also gets an entry for
+ * completeness even though the ack-gate block below renders its own paste-ready `answer` command
+ * per row rather than this generic mapping.
+ */
+const VERB_COMMANDS = {
+    'feedback.list': 'pb feedback list',
+    'feedback.queue': 'pb feedback queue',
+    'question.create': 'pb question create "<text>"',
+    'question.assign': 'pb question assign <id>',
+    'question.answer': 'pb question answer <id> "<your answer>"',
+    'question.forceClose': 'pb question force-close <id> --reason "<why>"',
+    'question.list': 'pb question list',
+    // WP-798 TASK-589: the drafts-waiting notice's door is the web Bridge, not a pb command; its `change` already says
+    // "open /w/<slug>/bridge", so the verb maps to no command and the line carries no suffix.
+    'bridge.open': '',
+};
+export function noticeCommand(action) {
+    const template = VERB_COMMANDS[action.verb] ?? action.verb;
+    // Review finding: the outcomes producer's asker-arm action carries `{ mine: true }` (§7.3(a))
+    // so the reader lands on their OWN history, not the ack-gate obligation view (which excludes
+    // exactly the processed question the notice is about) — the generic template must reflect it.
+    return action.verb === 'question.list' && action.args?.mine === true ? `${template} --mine` : template;
+}
+export const QUESTION_ACK_GATE_SOURCE_ID = 'question-ack-gate';
+/**
+ * §7.5's verbatim block — the ack-gate producer's own render. Fixed elements, in order: the
+ * count, the phrase "need you before you continue", one line per question (id/text/reason/age),
+ * the matrix-derived verb list (already resolved server-side onto each brief's `actions`), one
+ * ready-to-paste `answer` command, and the canonical closing sentence — quoted identically
+ * everywhere it appears (§7.5/§10/§16.2 S4(f)).
+ */
+/** verb (as it appears in a §3.9a display list, e.g. "take it") from the neutral gateway route
+ *  name a brief's own `actions` carry — the inverse direction of `questionVerbToRoute`
+ *  (convex/lib/questionDisplayStrings.ts), kept here since only the RENDERER needs the display
+ *  label back from the route. */
+function displayVerbFromRoute(route) {
+    switch (route) {
+        case 'question.assign': return 'take it / reassign';
+        case 'question.forceClose': return 'force-close';
+        default: return route.replace(/^question\./, '');
+    }
+}
+/** Sanitizes every workspace-controlled string a question brief carries before it reaches the
+ *  terminal — matches `formatters/questions.ts`'s own `singleLine` control-char stripping. */
+function safe(text) {
+    return text ? stripControlChars(text).replace(/\s+/g, ' ').trim() : '';
+}
+function formatQuestionBrief(q) {
+    const lines = [];
+    lines.push(`  • [${safe(q.sourcePointer)}] ${safe(q.name)}  — ${safe(q.whyYou)}, ${q.ageDays}d`);
+    lines.push(`      "${safe(q.question)}" — asked by ${safe(q.asker)}${q.domain ? `, ${safe(q.domain)} domain` : ''}`);
+    if (q.dependents.count > 0) {
+        const names = q.dependents.named.map((d) => `${safe(d.name)} (${safe(d.id)})`).join(', ');
+        const countLabel = q.dependents.truncated ? `${q.dependents.count}+` : String(q.dependents.count);
+        lines.push(`      blocks ${countLabel} item(s)${names ? `: ${names}` : ''}`);
+    }
+    // Review finding: reconstructing the display verb from the route alone is lossy — 'take it'
+    // and 'reassign' share `question.assign`, 'pass' and 'decline' share `question.decline` — so
+    // prefer the server's own `label` (the actual §3.9a verb legal for THIS row) and fall back to
+    // the route-derived guess only for an older/unlabeled action.
+    const verbList = [...new Set(q.actions.map((a) => safe(a.label) || displayVerbFromRoute(a.verb)))].join(' · ') || 'answer';
+    lines.push(`      ${verbList}  →  pb question answer ${safe(q.sourcePointer)} "<your answer>"`);
+    return lines;
+}
+function formatQuestionAckGateBlock(notice) {
+    const questions = notice.payload?.questions ?? [];
+    const lines = [];
+    const icon = notice.severity === 'emergency' ? '⚠' : notice.severity === 'warning' ? '⚠' : 'ℹ';
+    lines.push(`${icon} ${questions.length} open question${questions.length === 1 ? '' : 's'} need you before you continue.`);
+    for (const q of questions)
+        lines.push(...formatQuestionBrief(q));
+    lines.push('  Deal with each question above before proceeding.');
+    // Review finding: the scan behind this block is honestly capped — disclose it as an ADDITIONAL
+    // line rather than silently presenting a capped set as the complete obligation (§7.5's fixed
+    // elements, including the canonical closing sentence above, stay untouched).
+    if (notice.payload?.truncated) {
+        lines.push('  (This list may be incomplete — you may have more open questions than shown.)');
+    }
+    return lines;
+}
+// D2a+D2b (TASK-413/414, WP-781): §10.3's adopt-discovery advisory (`formatAdoptDiscoveryLine`)
+// is deleted along with `adopt` itself (DEC-1707/§10: only assign/answer/forceClose remain).
+/** The generic one-liner; a verb mapped to no command (a web door) adds no " — <command>" suffix. */
+/** A subject's later lines (TASK-923: the drafts-waiting notice names each draft on its own line) print indented under it. */
+function noticeLine(n) {
+    const command = noticeCommand(n.action);
+    const [head = '', ...rest] = n.subject.split('\n');
+    return [`  • ${safe(head)} (${safe(n.change)})${command ? ` — ${command}` : ''}`, ...rest.map((line) => `    ${safe(line)}`)];
+}
+/** One line per notice, oldest first (server already sorts producers' output this way) — except
+ *  the question-ack-gate notice, which renders §7.5's full multi-line block instead of the
+ *  generic one-liner (R23: the Notice-contract extension is additive, so every OTHER producer's
+ *  one-liner is untouched). */
+export function formatSessionNoticeLines(notices) {
+    if (!notices || notices.length === 0)
+        return [];
+    return notices.flatMap((n) => n.source === QUESTION_ACK_GATE_SOURCE_ID && n.payload
+        ? formatQuestionAckGateBlock(n)
+        // Review finding: the generic one-liner interpolated `subject`/`change` raw — the
+        // outcomes producer (questionOutcomesProducer.ts) builds these from workspace-controlled
+        // text (decline/force-close reasons, person and dependent-entry names) with no upstream
+        // sanitization, so this was the one remaining un-sanitized terminal-write path.
+        : noticeLine(n));
+}
+//# sourceMappingURL=sessionNotices.js.map

package/dist/lib/sessionNotices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionNotices.js","sourceRoot":"","sources":["../../src/lib/sessionNotices.ts"],"names":[],"mappings":"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"}

package/dist/lib/sessionNotices.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sessionNotices.test.d.ts.map

package/dist/lib/sessionNotices.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionNotices.test.d.ts","sourceRoot":"","sources":["../../src/lib/sessionNotices.test.ts"],"names":[],"mappings":""}

package/dist/lib/sessionNotices.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from 'vitest';
+import { noticeCommand, formatSessionNoticeLines } from './sessionNotices.js';
+function notice(overrides = {}) {
+    return {
+        source: 'feedback-status',
+        type: 'feedback.answer',
+        severity: 'advisory',
+        subject: 'Your report has an answer',
+        change: 'jd7k2abc: "pb update returns SESSION"',
+        occurredAt: 1_000,
+        action: { verb: 'feedback.list', args: {} },
+        ...overrides,
+    };
+}
+describe('noticeCommand — verb -> pb command mapping', () => {
+    it('maps the shipped feedback.list verb to the exact pb feedback list command', () => {
+        expect(noticeCommand({ verb: 'feedback.list', args: {} })).toBe('pb feedback list');
+    });
+    it('maps the S4/TEN-2971 feedback.queue verb to the exact pb feedback queue command', () => {
+        expect(noticeCommand({ verb: 'feedback.queue', args: {} })).toBe('pb feedback queue');
+    });
+    it('falls back to the raw verb for an unmapped verb (forward-compat seam)', () => {
+        expect(noticeCommand({ verb: 'future.verb', args: {} })).toBe('future.verb');
+    });
+});
+describe('formatSessionNoticeLines', () => {
+    it('renders the drafts-waiting notice (TASK-589) with the Bridge door and nothing after it', () => {
+        const lines = formatSessionNoticeLines([notice({
+                source: 'drafts-waiting', type: 'drafts.waiting', subject: '3 drafts wait for your accept as Team Lead',
+                change: 'open /w/acme/bridge', action: { verb: 'bridge.open', args: { path: '/w/acme/bridge', count: 3, atLeast: false } },
+            })]);
+        expect(lines).toEqual(['  • 3 drafts wait for your accept as Team Lead (open /w/acme/bridge)']);
+    });
+    it('returns [] for undefined/empty notices', () => {
+        expect(formatSessionNoticeLines(undefined)).toEqual([]);
+        expect(formatSessionNoticeLines([])).toEqual([]);
+    });
+    it('renders the answer notice (TASK-905) as one line: subject, report id and quote, the mapped command', () => {
+        expect(formatSessionNoticeLines([notice()])).toEqual(['  • Your report has an answer (jd7k2abc: "pb update returns SESSION") — pb feedback list']);
+        expect(formatSessionNoticeLines([notice({ subject: 'Your report: the fix shipped' })]))
+            .toEqual(['  • Your report: the fix shipped (jd7k2abc: "pb update returns SESSION") — pb feedback list']);
+    });
+    it('renders multiple notices in the order given', () => {
+        const lines = formatSessionNoticeLines([
+            notice({ subject: 'First' }),
+            notice({ subject: 'Second' }),
+        ]);
+        expect(lines).toHaveLength(2);
+        expect(lines[0]).toContain('First');
+        expect(lines[1]).toContain('Second');
+    });
+});
+//# sourceMappingURL=sessionNotices.test.js.map

package/dist/lib/sessionNotices.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionNotices.test.js","sourceRoot":"","sources":["../../src/lib/sessionNotices.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/sessionOpen.d.ts

@@ -0,0 +1,26 @@
+import type { GatewayRouteReturnByName } from '@productbrain/kernel-client';
+type SeatRoute = 'agent.startSession' | 'agent.resumeSession';
+type StartNotes = GatewayRouteReturnByName<'agent.sessionStartNotes'>;
+/** The start notes as fields beside the seat's own, without the stamp they handed back. */
+export type StartNotesFields = Partial<Omit<StartNotes, 'stamp' | 'sessionId'>>;
+export interface OpenedSeat<S> {
+    seat: S;
+    view: S & StartNotesFields;
+    seatMs: number;
+    notesMs?: number;
+    notesFailed: boolean;
+}
+/** The conversation id the seat is keyed by: the resolved one, else one minted from the project root and binding. */
+export declare function seatConversationId(resolved: string | null, bindingFingerprint?: string): string;
+/** The seat (one retry on a timeout), then the start notes and their stamp; the times are client wall-clock. */
+export declare function openSeatWithNotes<S extends {
+    sessionId: string;
+}>(fn: SeatRoute, args: Record<string, unknown>, conversation: string): Promise<OpenedSeat<S>>;
+/** The start's text: the whole start text and the timing line; without its notes, the headline, the start-notes sentence and the
+ *  seat time (the hook prints the first line as the headline, so it is never NO ROLE while the seat is open). */
+export declare function startTextOf<S extends {
+    roleName?: string;
+    roleRef?: string;
+}>(opened: OpenedSeat<S>, fullText: string, conversation?: string | null): string;
+export {};
+//# sourceMappingURL=sessionOpen.d.ts.map

package/dist/lib/sessionOpen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionOpen.d.ts","sourceRoot":"","sources":["../../src/lib/sessionOpen.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAS5E,KAAK,SAAS,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAC9D,KAAK,UAAU,GAAG,wBAAwB,CAAC,yBAAyB,CAAC,CAAC;AACtE,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC;AAChF,MAAM,WAAW,UAAU,CAAC,CAAC;IAAI,IAAI,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE;AAE9H,qHAAqH;AACrH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/F;AAID,gHAAgH;AAChH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAcnK;AAED;iHACiH;AACjH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI5J"}

package/dist/lib/sessionOpen.js

@@ -0,0 +1,56 @@
+/**
+ * The two-call session start (TASK-1408, DEC-2495, TEN-5950): the seat in one short call, then its start notes (a query) and
+ * their stamp (one small write). `pb session start` and its resume both come through here.
+ *
+ * - The seat is keyed by a conversation id. With none from the flag or the environment, one is minted from the project root (the
+ *   folder the local marker lives under) and its binding, so it is the same on every run: a rerun and the one retry reuse the seat instead of opening a second (DEC-1535:
+ *   the arguments make the retry idempotent). The local marker keeps its own path; the minted id only rides to the server.
+ * - The seat is retried once, on NETWORK_TIMEOUT only, never on a refusal; this is the one retry layer (the hook adds none). A
+ *   second timeout throws the gateway's own seat sentence (gatewayTimeout.ts).
+ * - A failed notes or stamp call never fails the start: the seat is open, so the marker is written and the start prints its
+ *   headline and START_NOTES_NOT_LOADED_LINE, and exits 0.
+ */
+import { createHash } from 'crypto';
+import { kernelCall } from './client.js';
+import { CLIError, ErrorCode } from './errors.js';
+import { actingRoleHeadline } from './ruleListRender.js';
+import { sanitizeSingleLineField } from './strip.js';
+import { startTimingLine } from './sessionStartWords.js';
+import { START_NOTES_NOT_LOADED_LINE } from './sessionStartCommands.js';
+import { findProjectRoot } from './projectConfig.js';
+/** The conversation id the seat is keyed by: the resolved one, else one minted from the project root and binding. */
+export function seatConversationId(resolved, bindingFingerprint) {
+    if (resolved)
+        return resolved;
+    const root = findProjectRoot(process.cwd()) ?? process.cwd(); // the root the local marker lives under (lib/session.ts)
+    return `cli-${createHash('sha256').update(`${root}\n${bindingFingerprint ?? ''}`).digest('hex').slice(0, 32)}`;
+}
+const isTimeout = (err) => err instanceof CLIError && err.code === ErrorCode.NETWORK_TIMEOUT;
+/** The seat (one retry on a timeout), then the start notes and their stamp; the times are client wall-clock. */
+export async function openSeatWithNotes(fn, args, conversation) {
+    const started = Date.now();
+    const call = () => kernelCall(fn, { ...args, conversationId: conversation, seatOnly: true });
+    const seat = await call().catch((err) => { if (isTimeout(err))
+        return call(); throw err; });
+    const seatMs = Date.now() - started, notesStarted = Date.now();
+    try {
+        const acting = { actingSessionId: seat.sessionId }; // the call log names the seat these serve
+        const notes = await kernelCall('agent.sessionStartNotes', { sessionId: seat.sessionId }, acting);
+        if (notes?.stamp)
+            await kernelCall('agent.sessionStartStamp', { sessionId: seat.sessionId, stamp: notes.stamp }, acting);
+        const { stamp: _stamp, sessionId: _id, ...fields } = notes ?? {};
+        return { seat, view: { ...seat, ...fields }, seatMs, notesMs: Date.now() - notesStarted, notesFailed: false };
+    }
+    catch {
+        return { seat, view: { ...seat }, seatMs, notesFailed: true };
+    }
+}
+/** The start's text: the whole start text and the timing line; without its notes, the headline, the start-notes sentence and the
+ *  seat time (the hook prints the first line as the headline, so it is never NO ROLE while the seat is open). */
+export function startTextOf(opened, fullText, conversation) {
+    if (!opened.notesFailed)
+        return `${fullText}\n${startTimingLine(opened.seatMs, opened.notesMs)}`;
+    const role = { name: opened.seat.roleName ?? 'no role', ...(opened.seat.roleRef ? { entryId: opened.seat.roleRef } : {}) };
+    return [actingRoleHeadline(role, sanitizeSingleLineField, { conversation: conversation ?? undefined }), START_NOTES_NOT_LOADED_LINE, startTimingLine(opened.seatMs, undefined)].join('\n');
+}
+//# sourceMappingURL=sessionOpen.js.map

package/dist/lib/sessionOpen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionOpen.js","sourceRoot":"","sources":["../../src/lib/sessionOpen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQrD,qHAAqH;AACrH,MAAM,UAAU,kBAAkB,CAAC,QAAuB,EAAE,kBAA2B;IACtF,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,yDAAyD;IACvH,OAAO,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,KAAK,kBAAkB,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAChH,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,GAAY,EAAW,EAAE,CAAC,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,eAAe,CAAC;AAE/G,gHAAgH;AAChH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAkC,EAAa,EAAE,IAA6B,EAAE,YAAoB;IAC1I,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,UAAU,CAAI,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/D,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,0CAA0C;QAC9F,MAAM,KAAK,GAAG,MAAM,UAAU,CAAoB,yBAAyB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;QACpH,IAAI,KAAK,EAAE,KAAK;YAAE,MAAM,UAAU,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,IAAK,EAA0B,CAAC;QAC1F,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC/G,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/D,CAAC;AACF,CAAC;AAED;iHACiH;AACjH,MAAM,UAAU,WAAW,CAAoD,MAAqB,EAAE,QAAgB,EAAE,YAA4B;IACnJ,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,GAAG,QAAQ,KAAK,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACjG,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3H,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,uBAAuB,EAAE,EAAE,YAAY,EAAE,YAAY,IAAI,SAAS,EAAE,CAAC,EAAE,2BAA2B,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5L,CAAC"}

package/dist/lib/sessionStartCommands.d.ts

@@ -0,0 +1,5 @@
+/** A second seat timeout, with the commands that reuse the seat or show it. */
+export declare function seatMayBeOpenLine(conversation: string): string;
+/** A seat whose start notes did not load, with the command that loads them. */
+export declare const START_NOTES_NOT_LOADED_LINE = "Start notes not loaded. Run pb orient before you write. Until the next start, this session shows no served rules.";
+//# sourceMappingURL=sessionStartCommands.d.ts.map

package/dist/lib/sessionStartCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStartCommands.d.ts","sourceRoot":"","sources":["../../src/lib/sessionStartCommands.ts"],"names":[],"mappings":"AAMA,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B,sHAAkG,CAAC"}

package/dist/lib/sessionStartCommands.js

@@ -0,0 +1,12 @@
+/**
+ * The CLI's commands beside the shared start words (TASK-1408, RULE-664): the words say the fix, this file names the CLI command
+ * that does it. The MCP names its own tool calls (packages/mcp-server/src/sessionOpen.ts).
+ */
+import { NO_SERVED_RULES_UNTIL_NEXT_START, SEAT_MAY_BE_OPEN, START_NOTES_NOT_LOADED } from './sessionStartWords.js';
+/** A second seat timeout, with the commands that reuse the seat or show it. */
+export function seatMayBeOpenLine(conversation) {
+    return `${SEAT_MAY_BE_OPEN} Run pb session start again, it reuses it, or pb session show ${conversation}.`;
+}
+/** A seat whose start notes did not load, with the command that loads them. */
+export const START_NOTES_NOT_LOADED_LINE = `${START_NOTES_NOT_LOADED} Run pb orient before you write. ${NO_SERVED_RULES_UNTIL_NEXT_START}`;
+//# sourceMappingURL=sessionStartCommands.js.map

package/dist/lib/sessionStartCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStartCommands.js","sourceRoot":"","sources":["../../src/lib/sessionStartCommands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gCAAgC,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEpH,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,OAAO,GAAG,gBAAgB,iEAAiE,YAAY,GAAG,CAAC;AAC7G,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,sBAAsB,oCAAoC,gCAAgC,EAAE,CAAC"}

package/dist/lib/sessionStartWords.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The words a two-call session start prints (TASK-1408, DEC-2495, RULE-664): the seat-timeout sentence, the start-notes sentence,
+ * the timing line, and the word for each close reason a session list prints. Dependency-free: copied verbatim into the CLI and
+ * the MCP by scripts/generate-mcp-embedded-copies.mjs. The sentences state the fact; each surface adds the one command that fixes it.
+ */
+/** A second seat timeout: the seat may have opened on the server (a rerun reuses it by conversation). */
+export declare const SEAT_MAY_BE_OPEN = "The seat may already be open.";
+/** The seat opened but its start notes (rules, notices, briefing) did not load or were not saved. */
+export declare const START_NOTES_NOT_LOADED = "Start notes not loaded.";
+/** What a seat whose start notes were not saved shows until it starts again. */
+export declare const NO_SERVED_RULES_UNTIL_NEXT_START = "Until the next start, this session shows no served rules.";
+/** One line, client wall-clock: the seat call (its one retry included) and the start notes (the stamp inside). */
+export declare function startTimingLine(seatMs: number, notesMs: number | undefined): string;
+/** The closer that ended a session row (agentSessions.closeReason; kernel/sessions/sessionState.ts SESSION_CLOSE_REASONS). */
+export declare const SESSION_CLOSE_REASON_WORDS: Readonly<Record<string, string>>;
+/** The word for a close reason; an unknown one prints as stored. */
+export declare function sessionCloseReasonWord(reason: string): string;
+//# sourceMappingURL=sessionStartWords.d.ts.map

package/dist/lib/sessionStartWords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStartWords.d.ts","sourceRoot":"","sources":["../../src/lib/sessionStartWords.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,yGAAyG;AACzG,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAEhE,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,8DAA8D,CAAC;AAE5G,kHAAkH;AAClH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGnF;AAED,8HAA8H;AAC9H,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQvE,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/lib/sessionStartWords.js

@@ -0,0 +1,34 @@
+// GENERATED by scripts/generate-mcp-embedded-copies.mjs from kernel/sessions/sessionStartWords.ts.
+// DO NOT EDIT. Run `npm run mcp:embedded-copies` to regenerate.
+// Local runtime copy for the isolated connector build.
+/**
+ * The words a two-call session start prints (TASK-1408, DEC-2495, RULE-664): the seat-timeout sentence, the start-notes sentence,
+ * the timing line, and the word for each close reason a session list prints. Dependency-free: copied verbatim into the CLI and
+ * the MCP by scripts/generate-mcp-embedded-copies.mjs. The sentences state the fact; each surface adds the one command that fixes it.
+ */
+/** A second seat timeout: the seat may have opened on the server (a rerun reuses it by conversation). */
+export const SEAT_MAY_BE_OPEN = 'The seat may already be open.';
+/** The seat opened but its start notes (rules, notices, briefing) did not load or were not saved. */
+export const START_NOTES_NOT_LOADED = 'Start notes not loaded.';
+/** What a seat whose start notes were not saved shows until it starts again. */
+export const NO_SERVED_RULES_UNTIL_NEXT_START = 'Until the next start, this session shows no served rules.';
+/** One line, client wall-clock: the seat call (its one retry included) and the start notes (the stamp inside). */
+export function startTimingLine(seatMs, notesMs) {
+    const s = (ms) => `${(ms / 1000).toFixed(1)} s`;
+    return notesMs === undefined ? `seat ${s(seatMs)}` : `seat ${s(seatMs)} · start notes ${s(notesMs)}`;
+}
+/** The closer that ended a session row (agentSessions.closeReason; kernel/sessions/sessionState.ts SESSION_CLOSE_REASONS). */
+export const SESSION_CLOSE_REASON_WORDS = {
+    client_close: 'closed by its client',
+    key_revoked: 'its API key was revoked',
+    idle_touch: 'idle over 2 hours',
+    idle_sweep: 'idle over 2 hours',
+    lease_sweep: 'its 8-hour lease ran out',
+    reuse_not_live: 'not live when a start reused its conversation',
+    quota_reclaim: 'reclaimed for the session quota',
+};
+/** The word for a close reason; an unknown one prints as stored. */
+export function sessionCloseReasonWord(reason) {
+    return Object.prototype.hasOwnProperty.call(SESSION_CLOSE_REASON_WORDS, reason) ? SESSION_CLOSE_REASON_WORDS[reason] : reason;
+}
+//# sourceMappingURL=sessionStartWords.js.map

package/dist/lib/sessionStartWords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStartWords.js","sourceRoot":"","sources":["../../src/lib/sessionStartWords.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,gEAAgE;AAChE,uDAAuD;AAEvD;;;;GAIG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAEhE,qGAAqG;AACrG,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC;AAEhE,gFAAgF;AAChF,MAAM,CAAC,MAAM,gCAAgC,GAAG,2DAA2D,CAAC;AAE5G,kHAAkH;AAClH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAA2B;IAC1E,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AACtG,CAAC;AAED,8HAA8H;AAC9H,MAAM,CAAC,MAAM,0BAA0B,GAAqC;IAC3E,YAAY,EAAE,sBAAsB;IACpC,WAAW,EAAE,yBAAyB;IACtC,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,0BAA0B;IACvC,cAAc,EAAE,+CAA+C;IAC/D,aAAa,EAAE,iCAAiC;CAChD,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACpD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/H,CAAC"}

package/dist/lib/spineRungs.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The strategic spine's rungs, child to parent, and the one verb that joins each pair (TASK-1026, WP-862).
+ *
+ * Work package --validates--> key result --part_of--> objective --part_of--> strategy --part_of-->
+ * vision --part_of--> purpose (TASK-888, RULE-660: the spine is accepted upward to Purpose).
+ * spineTrace.ts walks it and re-exports it; kernel/quality/checklist.ts words it (rungLine).
+ *
+ * Dependency-free on purpose: scripts/generate-mcp-embedded-copies.mjs ships this exact source
+ * to the CLI and the MCP server beside the checklist copy, so every surface reads one sequence.
+ */
+export type SpineRung = 'key_result' | 'objective' | 'strategy' | 'vision' | 'purpose';
+export type SpineWalkGap = 'key_result_missing' | 'objective_missing' | 'strategy_missing' | 'vision_missing' | 'purpose_missing' | 'inconclusive';
+/** One rung of the typed walk: the outbound relation type required, the target canonicalKey it
+ *  must resolve to, and the gap name reported when this rung is never reached. */
+export interface SpineRungSpec {
+    relationType: 'validates' | 'part_of';
+    targetKey: SpineRung;
+    gapIfMissing: SpineWalkGap;
+}
+/**
+ * TASK-1027 (DEC-1994): what a surface needs to write its own Next line for a spine refusal, carried as error data:
+ * accept the draft that blocks, or write the rung's link from the holder to a named entry or, with no `to`, to an entry of
+ * `toKind` (spineKindPlaceholder). A Next names only commands that run today (RULE-662).
+ * TASK-1028: an accept may name the entry it `replaces` (an ID or a placeholder).
+ * TASK-1164 (DEC-2295 addendum): a relate may be a `move`, which takes the entry off the parent it already hangs on.
+ */
+export type SpineNext = {
+    action: 'accept';
+    entryId: string;
+    replaces?: string;
+} | {
+    action: 'relate';
+    from: string;
+    type: string;
+    to?: string;
+    toKind: string;
+    move?: true;
+};
+/** The placeholder a Next line prints for an entry of `kind` it cannot name: key_result reads <KEY-RESULT-ID>. */
+export declare function spineKindPlaceholder(kind: string): string;
+/** Every spineNext a refusal's details carry, in order: one Next line each (TASK-1163: a close names the replace and the re-home). */
+export declare function spineNextsOf(details: readonly unknown[] | undefined): SpineNext[];
+export declare const SPINE_RUNG_SEQUENCE: readonly SpineRungSpec[];
+//# sourceMappingURL=spineRungs.d.ts.map

package/dist/lib/spineRungs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spineRungs.d.ts","sourceRoot":"","sources":["../../src/lib/spineRungs.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AACvF,MAAM,MAAM,YAAY,GACrB,oBAAoB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAE3H;kFACkF;AAClF,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAE9F,kHAAkH;AAClH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,sIAAsI;AACtI,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAEjF;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAMvD,CAAC"}

package/dist/lib/spineRungs.js

@@ -0,0 +1,19 @@
+// GENERATED by scripts/generate-mcp-embedded-copies.mjs from kernel/strategy/spineRungs.ts.
+// DO NOT EDIT. Run `npm run mcp:embedded-copies` to regenerate.
+// Local runtime copy for the isolated connector build.
+/** The placeholder a Next line prints for an entry of `kind` it cannot name: key_result reads <KEY-RESULT-ID>. */
+export function spineKindPlaceholder(kind) {
+    return `<${kind.toUpperCase().replace(/_/g, '-')}-ID>`;
+}
+/** Every spineNext a refusal's details carry, in order: one Next line each (TASK-1163: a close names the replace and the re-home). */
+export function spineNextsOf(details) {
+    return (details ?? []).map((d) => d?.spineNext).filter((n) => Boolean(n));
+}
+export const SPINE_RUNG_SEQUENCE = [
+    { relationType: 'validates', targetKey: 'key_result', gapIfMissing: 'key_result_missing' },
+    { relationType: 'part_of', targetKey: 'objective', gapIfMissing: 'objective_missing' },
+    { relationType: 'part_of', targetKey: 'strategy', gapIfMissing: 'strategy_missing' },
+    { relationType: 'part_of', targetKey: 'vision', gapIfMissing: 'vision_missing' },
+    { relationType: 'part_of', targetKey: 'purpose', gapIfMissing: 'purpose_missing' },
+];
+//# sourceMappingURL=spineRungs.js.map

package/dist/lib/spineRungs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spineRungs.js","sourceRoot":"","sources":["../../src/lib/spineRungs.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,gEAAgE;AAChE,uDAAuD;AAoCvD,kHAAkH;AAClH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAChD,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;AACxD,CAAC;AAED,sIAAsI;AACtI,MAAM,UAAU,YAAY,CAAC,OAAuC;IACnE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAsC,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACjI,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAA6B;IAC5D,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE;IAC1F,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE;IACtF,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE;IACpF,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE;IAChF,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE;CAClF,CAAC"}

package/dist/lib/spineVerdictRead.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Read contract for the append-only spine verdict payload (stored as unknown).
+ * This validates display data, never regrades the spine. Original producers always wrote
+ * noSpineEntries; newer connectivity/truncation fields may be absent on historical rows.
+ * Dependency-free: the existing embedded-copy generator ships this same source to both
+ * isolated connectors. Edit here, then run `npm run mcp:embedded-copies`.
+ */
+export interface SpineStructuralRead {
+    passed: boolean;
+    missing: string[];
+    duplicateSingletons: {
+        purpose: string[] | null;
+        vision: string[] | null;
+    };
+    unconnectedStrategyIds: string[];
+    visionConnectedToPurpose: boolean | null;
+    strategiesWithUnknownConnectivity?: string[] | null;
+    visionPurposeConnectivityTruncated?: boolean;
+    unconnectedObjectiveIds?: string[] | null;
+    objectivesWithUnknownConnectivity?: string[] | null;
+    unconnectedKeyResultIds?: string[] | null;
+    keyResultsWithUnknownConnectivity?: string[] | null;
+    /** Current work packages with no live key result and the past key results each still validates; absent on older rows. */
+    strandedWorkPackages?: Array<{
+        id: string;
+        pastTargetIds: string[];
+    }> | null;
+}
+export interface SpineStrategyRead {
+    entryId: string;
+    refusal: {
+        hasRefusalSignal: boolean;
+    };
+    rogerMartin: {
+        isStrategicChoice: boolean;
+        reasoning: string;
+    } | null;
+}
+export interface SpineStoryRead {
+    passed: boolean;
+    failedCriterion: string | null;
+    criteria: Array<{
+        id: string;
+        passed: boolean;
+        reasoning: string;
+    }>;
+}
+export interface GradedSpineVerdict {
+    noSpineEntries: false;
+    structural: SpineStructuralRead;
+    perStrategy: SpineStrategyRead[];
+    story: SpineStoryRead | null;
+    strategiesTruncated?: boolean;
+    perStrategyEvaluationTruncated?: boolean;
+    objectivesTruncated?: boolean;
+    keyResultsTruncated?: boolean;
+    workPackagesTruncated?: boolean;
+}
+export type SpineVerdictRead = {
+    kind: 'malformed';
+} | {
+    kind: 'empty';
+} | {
+    kind: 'graded';
+    verdict: GradedSpineVerdict;
+};
+/** Branch on the original discriminant before touching optional graded data. */
+export declare function readSpineVerdict(value: unknown): SpineVerdictRead;
+/** A capped membership read preserves positive evidence, never infers removals by absence.
+ *  PRRT_kwDORS4ils6iIj0V: `relationsChanged` is a KNOWN, detected connectivity change (a
+ *  part_of edge added or removed — computeSpineVerdictStaleness's relations-fingerprint
+ *  mismatch), never an "unknown" scan outcome — it must render as its own reason, not fall into
+ *  the generic unknown-count branch below (which is reserved for a genuinely unresolved case:
+ *  a pre-migration row with no fingerprint to compare, or a legacy-rule regrade). */
+export declare function describeSpineStaleness(changedMemberCount: number, membershipTruncated?: boolean, relationsChanged?: boolean): string;
+//# sourceMappingURL=spineVerdictRead.d.ts.map

package/dist/lib/spineVerdictRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spineVerdictRead.d.ts","sourceRoot":"","sources":["../../src/lib/spineVerdictRead.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mBAAmB,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IAC3E,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,wBAAwB,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,iCAAiC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpD,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1C,iCAAiC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpD,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1C,iCAAiC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpD,yHAAyH;IACzH,oBAAoB,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,gBAAgB,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,WAAW,EAAE;QAAE,iBAAiB,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,kBAAkB;IAClC,cAAc,EAAE,KAAK,CAAC;IACtB,UAAU,EAAE,mBAAmB,CAAC;IAChC,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,gBAAgB,GACzB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAyCnD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAWjE;AAGD;;;;;qFAKqF;AACrF,wBAAgB,sBAAsB,CAAC,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,UAAQ,EAAE,gBAAgB,UAAQ,GAAG,MAAM,CAShI"}