@productbrain/cli 0.1.0-beta.15 → 0.1.0-beta.1522

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

@@ -5,6 +5,7 @@
  * 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).
+ * WP-319 S3: Pre-write grounding via chain.suggestLinksForCapture (advisory, fail-open).
  */
 interface CaptureOptions {
     text: string;
@@ -17,8 +18,14 @@ interface CaptureOptions {
     sourceRef?: string;
     /** BET-240 E2: Verbatim excerpt from the source. */
     sourceExcerpt?: string;
+    /** WP-456 E1 / TEN-2226: force the entry to draft regardless of workspace governanceMode. */
+    draft?: boolean;
     /** @deprecated Use global --json flag instead. Preserved for backward compatibility. */
     json?: boolean;
+    /** WP-319 S3: Show grounding preview without creating entry. */
+    suggestOnly?: boolean;
+    /** WP-319 S3: Prompt y/N before creating when a possible_duplicate is found. */
+    strict?: boolean;
 }
 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,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+FvE"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2FH,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,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgID,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmPvE"}

package/dist/commands/capture.js

@@ -5,12 +5,123 @@
  * 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).
+ * WP-319 S3: Pre-write grounding via chain.suggestLinksForCapture (advisory, fail-open).
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCallWithSession } from '../lib/client.js';
+import { kernelCallWithSession } from '../lib/client.js';
+import { inferSourceDate } from '../lib/inferSourceDate.js';
+import { getPrefixToCollection, getDatedCollections } from '../lib/collectionRegistry.js';
 import { readSession, addCapturedEntry } from '../lib/session.js';
 import { isJsonMode } from '../lib/runner.js';
 import { formatCaptureReceipt } from '../formatters/capture.js';
