@productbrain/cli 0.1.0-beta.9 → 0.1.0-beta.9000

package/dist/commands/brief.js

@@ -0,0 +1,97 @@
+/**
+ * pb brief — incremental brief delta or compound intelligence query.
+ * BET-239 Slice 4 (incremental) + Slice 5 (compound queries).
+ *
+ * Usage:
+ *   pb brief --skill <name> --since-last  — incremental delta for a skill (E4)
+ *   pb brief steering                     — compound steering brief (E6)
+ *   pb brief confidence                   — compound confidence pass (E6)
+ *   pb brief delta [--since <ISO>]        — compound delta sync (E6)
+ *
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+import { getConfigOrGuide } from '../lib/config.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 runCliCommand({
+        fn: async () => {
+            const result = await kernelCall('chain.incrementalChanges', {
+                skill: options.skill,
+            });
+            // Record the brief run so the next call sees an updated "since last brief" timestamp.
+            // Fire-and-forget: recording failure should not block the CLI output.
+            const surfacedIds = result.newEntries
+                .map((e) => e.entryId)
+                .filter((id) => id !== null);
+            kernelCall('chain.recordBriefRun', {
+                skill: options.skill,
+                entriesSurfaced: surfacedIds,
+                timestamp: Date.now(),
+            }, { retryOnRateLimit: false }).catch(() => { });
+            return result;
+        },
+        formatPretty: (result) => formatBrief(result, options.skill),
+    });
+}
+/** Run compound brief query (E6 — steering, confidence, delta). */
+export async function runCompoundBrief(options) {
+    const config = await getConfigOrGuide(() => runCompoundBrief(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: async () => {
+            const args = {
+                type: options.type,
+            };
+            // For delta type, parse the --since option
+            if (options.type === 'delta' && options.since) {
+                const sinceMs = Date.parse(options.since);
+                if (isNaN(sinceMs)) {
+                    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;
+            }
+            // `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),
+    });
+}
+export { isCompoundType, COMPOUND_TYPES };
+//# sourceMappingURL=brief.js.map

package/dist/commands/brief.js.map

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

package/dist/commands/capture.d.ts

@@ -3,8 +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).
+ * 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;
@@ -12,9 +13,23 @@ interface CaptureOptions {
     description?: string;
     collection?: string;
     link?: string;
-    type?: string;
+    /** 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;
+    sourceExcerpt?: string;
+    draft?: boolean;
     /** @deprecated Use global --json flag instead. Preserved for backward compatibility. */
     json?: boolean;
+    /** 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;;;;;;;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;;;;;;;;GAQG;AA2CH,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,CAiVvE"}

package/dist/commands/capture.js

@@ -3,98 +3,337 @@
  * 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).
+ * 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 { mcpCallWithSession } from '../lib/client.js';
+import { kernelCallWithSession } from '../lib/client.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 { progress } 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 { extractPrefixHint, printPossibleMatch, promptYN, highestVerdictScore } from '../lib/captureGrounding.js';
+import { runVersionCapture } from '../lib/captureVersion.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) {
-        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;
-    // Phase 1: Resolve collection (classification)
+    // 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 / 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 groundingStart = Date.now();
+    const skipGrounding = process.env.PB_GROUNDING_MODE === 'off';
+    let groundingResult = null;
+    const groundingPromise = (!skipGrounding && (entryName || entryDescription))
+        ? kernelCallWithSession('chain.capture', {
+            name: entryName,
+            description: entryDescription,
+            collectionSlug: options.collection,
+        }).then((res) => res ?? null).catch(() => null)
+        : Promise.resolve(null);
+    // 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;
     }
+    else if (prefixCollection) {
+        // 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)
-            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;
     }
-    // Phase 2: Create entry as draft
-    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];
+    // WP-319 S3: 300ms post-classification cap to avoid adding perceived latency.
+    const groundingElapsed = Date.now() - groundingStart;
+    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) {
+        printPossibleMatch(groundingResult);
     }
-    const result = await mcpCallWithSession('chain.createEntry', {
-        collectionSlug,
-        name: entryName,
-        status: 'draft',
-        data,
-        sessionId: session.sessionId,
-        createdBy: `agent:${session.sessionId}`,
-    });
-    // 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-319 S3 (narrowed C2/TASK-216): --strict now prompts only on "ask" — genuine ambiguity. "version" is silent, no --strict gate (DEC-1717). Non-TTY skips.
+    if (options.strict && !json && groundingResult?.kind === 'ask') {
+        const isTTY = process.stdin.isTTY;
+        if (isTTY) {
+            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();
+    // WP-755 C2 (TASK-216, DEC-1717): the version branch sits WHERE the create call sits — same
+    // option parsing, same --link/--source-ref/--field the create would have sent — and replaces
+    // createEntry with updateEntry via captureVersion.ts. Narrowed once so every branch below
+    // (link handling, output) shares one entryId/entryStatus/... set regardless of path.
+    const versionVerdict = groundingResult?.kind === 'version' ? groundingResult : null;
+    let entryId;
+    let receiptName = entryName;
+    let entryStatus;
+    let warnings = [];
+    let normalization;
+    let qualityHints = [];
+    let spineFloor;
+    let coaching;
+    if (versionVerdict) {
+        if (!json)
+            progress(`Saving as a new version of ${versionVerdict.entryId}...`);
+        const versionResult = await runVersionCapture({
+            groundingResult: versionVerdict,
+            // Only an EXPLICIT --name is a real title (kernel/capture/versionWrite.ts's own contract:
+            // a placeholder must never rename the target). entryName's cleanText fallback is the
+            // capture's prose body, never a title — forwarding it here renamed the target on every
+            // version write with no --name given.
+            name: options.name,
+            prose: entryDescription,
+            fields: options.field?.length ? parseFields(options.field) : undefined,
+            sourceRef: options.sourceRef,
+            sourceExcerpt: options.sourceExcerpt,
+            sessionId: session.sessionId,
+            skipGrounding,
+            groundingStart,
+            groundingElapsed,
+        });
+        entryId = versionResult.entryId;
+        receiptName = versionResult.name;
+        warnings = versionResult.warnings;
+        normalization = versionResult.normalization;
+        // No entryStatus: chain.updateEntry's return carries no status field, and the target's real
+        // status (which a version write never changes) can be draft or accepted — never guess.
+    }
+    else {
+        // Phase 2: Create entry as draft
+        if (!json)
+            progress(`Capturing to ${collectionSlug}...`);
+        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
+        }
+        // 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,
+            // 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.
+        });
+        // 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;
+        entryId = result.entryId;
+        entryStatus = result.status;
+        warnings = result.warnings;
+        normalization = result.normalization;
+        qualityHints = result.qualityHints ?? [];
+        spineFloor = result.spineFloor;
+        coaching = result.coaching;
+    }
+    // Track in session state — a version write is still a capture this session touched.
+    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. Version already fired its
+    // own call (inside runVersionCapture) — never double-record.
+    if (!versionVerdict && !skipGrounding && groundingStart > 0) {
+        void kernelCallWithSession('chain.recordGroundingOutcome', {
+            surface: 'cli',
+            promptShown: groundingResult?.kind === 'ask',
+            highestRatio: highestVerdictScore(groundingResult),
+            hadGovernance: false,
+            grounding_ms: groundingElapsed,
+        }, { 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 to existing entry if --link provided (TEN-705) — applies to a version write
+    // the same as a create; entryId names whichever entry this run actually wrote (the created
+    // draft, or the version's target). 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.
+    // 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;
+    // A version write's fields were validated against the TARGET's own collection, never the
+    // capture's classified one (they can differ — decide() matches across every collection).
+    const fieldsCollection = versionVerdict ? versionVerdict.collectionSlug : collectionSlug;
     // 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). Version's shape is intentionally smaller
+        // (no classification/confidence — the target's collection was never classified this run).
+        const output = versionVerdict
+            ? { id: entryId, collection: versionVerdict.collectionSlug, kind: 'version' }
+            : { id: entryId, collection: collectionSlug, status: entryStatus, confidence: classification?.tier ?? 'explicit' };
+        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 if (versionVerdict) {
+        // WP-755 C2: a distinct, concise receipt — entry id + name from the verdict, never the
+        // create-shaped formatCaptureReceipt (classification/confidence don't apply to an edit of
+        // an already-accepted entry). stdout carries the raw entry id (scripting contract, mirrors
+        // `pb capture ... | xargs pb get`).
+        process.stderr.write(`  Saved as a new version of ${entryId} "${receiptName}".\n`);
+        if (warnings.length > 0)
+            process.stderr.write(`  Warnings: ${warnings.join('; ')}\n`);
+        if (hasRejected)
+            process.stderr.write(`  Run \`pb fields ${fieldsCollection}\` to see valid fields.\n`);
+        if (actualLinkedTo)
+            process.stderr.write(`  Linked to ${actualLinkedTo} (${actualRelationType}).\n`);
+        process.stdout.write(`${entryId}\n`);
     }
     else {
         process.stdout.write('\n');
         process.stdout.write(formatCaptureReceipt({
-            entryId: result.entryId,
+            entryId,
             name: entryName,
             collection: collectionSlug,
-            status: 'draft',
+            status: entryStatus, // always set in the create branch above (result.status) — only the version branch leaves it undefined, and that branch never reaches here.
             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,
+            coaching,
+            spineFloor,
         }) + '\n');
     }
+    // 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

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

@@ -0,0 +1,14 @@
+/**
+ * pb walk <entry-id> — directed deep traversal along one relation type.
+ * BET-239 Slice 2: deep chain walk with cycle detection.
+ *
+ * Traverses to depth 4, fan-out cap 10 per hop, total node cap 100.
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+export declare function runChainWalk(options: {
+    entryId: string;
+    depth: number;
+    direction: string;
+    type?: string;
+}): Promise<void>;
+//# sourceMappingURL=chain-walk.d.ts.map

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

@@ -0,0 +1 @@
+{"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,CA4BhB"}

package/dist/commands/chain-walk.js

@@ -0,0 +1,38 @@
+/**
+ * pb walk <entry-id> — directed deep traversal along one relation type.
+ * BET-239 Slice 2: deep chain walk with cycle detection.
+ *
+ * Traverses to depth 4, fan-out cap 10 per hop, total node cap 100.
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+import { getConfigOrGuide } from '../lib/config.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;
+    const { entryId, depth, direction, type } = options;
+    // Validate direction
+    if (direction !== 'outgoing' && direction !== '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: () => kernelCall('chain.deepChainWalk', {
+            entryId,
+            direction,
+            maxHops: clampedDepth,
+            ...(type ? { relationType: type } : {}),
+        }),
+        formatPretty: (result) => formatChainWalk(result, entryId, direction, clampedDepth, type),
+    });
+}
+//# sourceMappingURL=chain-walk.js.map