@productbrain/cli 0.1.0-beta.90 → 0.1.0-beta.9001

package/dist/commands/brief.js

@@ -38,7 +38,7 @@ export async function runBrief(options) {
                 skill: options.skill,
                 entriesSurfaced: surfacedIds,
                 timestamp: Date.now(),
-            }).catch(() => { });
+            }, { retryOnRateLimit: false }).catch(() => { });
             return result;
         },
         formatPretty: (result) => formatBrief(result, options.skill),
@@ -66,7 +66,29 @@ export async function runCompoundBrief(options) {
                 }
                 args.since = sinceMs;
             }
-            return await kernelCall('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`/`completedScenarios` 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":"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"}
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/commands/brief.ts"],"names":[],"mappings":"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"}

package/dist/commands/capture.d.ts

@@ -3,9 +3,9 @@
  * 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).
- * WP-319 S3: Pre-write grounding via chain.suggestLinksForCapture (advisory, fail-open).
+ * 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 / WP-755 C1a (TASK-215, DEC-1717): Pre-write grounding via chain.capture, the
+ * one capture door (advisory, fail-open) — replaces the deleted chain.suggestLinksForCapture.
  */
 interface CaptureOptions {
     text: string;
@@ -13,17 +13,23 @@ interface CaptureOptions {
     description?: string;
     collection?: string;
     link?: string;
-    type?: string;
-    /** BET-240 E2: Source reference URI (e.g. "meeting-2026-03-28.md"). */
+    /** WP-688 S4 (TASK-105, element 11): required whenever --link is set — no default, ever.
+     *  Absent + --link ⇒ the capture still succeeds, but the link is refused (see runCapture). */
+    linkType?: string;
+    /** BET-240 E2: source provenance — reference URI (e.g. "meeting-2026-03-28.md") + verbatim excerpt. */
     sourceRef?: string;
-    /** BET-240 E2: Verbatim excerpt from the source. */
     sourceExcerpt?: string;
+    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. */
+    /** WP-319 S3: strict prompts y/N before creating when the door returns an "ask" (possible match). */
     strict?: 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;
+    /** 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;;;;;;;;GAQG;AAuFH,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;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,CAwOvE"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0CH,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;kGAC8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,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,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iLAAiL;IACjL,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAwRvE"}

package/dist/commands/capture.js

@@ -3,168 +3,68 @@
  * 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).
- * WP-319 S3: Pre-write grounding via chain.suggestLinksForCapture (advisory, fail-open).
+ * 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 / WP-755 C1a (TASK-215, DEC-1717): Pre-write grounding via chain.capture, the
+ * one capture door (advisory, fail-open) — replaces the deleted chain.suggestLinksForCapture.
  */
 import { getConfigOrGuide } from '../lib/config.js';
 import { kernelCallWithSession } from '../lib/client.js';
-import { inferSourceDate } from '../lib/inferSourceDate.js';
-import { getPrefixToCollection, getDatedCollections } from '../lib/collectionRegistry.js';
+import { getPrefixToCollection, getCanonicalKeyToCollection } from '../lib/collectionRegistry.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 { 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');
-        });
-    });
-}
+import { parseFields } from '../lib/parseFields.js';
+import { emitEffectiveTenantNotice } from '../lib/workspaceNotice.js';
+import { isPreviewCreateEntryResult } from '../lib/createEntryResult.js';
+import { extractPrefixHint, printPossibleMatch, promptYN, highestVerdictScore } from '../lib/captureGrounding.js';
+import { applyCaptureLink } from '../lib/captureLink.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)
+    // 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) {
         throw new CLIError('No active session.', {
             code: ErrorCode.SESSION_REQUIRED,
             category: 'session',
-            guidance: 'Run `pb session start` first. Write access requires a tracked session (DEC-9).',
+            // DEC-9
+            guidance: 'Run `pb session start` first. Write access requires a tracked session.',
         });
     }
-    // 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).
+    // 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).
+    // WP-319 S3 / WP-755 C1a: Phase 1.5 — Pre-write grounding via the one capture door
+    // (advisory, fail-open, started IN PARALLEL with collection resolution): 300ms
+    // post-classification cap.
     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)
+        ? kernelCallWithSession('chain.capture', {
+            name: entryName,
+            description: entryDescription,
+            collectionSlug: options.collection,
+        }).then((res) => res ?? null).catch(() => null)
         : Promise.resolve(null);
-    // Phase 1: Resolve collection (classification)
+    // Phase 1: Resolve collection (classification). Review bclZ9: normalized the same way resolveCreateEntryCanonicalKey does server-side.
+    const normalizedEntryType = options.entryType?.toLowerCase().trim();
     let collectionSlug;
     let classification = null;
