@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.14010

package/dist/commands/brief.js

@@ -11,33 +11,31 @@
  * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand } from '../lib/runner.js';
 import { formatBrief, formatCompoundBrief, } from '../formatters/brief.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
 const COMPOUND_TYPES = ['steering', 'confidence', 'delta'];
 function isCompoundType(value) {
     return COMPOUND_TYPES.includes(value);
 }
 /** Run incremental brief for a skill (existing E4 behavior). */
 export async function runBrief(options) {
-    const config = await getConfigOrGuide(() => runBrief(options));
-    if (!config)
-        return;
+    await getConfigOrGuide();
     await runCliCommand({
         fn: async () => {
-            const result = await mcpCall('chain.incrementalChanges', {
+            const result = await kernelCall('chain.incrementalChanges', {
                 skill: options.skill,
             });
-            // Record the brief run so the next call sees an updated "since last brief" timestamp.
+            // Record the brief run so the next call sees an updated "since last brief" time (the server stamps it).
             // Fire-and-forget: recording failure should not block the CLI output.
             const surfacedIds = result.newEntries
                 .map((e) => e.entryId)
                 .filter((id) => id !== null);
-            mcpCall('chain.recordBriefRun', {
+            kernelCall('chain.recordBriefRun', {
                 skill: options.skill,
                 entriesSurfaced: surfacedIds,
-                timestamp: Date.now(),
-            }).catch(() => { });
+            }, { retryOnRateLimit: false }).catch(() => { });
             return result;
         },
         formatPretty: (result) => formatBrief(result, options.skill),
@@ -45,9 +43,7 @@ export async function runBrief(options) {
 }
 /** Run compound brief query (E6 — steering, confidence, delta). */
 export async function runCompoundBrief(options) {
-    const config = await getConfigOrGuide(() => runCompoundBrief(options));
-    if (!config)
-        return;
+    await getConfigOrGuide();
     await runCliCommand({
         fn: async () => {
             const args = {
@@ -57,11 +53,37 @@ export async function runCompoundBrief(options) {
             if (options.type === 'delta' && options.since) {
                 const sinceMs = Date.parse(options.since);
                 if (isNaN(sinceMs)) {
-                    throw new Error(`Invalid --since timestamp: '${options.since}'. Use ISO 8601 format (e.g. '2026-03-24T00:00:00Z').`);
+                    throw new CLIError(`Invalid --since timestamp: '${options.since}'.`, {
+                        code: ErrorCode.VALIDATION_FAILED,
+                        category: 'validation',
+                        guidance: `Use ISO 8601 format (e.g. '2026-03-24T00:00:00Z').`,
+                    });
                 }
                 args.since = sinceMs;
             }
-            return await mcpCall('chain.compoundQuery', args);
+            // `chain.compoundQuery`'s server handler deliberately declares `Promise<Record<string,
+            // unknown>>` — it dispatches to one of three genuinely different shapes (steering/
+            // confidence/delta) based on the `type` arg the caller itself supplied, so the caller
+            // already knows the real shape (PR #398, Lane C S3c annotation pass).
+            const raw = (await kernelCall('chain.compoundQuery', args));
+            // PR #911 review (Codex P1), re-verified at 1d-B (this slice, DEC-1690): the producer
+            // (workspaceReadiness.ts) no longer returns score/totalChecks/passedChecks/scoringVersion
+            // at all, but this rebuild stays load-bearing regardless — the CLI-local `ReadinessResult`
+            // mirror type (packages/cli/src/formatters/brief.ts, frozen spec A9 §7) deliberately
+            // declares only `sampleTruncated`/`checks`/`gaps`, dropping `stage`/`layers`/
+            // `resolvedSettings`/`stats`/`governanceMode` too. Narrowing the
+            // formatter's TYPE to ReadinessResult never strips undeclared fields from `--json` /
+            // PB_JSON=1 output, which serializes this runtime object directly — rebuild it to the
+            // declared shape here.
+            if (raw.type === 'steering' && raw.readiness && typeof raw.readiness === 'object') {
+                const r = raw.readiness;
+                raw.readiness = {
+                    ...(typeof r.sampleTruncated === 'boolean' ? { sampleTruncated: r.sampleTruncated } : {}),
+                    checks: r.checks,
+                    gaps: r.gaps,
+                };
+            }
+            return raw;
         },
         formatPretty: (result) => formatCompoundBrief(result),
     });

package/dist/commands/brief.js.map

@@ -1 +1 @@
-{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/commands/brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,WAAW,EACX,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAU,CAAC;AAGpE,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AACxD,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAA+C;IAC5E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAc;QAC/B,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,MAAM,GAAG,MAAM,OAAO,CAAc,0BAA0B,EAAE;gBACpE,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;YAEH,sFAAsF;YACtF,sEAAsE;YACtE,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;iBACrB,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;YAC7C,OAAO,CAAC,sBAAsB,EAAE;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,eAAe,EAAE,WAAW;gBAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAGtC;IACC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAsB;QACvC,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,IAAI,GAA4B;gBACpC,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC;YAEF,2CAA2C;YAC3C,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CACb,+BAA+B,OAAO,CAAC,KAAK,uDAAuD,CACpG,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;YACvB,CAAC;YAED,OAAO,MAAM,OAAO,CAAsB,qBAAqB,EAAE,IAAI,CAAC,CAAC;QACzE,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/commands/brief.ts"],"names":[],"mappings":"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"}

package/dist/commands/capture.d.ts

@@ -1,20 +1,32 @@
 /**
- * pb capture — write knowledge to the Chain during a CLI session.
- * Calls resolveCollection (classification) → createEntry (draft).
- * Shows rich receipt per FEAT-126 (capture receipts with correction affordance).
- * Requires active session (DEC-9, BR-8).
- * BET-181 Slice 0: uses isJsonMode() for output branching. Existing --json flag
- * is preserved for backward compatibility (it sets output mode via the runner).
+ * The CLI capture command: write knowledge to the Chain during a CLI session (DEC-9, BR-8: needs a session).
+ * TASK-894 (DEC-2113): one request. chain.createEntry routes the "DEC: " prefix or --entry-type,
+ * classifies, judges, checks the WHY and records the grounding outcome itself; this command sends
+ * the capture and renders the reply (FEAT-126 receipt; --json per DEC-299).
  */
 interface CaptureOptions {
     text: string;
     name?: string;
     description?: string;
     collection?: string;
-    link?: string;
-    type?: string;
+    /** TASK-897 (DEC-2113): repeatable, paired by position with --link-type; the pairs ride in the one request as links[]. */
+    link?: string[];
+    /** WP-688 S4 (element 11): one per --link, no default ever; a --link without its type is refused before anything is sent. */
+    linkType?: string[];
+    /** BET-240 E2: source provenance — reference URI (e.g. "meeting-2026-03-28.md") + verbatim excerpt. */
+    sourceRef?: string;
+    sourceExcerpt?: string;
+    draft?: boolean;
     /** @deprecated Use global --json flag instead. Preserved for backward compatibility. */
     json?: boolean;
+    /** Generic data field passthrough: --field key=value, repeatable. */
+    field?: string[];
+    /** WP-513: explicit role to create AS OWNER of (rung 2). WP-753 O1b: ownerTeam is deleted — the server takes the team you hold the role in (root first, else the shallowest). */
+    ownerRole?: string;
+    /** TASK-681 (DEC-1976, DEC-1977): a role's home team or a team's parent, by ID or entryId; the server defaults to the root. */
+    team?: string;
+    /** WP-684 TASK-77 (E1.3): one-step typed create — forwards to chain.createEntry's `canonicalKey` arg. */
+    entryType?: string;
 }
 export declare function runCapture(options: CaptureOptions): Promise<void>;
 export {};

package/dist/commands/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4FvE"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0HAA0H;IAC1H,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,6HAA6H;IAC7H,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iLAAiL;IACjL,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+HAA+H;IAC/H,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yGAAyG;IACzG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJvE"}

package/dist/commands/capture.js

@@ -1,100 +1,164 @@
 /**
- * pb capture — write knowledge to the Chain during a CLI session.
- * Calls resolveCollection (classification) → createEntry (draft).
- * Shows rich receipt per FEAT-126 (capture receipts with correction affordance).
- * Requires active session (DEC-9, BR-8).
- * BET-181 Slice 0: uses isJsonMode() for output branching. Existing --json flag
- * is preserved for backward compatibility (it sets output mode via the runner).
+ * The CLI capture command: write knowledge to the Chain during a CLI session (DEC-9, BR-8: needs a session).
+ * TASK-894 (DEC-2113): one request. chain.createEntry routes the "DEC: " prefix or --entry-type,
+ * classifies, judges, checks the WHY and records the grounding outcome itself; this command sends
+ * the capture and renders the reply (FEAT-126 receipt; --json per DEC-299).
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCallWithSession } from '../lib/client.js';
+import { kernelCallWithSession } from '../lib/client.js';
 import { readSession, addCapturedEntry } from '../lib/session.js';
-import { isJsonMode } from '../lib/runner.js';
+import { isJsonMode, setOutputMode } from '../lib/runner.js';
 import { formatCaptureReceipt } from '../formatters/capture.js';
+import { progress, copy } from '../lib/style.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { parseFields } from '../lib/parseFields.js';
+import { emitEffectiveTenantNotice } from '../lib/workspaceNotice.js';
+import { isPreviewCreateEntryResult } from '../lib/createEntryResult.js';
+import { pairCaptureLinks } from '../lib/captureLink.js';
+import { ENTRY_NAME_CAPS, nameCapFor } from '../lib/limits.js';
+import { deriveNameFromText } from '../lib/nameFromText.js';
 export async function runCapture(options) {
-    const config = await getConfigOrGuide(() => runCapture(options));
-    if (!config)
-        return;
-    // Support both legacy --json flag and global output mode (DEC-299, backward compat)
+    await getConfigOrGuide();
+    // Support both legacy --json flag and global output mode (DEC-299, backward compat).
+    // Propagate the local flag to global mode too — a thrown CLIError below renders via the
+    // global handler's isJsonMode(), which wouldn't otherwise see this local-only flag.
     const json = isJsonMode() || options.json === true;
+    if (options.json === true && !isJsonMode())
+        setOutputMode('json');
     // Require active session (DEC-9, BR-8)
     const session = readSession();
     if (!session) {
-        process.stderr.write('No active session. Run `pb session start` first.\n');
-        process.stderr.write('Write access requires a tracked session (DEC-9).\n');
-        process.exit(1);
-    }
-    const entryName = options.name ?? options.text;
-    const entryDescription = options.description ?? options.text;
-    // Phase 1: Resolve collection (classification)
-    let collectionSlug;
-    let classification = null;
-    if (options.collection) {
-        // Explicit collection — skip classification
-        collectionSlug = options.collection;
-    }
-    else {
-        if (!json)
-            process.stdout.write('Classifying...\n');
-        classification = await mcpCallWithSession('chain.resolveCollection', {
-            entryName,
-            entryDescription,
+        throw new CLIError(copy.noSession, {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: copy.noSessionGuidance,
         });
-        collectionSlug = classification.collection;
     }
-    // Phase 2: Create entry as draft
+    // TASK-894: the text goes as typed; the kernel strips a known "DEC: " prefix when it routes by it. TASK-1419 (DEC-2512): the
+    // name is the text's first sentence within the kind's cap (the working cap while the kind is not named, which every kind
+    // accepts); the whole text stays the body. --name wins.
+    const entryName = options.name ?? deriveNameFromText(options.text, options.collection ? nameCapFor(options.collection) : ENTRY_NAME_CAPS.working);
+    const entryDescription = options.description ?? options.text;
+    // WP-1: name the target workspace before the write so a wrong-Chain capture is never silent (stderr only, WP-721).
+    await emitEffectiveTenantNotice();
     if (!json)
-        process.stdout.write(`Capturing to ${collectionSlug}...\n`);
-    const data = { description: entryDescription };
-    // Add date for collections that use it
-    const datedCollections = ['tensions', 'decisions', 'insights', 'standards', 'business-rules'];
-    if (datedCollections.includes(collectionSlug)) {
-        data.date = new Date().toISOString().split('T')[0];
-    }
-    const result = await mcpCallWithSession('chain.createEntry', {
-        collectionSlug,
+        progress(options.collection ? `Capturing to ${options.collection}...` : 'Capturing...');
+    const callerFields = options.field?.length ? parseFields(options.field) : {};
+    const sent = (v) => typeof v === 'string' && v.trim().length > 0;
+    // TASK-622: whether the caller wrote any body text at all. TASK-894: data carries only what the caller sent; the
+    // capture text rides as `description` and the kernel files it in the main text field only when that is empty.
+    const callerSentNoBody = !sent(options.description) && !sent(callerFields.description) && !sent(callerFields.body);
+    const data = { ...(options.description !== undefined ? { description: options.description } : {}), ...callerFields };
+    // TASK-897 (DEC-2113): the --link pairs ride in this one request; the kernel judges each link in the transaction that
+    // lands the entry and answers per link. A pair the kernel could never judge is refused here, before anything is sent.
+    const links = pairCaptureLinks(options.link ?? [], options.linkType ?? []);
+    const rawResult = await kernelCallWithSession('chain.createEntry', {
+        ...(options.collection ? { collectionSlug: options.collection } : {}),
         name: entryName,
-        status: 'draft',
+        description: entryDescription, // the classifier's and the judge's text; the entry's own prose rides in data
+        // DEC-896 / BR-76: omit status — server resolves from governanceMode (Open→active, else draft).
+        // WP-456 E1 / TEN-2226: `--draft` opt-in forces 'draft' regardless of governanceMode.
+        // Omit entirely when absent so the default-path wire payload is byte-identical to today.
+        ...(options.draft ? { forceDraft: true } : {}),
         data,
         sessionId: session.sessionId,
         createdBy: `agent:${session.sessionId}`,
+        // BET-240 E2: source provenance — pass through when provided
+        ...(options.sourceRef ? { sourceRef: options.sourceRef } : {}),
+        ...(options.sourceExcerpt ? { sourceExcerpt: options.sourceExcerpt } : {}),
+        ...(links.length > 0 ? { links } : {}),
+        ...(options.ownerRole ? { ownerRoleEntryId: options.ownerRole } : {}), // WP-513 rung-2 override; WP-753 O1b: team derives server-side.
+        ...(options.entryType ? { canonicalKey: options.entryType } : {}), // WP-684 TASK-77 (E1.3): one-step typed create.
+        ...(options.team ? { teamRef: options.team } : {}), // TASK-681: a role's home team / a team's parent.
     });
-    // Track in session state
-    addCapturedEntry(result.entryId);
-    // Phase 3: Link to existing entry if --link provided (TEN-705)
-    if (options.link) {
-        const linkTarget = options.link.trim();
-        const relationType = options.type ?? 'surfaces_tension_in';
-        if (linkTarget) {
-            await mcpCallWithSession('chain.createEntryRelation', {
-                fromEntryId: result.entryId,
-                toEntryId: linkTarget,
-                type: relationType,
-            });
-        }
+    // WP-577 / TEN-2918 fallout: `pb capture` never sends `preview: true` above, so this
+    // never fires at runtime — but the declared return type is now honestly a union, so
+    // fail loudly rather than silently reading undefined preview-shaped fields below.
+    if (isPreviewCreateEntryResult(rawResult)) {
+        throw new CLIError('Unexpected preview response from chain.createEntry — pb capture never requests preview mode.', { code: ErrorCode.INTERNAL, category: 'internal' });
     }
+    // TASK-898 (DEC-2113): a re-sent capture replays the first entry and carries only its id, status and collection.
+    const replayed = 'replayed' in rawResult;
+    const result = rawResult;
+    // TASK-899: the slug the entry landed in; a replay names the one the first send landed in.
+    const shownCollection = rawResult.collection ?? '';
+    const classification = result.classification ?? null;
+    const matches = result.verdict?.kind === 'ask' ? result.verdict.matches : [];
+    const entryId = result.entryId;
+    const entryStatus = result.status;
+    const warnings = [...(result.warnings ?? []), ...(result.orgCheck ?? [])]; // a saved role's org check lines
+    const normalization = result.normalization;
+    const qualityHints = result.qualityHints ?? [];
+    const spineFloor = result.spineFloor;
+    const coaching = result.coaching;
+    // TASK-897: one outcome per link sent, in the kernel's words; a replay answers them from the rows (TASK-896).
+    const linkOutcomes = rawResult.links ?? [];
+    const missingFieldLines = result.missingFieldLines ?? [];
+    // Track in session state.
+    addCapturedEntry(entryId);
+    // TASK-608 (TEN-4298, DEC-1915): the first-capture "how it connects" list is deleted — it named
+    // active work packages the capture was never linked to.
+    // BET-271 S1: Determine if any fields were rejected by normalization.
+    // TASK-584 (WP-802, TEN-4312): the write has already landed here, so a dropped field is a
+    // warning on the reply and the command exits 0 — never a "Fields rejected" error after success.
+    // The kernel's own "Unknown fields dropped: …" line rides in `warnings`; the CLI only adds where
+    // to look (RULE-128).
+    const rejectedFields = normalization?.rejected ?? [];
+    const hasRejected = rejectedFields.length > 0;
     // Output
     if (json) {
-        // Machine-readable output (TEN-709, DEC-299)
-        process.stdout.write(JSON.stringify({
-            id: result.entryId,
-            collection: collectionSlug,
-            confidence: classification?.tier ?? 'explicit',
-        }) + '\n');
+        // Machine-readable output (TEN-709, DEC-299).
+        const output = { id: entryId, collection: shownCollection, status: entryStatus, confidence: classification?.tier ?? 'explicit', ...(replayed ? { replayed } : {}) };
+        // TASK-619: an ask names its close matches for automated callers too, so they can update one deliberately.
+        if (matches.length > 0)
+            output.possibleMatches = matches.map((m) => ({ entryId: m.entryId, name: m.name, collection: m.collectionSlug, score: m.score }));
+        if (hasRejected) {
+            output.fieldsRejected = true;
+            output.droppedFields = rejectedFields;
+        }
+        // WP-475 E1: raw heuristic coaching verdict in machine output (BR-144: advisory); the one verdict already saw the links.
+        if (coaching) {
+            output.coaching = coaching;
+        }
+        if (linkOutcomes.length > 0)
+            output.links = linkOutcomes; // TASK-897: the kernel's outcome per link, never guessed
+        if (spineFloor)
+            output.spineFloor = spineFloor;
+        if (missingFieldLines.length > 0)
+            output.missingFieldLines = missingFieldLines;
+        if (warnings && warnings.length > 0)
+            output.warnings = warnings; // TASK-800: the kernel's sentences (e.g. the unscoped-strategy pool) for automated callers too
+        if (result.held)
+            output.held = result.held; // TASK-736 (DEC-2019): the sentence and atoms, for automated callers
+        if (result.judged !== undefined)
+            Object.assign(output, { verdict: result.verdict, judged: result.judged }); // TASK-899: the kernel's own judge
+        process.stdout.write(JSON.stringify(output) + '\n');
     }
     else {
         process.stdout.write('\n');
         process.stdout.write(formatCaptureReceipt({
-            entryId: result.entryId,
+            entryId,
             name: entryName,
-            collection: collectionSlug,
-            status: 'draft',
+            collection: shownCollection,
+            statusLabel: rawResult.statusLabel, // TASK-889: the kernel's word, on a replay too
             classification,
-            warnings: result.warnings,
-            normalization: result.normalization,
-            linkedTo: options.link,
-            relationType: options.link ? (options.type ?? 'surfaces_tension_in') : undefined,
+            warnings,
+            normalization: normalization ?? undefined,
+            links: linkOutcomes,
+            qualityHints,
+            coaching,
+            spineFloor,
+            missingFieldLines,
+            callerSentNoBody,
         }) + '\n');
+        // TASK-619 / TASK-899: the kernel judged before the write; a close match is named, never written to.
+        const named = matches.slice(0, 3).map((m) => `${m.entryId} "${m.name}"`).join(', ');
+        if (named)
+            process.stderr.write(`\n  Possible match: ${named}. Nothing was written to it; to change it, run pb update <ID>.\n`);
+        else if (result.judged === false)
+            process.stderr.write(`\n  The duplicate check is still running; pb get ${entryId} shows any close match it finds.\n`);
+        if (replayed)
+            process.stdout.write(`Already captured as ${entryId}; this re-send wrote no second entry.\n`);
     }
 }
 //# sourceMappingURL=capture.js.map

package/dist/commands/capture.js.map

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

package/dist/commands/chain-walk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-walk.d.ts","sourceRoot":"","sources":["../../src/commands/chain-walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}
+{"version":3,"file":"chain-walk.d.ts","sourceRoot":"","sources":["../../src/commands/chain-walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB"}

package/dist/commands/chain-walk.js

@@ -6,22 +6,25 @@
  * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand } from '../lib/runner.js';
 import { formatChainWalk } from '../formatters/chain-walk.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
 export async function runChainWalk(options) {
-    const config = await getConfigOrGuide(() => runChainWalk(options));
-    if (!config)
-        return;
+    await getConfigOrGuide();
     const { entryId, depth, direction, type } = options;
     // Validate direction
     if (direction !== 'outgoing' && direction !== 'incoming') {
-        throw new Error(`Invalid direction: "${direction}". Must be 'outgoing' or 'incoming'.`);
+        throw new CLIError(`Invalid direction: "${direction}".`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: `Must be 'outgoing' or 'incoming'.`,
+        });
     }
     // Validate depth
     const clampedDepth = Math.max(1, Math.min(4, depth));
     await runCliCommand({
-        fn: () => mcpCall('chain.deepChainWalk', {
+        fn: () => kernelCall('chain.deepChainWalk', {
             entryId,
             direction,
             maxHops: clampedDepth,

package/dist/commands/chain-walk.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain-walk.js","sourceRoot":"","sources":["../../src/commands/chain-walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAwB,MAAM,6BAA6B,CAAC;AAEpF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAKlC;IACC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEpD,qBAAqB;IACrB,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,uBAAuB,SAAS,sCAAsC,CAAC,CAAC;IAC1F,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAErD,MAAM,aAAa,CAAkB;QACnC,EAAE,EAAE,GAAG,EAAE,CACP,OAAO,CAAkB,qBAAqB,EAAE;YAC9C,OAAO;YACP,SAAS;YACT,OAAO,EAAE,YAAY;YACrB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC;KAC1F,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"chain-walk.js","sourceRoot":"","sources":["../../src/commands/chain-walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAwB,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAKlC;IACC,MAAM,gBAAgB,EAAE,CAAC;IAEzB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEpD,qBAAqB;IACrB,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACzD,MAAM,IAAI,QAAQ,CAAC,uBAAuB,SAAS,IAAI,EAAE;YACvD,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,mCAAmC;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAErD,MAAM,aAAa,CAAkB;QACnC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAAkD,qBAAqB,EAAE;YACjF,OAAO;YACP,SAAS;YACT,OAAO,EAAE,YAAY;YACrB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC;KAC1F,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/changes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/commands/changes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB1E"}
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/commands/changes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB1E"}

package/dist/commands/changes.js

@@ -6,9 +6,10 @@
  * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand } from '../lib/runner.js';
 import { formatChanges } from '../formatters/changes.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
 /** Parse a human-friendly duration string into milliseconds. */
 function parseDuration(input) {
     const match = input.match(/^(\d+)(h|d)$/i);
@@ -23,16 +24,18 @@ function parseDuration(input) {
     return null;
 }
 export async function runChanges(options) {
-    const config = await getConfigOrGuide(() => runChanges(options));
-    if (!config)
-        return;
+    await getConfigOrGuide();
     const durationMs = parseDuration(options.since);
     if (durationMs === null) {
-        throw new Error(`Invalid duration: "${options.since}". Use format: 1h, 6h, 1d, 7d, 30d (numeric + h/d suffix).`);
+        throw new CLIError(`Invalid duration: "${options.since}".`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Use format: 1h, 6h, 1d, 7d, 30d (numeric + h/d suffix).',
+        });
     }
     const sinceTimestamp = Date.now() - durationMs;
     await runCliCommand({
-        fn: () => mcpCall('chain.changeDetection', {
+        fn: () => kernelCall('chain.changeDetection', {
             since: sinceTimestamp,
         }),
         formatPretty: (result) => formatChanges(result, options.since),

package/dist/commands/changes.js.map

@@ -1 +1 @@
-{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../src/commands/changes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAE7E,gEAAgE;AAChE,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IAC3C,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,GAAG,UAAU,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACzD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sBAAsB,OAAO,CAAC,KAAK,4DAA4D,CAChG,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;IAE/C,MAAM,aAAa,CAAgB;QACjC,EAAE,EAAE,GAAG,EAAE,CACP,OAAO,CAAgB,uBAAuB,EAAE;YAC9C,KAAK,EAAE,cAAc;SACtB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../src/commands/changes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,gEAAgE;AAChE,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IAC3C,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,GAAG,UAAU,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACzD,MAAM,gBAAgB,EAAE,CAAC;IAEzB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAChB,sBAAsB,OAAO,CAAC,KAAK,IAAI,EACvC;YACE,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,yDAAyD;SACpE,CACF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;IAE/C,MAAM,aAAa,CAAgB;QACjC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAAoD,uBAAuB,EAAE;YACrF,KAAK,EAAE,cAAc;SACtB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/codex-prep.d.ts

@@ -0,0 +1,23 @@
+/**
+ * pb codex-prep — pre-bake task-specific governance context for Codex.
+ * Generates .codex/task-context.md with orient view formatted for offline agents.
+ */
+import { type OrientViewFromApi } from './orient.js';
+export interface CodexPrepOptions {
+    task: string;
+    dryRun?: boolean;
+    full?: boolean;
+}
+export declare function runCodexPrep(options: CodexPrepOptions): Promise<void>;
+/**
+ * Format the `.codex/task-context.md` body. Routes the raw API view through the
+ * SAME `normalizeView` → `formatOrient` path `pb orient` uses (via `formatOrientCodex`),
+ * so Codex receives identical governance to the interactive surface.
+ *
+ * The prior bespoke formatter silently dropped binding governance, the grounding-stub
+ * ⚠️ warning, supporting context, absence signals, provenance marks, and the budget
+ * header — the exact governance Codex needs. Reusing the canonical formatter closes
+ * that hole and prevents future drift.
+ */
+export declare function formatCodexTaskContext(view: OrientViewFromApi, task: string): string;
+//# sourceMappingURL=codex-prep.d.ts.map

package/dist/commands/codex-prep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-prep.d.ts","sourceRoot":"","sources":["../../src/commands/codex-prep.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpF"}

package/dist/commands/codex-prep.js

@@ -0,0 +1,54 @@
+/**
+ * pb codex-prep — pre-bake task-specific governance context for Codex.
+ * Generates .codex/task-context.md with orient view formatted for offline agents.
+ */
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { normalizeView } from './orient.js';
+import { formatOrientCodex } from '../formatters/orient.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+export async function runCodexPrep(options) {
+    await getConfigOrGuide();
+    const cwd = process.cwd();
+    const task = options.task.trim();
+    if (!task) {
+        throw new CLIError('Task description is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb codex-prep <task description>',
+        });
+    }
+    process.stderr.write(`Fetching governance context for: "${task}"...\n`);
+    const orientView = await kernelCall('chain.getOrientView', {
+        task,
+        tier: options.full ? 'full' : 'standard',
+    });
+    const content = formatCodexTaskContext(orientView, task);
+    if (options.dryRun) {
+        process.stdout.write(content);
+        return;
+    }
+    const codexDir = join(cwd, '.codex');
+    const outPath = join(codexDir, 'task-context.md');
+    mkdirSync(codexDir, { recursive: true });
+    writeFileSync(outPath, content);
+    process.stderr.write(`Written: .codex/task-context.md\n`);
+    process.stderr.write(`Tip: Reference this file in your Codex task prompt.\n`);
+}
+/**
+ * Format the `.codex/task-context.md` body. Routes the raw API view through the
+ * SAME `normalizeView` → `formatOrient` path `pb orient` uses (via `formatOrientCodex`),
+ * so Codex receives identical governance to the interactive surface.
+ *
+ * The prior bespoke formatter silently dropped binding governance, the grounding-stub
+ * ⚠️ warning, supporting context, absence signals, provenance marks, and the budget
+ * header — the exact governance Codex needs. Reusing the canonical formatter closes
+ * that hole and prevents future drift.
+ */
+export function formatCodexTaskContext(view, task) {
+    const normalized = normalizeView(view);
+    return formatOrientCodex(normalized, task);
+}
+//# sourceMappingURL=codex-prep.js.map

package/dist/commands/codex-prep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-prep.js","sourceRoot":"","sources":["../../src/commands/codex-prep.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAA0B,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,MAAM,gBAAgB,EAAE,CAAC;IAEzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAEjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,QAAQ,CAAC,+BAA+B,EAAE;YAClD,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,yCAAyC;SACpD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,IAAI,QAAQ,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,MAAM,UAAU,CAAkD,qBAAqB,EAAE;QAC1G,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;KACzC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEzD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAClD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAuB,EAAE,IAAY;IAC1E,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}