+import { checkActivation } from '../lib/activation.js';
+import { progress } from '../lib/style.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+/**
+ * Known entry ID prefix → collection slug mapping.
+ * FEAT-885: prefix routing now derived from collectionRegistry at runtime.
+ */
+/**
+ * Extract a known ID prefix hint from capture text.
+ * Pattern: "FLO: description" or "TEN: something broken" — prefix must be uppercase,
+ * followed by colon and optional whitespace, then the actual text.
+ * Returns the resolved collection slug and the cleaned text (prefix stripped).
+ */
+function extractPrefixHint(text, prefixMap) {
+    const match = text.match(/^([A-Z]{2,4}):\s*(.+)$/s);
+    if (!match)
+        return { resolvedCollection: null, cleanText: text };
+    const [, prefix, rest] = match;
+    const slug = prefixMap[prefix];
+    if (!slug)
+        return { resolvedCollection: null, cleanText: text };
+    return { resolvedCollection: slug, cleanText: rest.trim() };
+}
+// WP-319 S3: Grounding helpers — advisory output, stderr only.
+/** Print advisory grounding banner to stderr. Suppressed when grounding has no matches. */
+function printGroundingBanner(grounding) {
+    const possibleDuplicates = grounding.duplicates.filter((d) => d.matchType === 'possible_duplicate');
+    const related = [
+        ...grounding.related,
+        ...grounding.duplicates.filter((d) => d.matchType === 'related'),
+    ];
+    const governance = grounding.governance ?? [];
+    const hasGovernance = governance.length > 0;
+    if (possibleDuplicates.length === 0 && related.length === 0 && !hasGovernance) {
+        return; // Zero-noise floor: nothing to show
+    }
+    const lines = ['\n  Grounding:'];
+    if (possibleDuplicates.length > 0) {
+        const label = possibleDuplicates.length === 1 ? 'Possible duplicate' : 'Possible duplicates';
+        const items = possibleDuplicates.map((d) => `${d.entryId} "${d.name}"`).join(', ');
+        lines.push(`  ⚠ ${label}: ${items}`);
+    }
+    if (related.length > 0) {
+        const items = related
+            .slice(0, 3)
+            .map((r) => `${r.entryId} "${r.name}"`)
+            .join(', ');
+        lines.push(`  ~ Related: ${items}`);
+    }
+    for (const gov of governance) {
+        const icon = gov.severity === 'block' ? '✗' : gov.severity === 'warn' ? '⚠' : 'ℹ';
+        lines.push(`  ${icon} Governance [${gov.severity}]: ${gov.entryId} "${gov.name}"`);
+    }
+    lines.push('');
+    process.stderr.write(lines.join('\n') + '\n');
+}
+/** Print dry-run grounding preview to stdout (--suggest-only). */
+function printGroundingPreview(grounding, entryName, collectionSlug) {
+    process.stdout.write(`\n  Grounding preview for: ${entryName.slice(0, 80)}\n`);
+    process.stdout.write(`  Collection: ${collectionSlug}\n\n`);
+    if (!grounding) {
+        process.stdout.write('  No grounding data available (timeout or unavailable).\n\n');
+        return;
+    }
+    const possibleDuplicates = grounding.duplicates.filter((d) => d.matchType === 'possible_duplicate');
+    const related = [
+        ...grounding.related,
+        ...grounding.duplicates.filter((d) => d.matchType === 'related'),
+    ];
+    const govCandidates = grounding.governance ?? [];
+    if (possibleDuplicates.length === 0 && related.length === 0 && govCandidates.length === 0) {
+        process.stdout.write('  No matches found — capture looks unique.\n\n');
+        return;
+    }
+    if (possibleDuplicates.length > 0) {
+        process.stdout.write('  Possible duplicates:\n');
+        for (const d of possibleDuplicates) {
+            process.stdout.write(`    · ${d.entryId} "${d.name}" (overlap: ${Math.round(d.overlapRatio * 100)}%)\n`);
+        }
+        process.stdout.write('\n');
+    }
+    if (related.length > 0) {
+        process.stdout.write('  Related entries:\n');
+        for (const r of related.slice(0, 5)) {
+            const relType = 'recommendedRelationType' in r ? r.recommendedRelationType : 'related';
+            process.stdout.write(`    · ${r.entryId} "${r.name}" → ${relType}\n`);
+        }
+        process.stdout.write('\n');
+    }
+    if (govCandidates.length > 0) {
+        process.stdout.write('  Governance:\n');
+        for (const g of govCandidates) {
+            process.stdout.write(`    · [${g.severity}] ${g.entryId} "${g.name}"\n`);
+        }
+        process.stdout.write('\n');
+    }
+    process.stdout.write('  Run without --suggest-only to create the entry.\n\n');
+}
+/** Prompt the user with a y/N question. Resolves true for "y", false otherwise. */
+async function promptYN(message) {
+    return new Promise((resolve) => {
+        process.stderr.write(message);
+        process.stdin.once('data', (data) => {
+            const answer = data.toString().trim().toLowerCase();
+            resolve(answer === 'y');
+        });
+    });
+}
 export async function runCapture(options) {
     const config = await getConfigOrGuide(() => runCapture(options));
     if (!config)
@@ -20,12 +131,38 @@ export async function runCapture(options) {
     // 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);
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            // DEC-9
+            guidance: 'Run `pb session start` first. Write access requires a tracked session.',
+        });
     }
-    const entryName = options.name ?? options.text;
-    const entryDescription = options.description ?? options.text;
+    // BET-277 fix: Extract known ID prefix hints (e.g. "FLO: description" → collection=flows).
+    // When the user explicitly prefixes with a known entry ID prefix, treat it as a collection
+    // override — strip the prefix from the name and route directly. No classification needed.
+    // FEAT-885: prefix map derived from collectionRegistry (runtime DB query, fail-open to SEED).
+    const prefixMap = await getPrefixToCollection();
+    const { resolvedCollection: prefixCollection, cleanText } = extractPrefixHint(options.text, prefixMap);
+    const entryName = options.name ?? cleanText;
+    const entryDescription = options.description ?? cleanText;
+    // WP-319 S3: Phase 1.5 — Pre-write grounding (advisory, fail-open).
+    // Start the grounding call IN PARALLEL with collection resolution so it
+    // does not add serial latency.
+    // Normal capture: 300ms post-classification cap (classification latency = free parallel time).
+    // --suggest-only: 2000ms absolute cap from grounding start (user explicitly waiting for data).
+    const GROUNDING_TIMEOUT_MS = 300;
+    const GROUNDING_SUGGEST_ONLY_TOTAL_MS = 2000;
+    const groundingStart = Date.now();
+    const skipGrounding = process.env.PB_GROUNDING_MODE === 'off';
+    let groundingResult = null;
+    const groundingPromise = (!skipGrounding && (entryName || entryDescription))
+        ? kernelCallWithSession('chain.suggestLinksForCapture', {
+            entries: [{ name: entryName, description: entryDescription, collectionHint: options.collection ?? '' }],
+            limit: 5,
+            threshold: 2,
+        }).then((res) => (Array.isArray(res) ? res[0] ?? null : null)).catch(() => null)
+        : Promise.resolve(null);
     // Phase 1: Resolve collection (classification)
     let collectionSlug;
     let classification = null;