+    // Ruling #13: fast-path derives from the SAME 1:1 registry the server enforces, not a hand-picked pair of literal branches.
+    const derivedEntryTypeSlug = normalizedEntryType ? (await getCanonicalKeyToCollection())[normalizedEntryType] : undefined;
     if (options.collection) {
         // Explicit collection — skip classification
         collectionSlug = options.collection;
@@ -173,6 +73,10 @@ export async function runCapture(options) {
         // Prefix hint detected (e.g. "FLO:" → flows) — treat as explicit collection
         collectionSlug = prefixCollection;
     }
+    else if (derivedEntryTypeSlug) {
+        // Review bcI42/bclZ9/PR #713 cQP_I: --entry-type bypasses classification (normalized like the server) — derive the slug from the live registry, never hard-code it.
+        collectionSlug = derivedEntryTypeSlug;
+    }
     else {
         if (!json)
             progress('Classifying...');
@@ -189,151 +93,186 @@ export async function runCapture(options) {
         }
         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.
+    // WP-319 S3: 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.
+    groundingResult = await Promise.race([groundingPromise, new Promise((resolve) => setTimeout(() => resolve(null), GROUNDING_TIMEOUT_MS))]);
+    // Possible-match warning — stderr only, suppressed in json mode. Never blocks capture.
+    // TASK-608 (DEC-1915): no related list — a "create" verdict names no candidates.
     if (!json && groundingResult) {
-        printGroundingBanner(groundingResult);
+        printPossibleMatch(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')) {
+    // WP-319 S3: --strict prompts on "ask" (a possible match). Non-TTY skips.
+    if (options.strict && !json && groundingResult?.kind === 'ask') {
         const isTTY = process.stdin.isTTY;
         if (isTTY) {
-            const answer = await promptYN('  Possible duplicate found. Proceed with capture? [y/N] ');
+            const answer = await promptYN('  Possible match found. Proceed with capture? [y/N] ');
             if (!answer) {
                 process.stderr.write('  Capture cancelled.\n');
                 return;
             }
         }
     }
+    // WP-1: name the target workspace before the write so a wrong-Chain capture is never silent. After the --strict abort path; the TEN-2311 WHY check below can still throw without writing, so the user sees the target line then the validation error. stderr-only (WP-721).
+    await emitEffectiveTenantNotice();
     // Phase 2: Create entry as draft
     if (!json)
         progress(`Capturing to ${collectionSlug}...`);
-    const data = { description: entryDescription };
-    // 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 callerFields = options.field?.length ? parseFields(options.field) : {};
+    // TEN-2311: live, fail-open WHY guidance — the server remains the arbiter, this only prevents a doomed governed capture when the required field is absent. The contract fetch is the ONLY fail-open surface (network or server 4xx/5xx, an McpError/CLIError, is swallowed so chain.createEntry's server gate arbitrates); the deliberate guidance throw lives OUTSIDE the try so it is never misclassified as a swallowed transport failure.
+    let contract = null;
+    try {
+        contract = await kernelCallWithSession('chain.getCollectionFields', { slug: collectionSlug });
+    }
+    catch {
+        contract = null; // fail open — let the server gate arbitrate
     }
-    const result = await kernelCallWithSession('chain.createEntry', {
+    // TASK-584 (WP-802, TEN-4312): the capture text rides as `description` only so the server can
+    // remap it into the collection's primary text field (remapCreateEntryDescription). When the
+    // caller already set that field with -f and passed no -d, the default description has nowhere
+    // to go and the server reports it as a field the caller never sent — so leave it out. Which
+    // fields exist stays the kernel's call (RULE-128); a failed contract fetch sends as before.
+    const primaryKey = contract?.descriptionFieldKey;
+    const callerSetPrimaryField = options.description === undefined &&
+        typeof primaryKey === 'string' &&
+        primaryKey !== 'description' &&
+        callerFields[primaryKey] !== undefined;
+    const data = callerSetPrimaryField
+        ? { ...callerFields }
+        : { description: entryDescription, ...callerFields };
+    // WP-770 W2a (DEC-1787 ruling A): gated on `whyField` alone, not `governed` — the server's
+    // WHY hard-gate now also fires for the six why-required collections (purpose/vision/
+    // strategy/objective/decision/rule), not only the two `governed` (steering-shared) subjects.
+    // `getCollectionFields` already widens `whyField` the same way, so this stays a pure mirror.
+    if (contract?.whyField) {
+        const isNonEmpty = (v) => typeof v === 'string' && v.trim().length > 0;
+        // TEN-1258: the server remaps data.description → the collection's primary field before the
+        // WHY gate (createEntryPreparation.remapDescriptionField), so a bare capture would satisfy
+        // the WHY when that primary field IS the why field (none today, TASK-445's P1 correction
+        // retired the one live case — decisions now keeps description and why separate — but the
+        // mechanism stays generic). Mirror that here so the pre-flight does not false-block captures
+        // the server would accept.
+        const remapSatisfiesWhy = contract.descriptionFieldKey === contract.whyField && isNonEmpty(data.description);
+        const present = isNonEmpty(data[contract.whyField]) || remapSatisfiesWhy;
+        if (!present) {
+            throw new CLIError(`"${collectionSlug}" needs a WHY in "${contract.whyField}".`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: `Add it: --field ${contract.whyField}="<at least ${contract.minChars} characters of why>"`,
+            });
+        }
+    }
+    // WP-475 E1 (deterministic --link fix): when this capture will create a relation, the post-relation re-eval below owns the single LLM run — defer the LLM schedule at create time (relation-blind, race-prone otherwise); plain captures omit the flag. WP-688 S4: requires BOTH --link AND --link-type — a --link with no --link-type is refused (element 11) and never reaches the re-eval branch, so deferring there would strand llmStatus:'skipped' forever.
+    const willRelate = Boolean(options.link?.trim() && options.linkType);
+    const rawResult = 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}`,
         // BET-240 E2: source provenance — pass through when provided
         ...(options.sourceRef ? { sourceRef: options.sourceRef } : {}),
         ...(options.sourceExcerpt ? { sourceExcerpt: options.sourceExcerpt } : {}),
+        ...(willRelate ? { deferLLMSchedule: true } : {}),
+        ...(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.
     });
-    // 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.
+    // 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' });
+    }
+    const result = rawResult;
+    const entryId = result.entryId;
+    const entryStatus = result.status;
+    const warnings = result.warnings;
+    const normalization = result.normalization;
+    const qualityHints = result.qualityHints ?? [];
+    const spineFloor = result.spineFloor;
+    let coaching = result.coaching;
+    // Track in session state.
+    addCapturedEntry(entryId);
+    // WP-319 S3 / WP-755 C1a: Record grounding outcome for observability (STD-155, done-when 5).
+    // Fire-and-forget — never block capture (TEN-2924: no retry, its timer would hold the loop).
+    // hadGovernance is always false post-C1a: the old suggestLinksForCapture route's per-candidate
+    // governed-collection severity (block/warn/inform) has no equivalent in the new door — a cited
+    // narrowing (see captureGrounding.ts's header), not a silent drop.
     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,
+            promptShown: groundingResult?.kind === 'ask',
+            highestRatio: highestVerdictScore(groundingResult),
+            hadGovernance: false,
             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 kernelCallWithSession('chain.createEntryRelation', {
-                fromEntryId: result.entryId,
-                toEntryId: linkTarget,
-                type: relationType,
-            });
-        }
+        }, { retryOnRateLimit: false }).catch(() => undefined);
     }
+    // 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.
+    // Phase 3: Link the created draft to an existing entry if --link provided (TEN-705).
+    // Extracted to captureLink.ts (500-LOC budget, STD-2/DEC-1504).
+    const linkResult = await applyCaptureLink({ entryId, link: options.link, linkType: options.linkType, coaching });
+    const actualLinkedTo = linkResult.actualLinkedTo;
+    const actualRelationType = linkResult.actualRelationType;
+    const linkTypeRefusal = linkResult.linkTypeRefusal;
+    coaching = linkResult.coaching;
     // BET-271 S1: Determine if any fields were rejected by normalization.
-    const rejectedFields = result.normalization?.rejected ?? [];
+    // 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)
-        const output = {
-            id: result.entryId,
-            collection: collectionSlug,
-            confidence: classification?.tier ?? 'explicit',
-        };
+        // Machine-readable output (TEN-709, DEC-299).
+        const output = { id: entryId, collection: collectionSlug, status: entryStatus, confidence: classification?.tier ?? 'explicit' };
+        // TASK-619: an ask names its close matches for automated callers too, so they can update one deliberately.
+        if (groundingResult?.kind === 'ask')
+            output.possibleMatches = groundingResult.candidates.map((c) => ({ entryId: c.entryId, name: c.name, collection: c.collectionSlug, score: c.score }));
         if (hasRejected) {
             output.fieldsRejected = true;
+            output.droppedFields = rejectedFields;
         }
+        // WP-475 E1: raw heuristic coaching verdict in machine output (BR-144: advisory).
+        // Post-relation re-eval (when --link ran) takes precedence over the create-response verdict.
+        if (coaching) {
+            output.coaching = coaching;
+        }
+        // WP-688 S4 (element 11): echo the verb ACTUALLY WRITTEN — absent when no relation was
+        // written (refused or --link never supplied), never guessed, never defaulted.
+        if (actualRelationType) {
+            output.relationType = actualRelationType;
+        }
+        if (spineFloor)
+            output.spineFloor = spineFloor;
         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',
+            status: entryStatus,
             classification,
-            warnings: result.warnings,
-            normalization: result.normalization,
-            linkedTo: options.link,
-            relationType: options.link ? (options.type ?? 'surfaces_tension_in') : undefined,
+            warnings,
+            normalization: normalization ?? undefined,
+            linkedTo: actualLinkedTo,
+            relationType: actualRelationType,
             qualityHints,
-            relationSuggestions: result.relationSuggestions,
+            coaching,
+            spineFloor,
         }) + '\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.`,
-        });
+    // WP-688 S4 (element 11): --link without --link-type — refuses non-zero identically in
+    // both TTY and --json mode, thrown AFTER the (successful) capture output above so the
+    // created id is never orphaned silently.
+    if (linkTypeRefusal) {
+        throw linkTypeRefusal;
     }
 }
 //# sourceMappingURL=capture.js.map