@@ -33,28 +170,82 @@ export async function runCapture(options) {
         // Explicit collection — skip classification
         collectionSlug = options.collection;
     }
+    else if (prefixCollection) {
+        // Prefix hint detected (e.g. "FLO:" → flows) — treat as explicit collection
+        collectionSlug = prefixCollection;
+    }
     else {
         if (!json)
-            process.stdout.write('Classifying...\n');
-        classification = await mcpCallWithSession('chain.resolveCollection', {
+            progress('Classifying...');
+        classification = await kernelCallWithSession('chain.resolveCollection', {
             entryName,
             entryDescription,
         });
+        if (!classification) {
+            throw new CLIError('Classification needs review before capture can continue.', {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Re-run with `--collection <slug>` to specify the collection explicitly.',
+            });
+        }
         collectionSlug = classification.collection;
     }
+    // WP-319 S3: Await grounding with mode-aware timeout.
+    // --suggest-only: give grounding the full remaining budget from its 2s absolute window
+    //   (covers prefix-fast-path captures where classification took ~0ms).
+    // Normal capture: 300ms post-classification cap to avoid adding perceived latency.
+    const groundingElapsed = Date.now() - groundingStart;
+    const groundingTimeoutMs = options.suggestOnly
+        ? Math.max(0, GROUNDING_SUGGEST_ONLY_TOTAL_MS - groundingElapsed)
+        : GROUNDING_TIMEOUT_MS;
+    groundingResult = await Promise.race([
+        groundingPromise,
+        new Promise((resolve) => setTimeout(() => resolve(null), groundingTimeoutMs)),
+    ]);
+    // WP-319 S3: --suggest-only dry-run — show advisory preview and exit without creating entry.
+    if (options.suggestOnly) {
+        if (!json) {
+            printGroundingPreview(groundingResult, entryName, collectionSlug);
+        }
+        else {
+            process.stdout.write(JSON.stringify({ suggestOnly: true, groundingReport: groundingResult ?? {} }) + '\n');
+        }
+        return;
+    }
+    // WP-319 S3: Advisory grounding banner — stderr only, suppressed in json mode.
+    // Empty grounding (no matches) → silent. Never blocks capture.
+    if (!json && groundingResult) {
+        printGroundingBanner(groundingResult);
+    }
+    // WP-319 S3: --strict prompt — y/N confirmation when possible_duplicate found.
+    // Non-TTY skips prompt and auto-proceeds (fail-open on non-interactive).
+    if (options.strict && !json && groundingResult?.duplicates.some((d) => d.matchType === 'possible_duplicate')) {
+        const isTTY = process.stdin.isTTY;
+        if (isTTY) {
+            const answer = await promptYN('  Possible duplicate found. Proceed with capture? [y/N] ');
+            if (!answer) {
+                process.stderr.write('  Capture cancelled.\n');
+                return;
+            }
+        }
+    }
     // Phase 2: Create entry as draft
     if (!json)
-        process.stdout.write(`Capturing to ${collectionSlug}...\n`);
+        progress(`Capturing to ${collectionSlug}...`);
     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];
+    // Only set date when we can infer a source date from the capture itself.
+    const datedCollections = await getDatedCollections();
+    const inferredSourceDate = inferSourceDate(entryName, entryDescription, options.sourceRef, options.sourceExcerpt);
+    if (datedCollections.has(collectionSlug) && inferredSourceDate) {
+        data.date = inferredSourceDate;
     }
-    const result = await mcpCallWithSession('chain.createEntry', {
+    const result = await kernelCallWithSession('chain.createEntry', {
         collectionSlug,
         name: entryName,
-        status: 'draft',
+        // 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}`,
@@ -64,26 +255,71 @@ export async function runCapture(options) {
     });
     // Track in session state
     addCapturedEntry(result.entryId);
+    // WP-319 S3: Record grounding outcome for observability (STD-155, done-when 5).
+    // Fire-and-forget — never block capture on observability failure.
+    if (!skipGrounding && groundingStart > 0) {
+        void kernelCallWithSession('chain.recordGroundingOutcome', {
+            surface: 'cli',
+            promptShown: (groundingResult?.governance?.length ?? 0) > 0,
+            highestRatio: Math.max(...(groundingResult?.duplicates?.map((d) => d.overlapRatio) ?? []), ...(groundingResult?.related?.map((r) => r.overlapRatio) ?? []), 0),
+            hadGovernance: (groundingResult?.governance?.length ?? 0) > 0,
+            grounding_ms: groundingElapsed,
+        }).catch(() => undefined);
+    }
+    // WP-301 S4: Activation ceremony — show contextual retrieval after first capture
+    if (!json) {
+        try {
+            const activation = await checkActivation(result.entryId);
+            if (activation?.isFirst && activation.relatedEntries.length > 0) {
+                process.stdout.write('\n  Your first capture is on the Chain. Here\'s how it connects:\n');
+                for (const rel of activation.relatedEntries.slice(0, 3)) {
+                    process.stdout.write(`    \u2192 ${rel.entryId}: ${rel.name} (${rel.relation})\n`);
+                }
+                process.stdout.write('\n');
+            }
+            else if (activation?.isFirst) {
+                process.stdout.write('\n  Your first capture is on the Chain! Run `pb orient -b` to see your workspace.\n\n');
+            }
+        }
+        catch {
+            // Activation is additive — never blocks capture
+        }
+    }
+    // BET-272 S3: Advisory quality hints — from createEntryWithClassification result (BR-144)
+    const qualityHints = result.qualityHints ?? [];
     // 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', {
+            await kernelCallWithSession('chain.createEntryRelation', {
                 fromEntryId: result.entryId,
                 toEntryId: linkTarget,
                 type: relationType,
             });
         }
     }
+    // BET-271 S1: Determine if any fields were rejected by normalization.
+    const rejectedFields = result.normalization?.rejected ?? [];
+    const hasRejected = rejectedFields.length > 0;
     // Output
     if (json) {
         // Machine-readable output (TEN-709, DEC-299)
-        process.stdout.write(JSON.stringify({
+        const output = {
             id: result.entryId,
             collection: collectionSlug,
+            status: result.status,
             confidence: classification?.tier ?? 'explicit',
-        }) + '\n');
+        };
+        if (hasRejected) {
+            output.fieldsRejected = true;
+        }
+        // TEN-2365: surface the capture-time domain proposal in machine output.
+        if (result.authorityDomain) {
+            output.domain = result.authorityDomain.slug;
+            output.domainProposalPending = true;
+        }
+        process.stdout.write(JSON.stringify(output) + '\n');
     }
     else {
         process.stdout.write('\n');
@@ -91,13 +327,24 @@ export async function runCapture(options) {
             entryId: result.entryId,
             name: entryName,
             collection: collectionSlug,
-            status: 'draft',
+            status: result.status,
             classification,
             warnings: result.warnings,
             normalization: result.normalization,
             linkedTo: options.link,
             relationType: options.link ? (options.type ?? 'surfaces_tension_in') : undefined,
+            qualityHints,
+            relationSuggestions: result.relationSuggestions,
+            authorityDomain: result.authorityDomain,
         }) + '\n');
     }
+    // BET-271 S1: Throw when fields were rejected — signals "not everything you asked for happened."
+    if (hasRejected) {
+        throw new CLIError(`Fields rejected: ${rejectedFields.join(', ')}.`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: `Run \`pb fields ${collectionSlug}\` to see valid fields.`,
+        });
+    }
 }
 //# 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;AAQH,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,CA4BhB"}

package/dist/commands/chain-walk.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 { 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)
@@ -16,12 +17,16 @@ export async function runChainWalk(options) {
     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;AAEH,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,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,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,CAAkB,qBAAqB,EAAE;YACjD,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;AAmBH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1E"}

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);
@@ -28,11 +29,15 @@ export async function runChanges(options) {
         return;
     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;AAEH,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,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,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,CAAgB,uBAAuB,EAAE;YACjD,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, write-back hints, 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;AAMH,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,CAkC3E;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,56 @@
+/**
+ * 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) {
+    const config = await getConfigOrGuide(() => runCodexPrep(options));
+    if (!config)
+        return;
+    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, write-back hints, 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;AAEH,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,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,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,CAAoB,qBAAqB,EAAE;QAC5E,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"}