kibi-opencode 0.9.0 → 0.11.0

package/README.md

@@ -113,14 +113,12 @@ The plugin injects guidance into OpenCode sessions to improve agent grounding. U
 
 OpenCode exposes Kibi MCP prompts as slash commands. The \`/init-kibi\` command triggers the \`kb_autopilot_generate\` workflow to assist in retroactive bootstrap using only public MCP tools.
 
-### Start-Task Briefing
+When the plugin detects an authoritative risky edit (`behavior_candidate` or `traceability_candidate` risk class), it automatically renders a Kibi briefing before the prompt. The plugin uses two complementary paths: the `file.edited` event hook as a fast-path hint, and prompt-cycle reconciliation as an authoritative fallback for programmatic edits that bypass the event bus. Briefings are rendered directly into the prompt to ensure immediate visibility.
 
-When the plugin detects an authoritative risky edit (`behavior_candidate` or `traceability_candidate` risk class), it automatically fetches a Kibi briefing from a background worker session via the `file.edited` event path. Auto-briefing is no longer deferred and provides immediate project context before you act.
-
-- **Automatic delivery**: Briefings appear in a toast notification and inside the guidance block headed `🧠 **Kibi briefing available**`.
-- **Contextual richness**: The briefing includes a summary and key source-linked bullets generated by the `kb_briefing_generate` MCP tool.
-- **TL;DR fallback**: If a full briefing is unavailable, a summary is provided with a cue to use the manual command.
-- **Manual command**: Use `/brief-kibi` at any time to trigger an on-demand briefing if auto-delivery is skipped or fails.
+- **Immediate delivery**: Briefings are rendered-first into the prompt guidance block headed `🧠 **Kibi briefing available**` and TUI toasts titled `Kibi Knowledge Update`. Unread briefings automatically open the interactive TUI via the `kibi.brief` route.
+- **Narrative structure**: Delivery favors user-facing prose with `What changed` and `Why it matters`, plus conditional `Project knowledge impact` / `Interpretation note` sections when evidence or caveats exist.
+- **TL;DR fallback**: If a full briefing is unavailable, fallback output still preserves `What changed` / `Why it matters` framing while keeping the manual command cue available.
+- **Manual command**: Use `/brief-kibi` or the `kibi.open_latest_brief` command at any time to trigger an on-demand briefing if auto-delivery is skipped or fails.
 
 ### Discovery-first MCP guidance
 
@@ -138,11 +136,12 @@ Internal maintenance automatically syncs the knowledge base after relevant file
 - Single-flight scheduler (no overlapping syncs)
 - Debounce window (default: 2000ms)
 - Dirty flag triggers one trailing rerun after active sync completes
+- **Idle suppression**: Background sync attempts triggered by session idle are suppressed after an operational sync failure is latched (`scheduler_sync_failed`). Manual edits and tool executions continue to schedule syncs to allow for recovery.
 
 ### Non-Blocking UX
 
 - Sync runs in background, never blocks OpenCode
-- Failures reported via console logs only, never as blocking UI elements
+- **Non-blocking toast delivery**: Toast transport is best-effort. The plugin detects available OpenCode TUI capabilities (`client.tui.toast` or `client.tui.showToast`) and uses the official SDK contract. Toast failures resolve to structured `SendToastResult` objects (`delivered`, `unavailable`, `failed`) rather than throwing or falling back to raw HTTP requests.
 
 ## Configuration
 
@@ -166,6 +165,8 @@ Config files (project overrides global):
 | `ux.toastFailures` | boolean | `true` | Show failure toasts for sync/check issues |
 | `ux.toastSuccesses` | boolean | `false` | Show success toasts for sync/check completion |
 | `ux.toastCooldownMs` | number | `10000` | Cooldown between repeated UX toasts |
+| `ux.briefs.autoSubmit` | boolean | `true` | **Deprecated/No-op**: Auto-submission is no longer needed with render-first briefing |
+PP|| `guidance.dynamic` | boolean | `true` | Enable dynamic contextual guidance |
 | `guidance.dynamic` | boolean | `true` | Enable dynamic contextual guidance |
 | `guidance.warnOnKbEdits` | boolean | `true` | Enable loud warnings for .kb/** edits |
 | `guidance.factFirstDomainRouting` | boolean | `true` | Enable FACT-first domain routing suggestions |
@@ -195,21 +196,31 @@ The plugin follows a **silent-except-operational-errors** policy for terminal ou
 
 | Classification | Examples | Surface | Terminal | Structured |
 |---------------|----------|---------|----------|------------|
-| **Advisory (background)** | scheduler check failures, degraded-mode latches | `errorStructuredOnly()` | No | Yes, via `client.app.log()` |
-| **Operational (plugin)** | bootstrap-needed, sync failure, hook/init failure | `error()` | Yes, via `console.error` | Yes, via `client.app.log()` |
+| **Advisory (background)** | routine `info()`, `warn()`, scheduler check failures, degraded-mode latches, `errorStructuredOnly()` | `client.app.log()` | No | Yes, via `client.app.log()` |
+| **Operational (plugin)** | bootstrap-needed, sync failure, hook/init failure | `error()` | Yes, exactly one prefixed `console.error` (`[kibi-opencode]`) | Yes, via `client.app.log()` |
 | **Authoritative external** | git hooks, CLI checks | Outside plugin surface | N/A | N/A |
 
 ### Failure Routing Contract
 
 The logger exposes two error-level surfaces with distinct routing semantics:
 
-- **`error(msg, metadata?)`** — Operational plugin failures. Always emits to `console.error` for terminal visibility, plus `client.app.log()` when a client is bound. Use for bootstrap-needed, hook/init failures, and sync failures that require developer attention.
-- **`errorStructuredOnly(msg, metadata?)`** — Advisory background maintenance failures. Routes through `client.app.log()` only when a client is bound; completely silent when no client is bound (no `console.error` fallback). Use for scheduler check failures and degraded-mode latches.
+- **`error(msg, metadata?)`** — Operational plugin failures. Emits exactly one prefixed `console.error` (`[kibi-opencode]`) for terminal visibility, plus `client.app.log()` when a client is bound. Structured log rejection does not emit secondary console noise. Use for bootstrap-needed, hook/init failures, and sync failures that require developer attention. Operational sync failure payloads include diagnostic metadata: `syncCommand`, `syncStdout`, `syncStderr`, and `syncErrorMessage`.
+- **`errorStructuredOnly(msg, metadata?)`** — Advisory background maintenance failures. Routes through `client.app.log()` only when a client is bound and remains terminal-silent even when the structured transport rejects. Use for scheduler check failures and degraded-mode latches.
+
+
 
-**Contract rule:** Once `client` is bound (after `setClient()`), advisory logging MUST use `errorStructuredOnly()`. When no client is bound, `errorStructuredOnly()` is completely silent — it does not fall back to `console.error`.
+**Contract rule:** Once `client` is bound (after `setClient()`), advisory paths (`info()`, `warn()`, `errorStructuredOnly()`) MUST stay on `client.app.log()` and remain terminal-silent. Operational failures use `error()` for a single prefixed terminal emission without duplicating console output when structured logging rejects.
 
 Routine diagnostics route through [`client.app.log()`](https://opencode.ai/docs/plugins/) and never appear in the terminal. Only operational error-class events break terminal silence. This keeps the developer's workspace clean while preserving full visibility in structured logs for debugging.
 
+### Toast Transport Contract
+
+The plugin uses the official OpenCode toast APIs with automatic capability detection:
+
+1. **Legacy transport**: `client.tui.toast(payload)` — used when available in plugin context
+2. **SDK transport**: `client.tui.showToast({ body: payload })` — used as fallback
+3. **No capability**: Returns `{ status: "unavailable", reason: "missing-capability" }`
+The `sendToast` helper returns a discriminated `SendToastResult` union and never throws. There is no raw HTTP fallback. For rich briefing delivery, the plugin uses the `kibi.brief` route and the `kibi.open_latest_brief` command for manual retrieval.
 The `experimental.chat.system.transform` hook handles prompt injection (see [Hook Policy](#hook-policy)). The `chat.params` hook is compatibility-only and never carries prompt text.
 
 ### Hook Modes
@@ -275,6 +286,20 @@ A proposed enhancement would inject Kibi context hints into file-read results (e
 
 Current workaround: static system prompt guidance directs agents to query Kibi explicitly.
 
+### File-Context Guidance
+
+The plugin provides proactive guidance when agents perform file operations:
+
+- **File-create/edit guidance**: When an agent creates or edits a source file, the plugin may inject reminders to check Kibi for that path if e2e evidence exists.
+
+- **File-delete safety guidance**: When an agent attempts to delete a file, the plugin injects a safety check reminding the agent to verify if the file implements any Kibi requirements before removal.
+
+- **E2e reminder evidence**: File-operation reminders use exact Kibi graph evidence first (`covered_by` links to `[e2e]`-tagged entities or `/e2e/`-sourced entities) and narrow path heuristics second. Package-level e2e tests do not trigger "authoritative evidence" flags at the file level.
+
+- **Session suppression**: To minimize prompt noise, this guidance is suppressed after the first occurrence per path per session.
+
+- **Current-host scope**: This feature uses host-side event monitoring to detect intent; it does not intercept or modify actual file content returned by the Read tool.
+
 ## License
 
 AGPL-3.0-or-later

package/dist/brief-delivery-reasons.d.ts

@@ -0,0 +1,12 @@
+import type { DeliveryReasons } from "./idle-brief-store.js";
+export type BuildInput = {
+    entitiesAdded: string[];
+    entitiesModified: string[];
+    entitiesRemoved: string[];
+    relationshipsChanged: number;
+    validationCount: number;
+    conflictReasons?: string[];
+};
+export declare function buildDeliveryReasons(input: BuildInput): DeliveryReasons | undefined;
+export declare function renderToastSummary(reasons: DeliveryReasons): DeliveryReasons["toast"] | undefined;
+export declare function renderFullBriefReasons(reasons: DeliveryReasons): string;

package/dist/brief-delivery-reasons.js

@@ -0,0 +1,132 @@
+// Inlined from kibi-cli/operational-artifacts to avoid heavy module resolution
+function isOperationalArtifactPath(pathLike) {
+    const normalized = pathLike.replaceAll("\\", "/");
+    return /(^|\/)\.sisyphus\//.test(normalized);
+}
+const ORDER = {
+    conflict_detected: 0,
+    validation_issue: 1,
+    entity_modified: 2,
+    entity_added: 3,
+    entity_removed: 4,
+    relationship_changed: 5,
+};
+const TYPE_NAMES = {
+    REQ: "requirement",
+    FACT: "fact",
+    TEST: "test",
+    SCEN: "scenario",
+    SYM: "code traceability",
+    ADR: "decision",
+    FLAG: "runtime flag",
+    EVENT: "event",
+};
+function prefixName(id) {
+    const prefix = id.split("-")[0]?.toUpperCase() ?? id;
+    return TYPE_NAMES[prefix] ?? prefix;
+}
+function mk(kind, text, entityIds) {
+    return { kind, text, entityIds };
+}
+function entityItems(kind, ids) {
+    if (!ids.length)
+        return [];
+    const verb = kind === "entity_added" ? "Added" : kind === "entity_modified" ? "Updated" : "Removed";
+    const grouped = new Map();
+    for (const id of [...ids].sort()) {
+        const prefix = id.split("-")[0]?.toUpperCase() ?? id;
+        const group = grouped.get(prefix);
+        if (group) {
+            group.push(id);
+        }
+        else {
+            grouped.set(prefix, [id]);
+        }
+    }
+    return [...grouped.entries()].map(([, groupedIds]) => {
+        const noun = prefixName(groupedIds[0] ?? "");
+        const text = groupedIds.length === 1
+            ? `${verb} ${noun} ${groupedIds[0]}`
+            : `${verb} ${groupedIds.length} ${noun}s (${groupedIds.join(", ")})`;
+        return mk(kind, text, groupedIds);
+    });
+}
+function toastSummary(items) {
+    const first = items[0]?.text?.trim() ?? "";
+    const second = items[1]?.text?.trim() ?? "";
+    if (first && second)
+        return `${first}, ${second}`;
+    return first || second || undefined;
+}
+function toastWhy(items) {
+    if (items.some((i) => i.kind === "conflict_detected"))
+        return "There is a knowledge conflict to resolve before using the brief.";
+    if (items.some((i) => i.kind === "validation_issue"))
+        return "Validation issues need attention before the update is treated as settled.";
+    const hasEntities = items.some((i) => i.kind === "entity_added" || i.kind === "entity_modified" || i.kind === "entity_removed");
+    const hasRelationships = items.some((i) => i.kind === "relationship_changed");
+    if (hasEntities && hasRelationships)
+        return "Requirements and facts were updated.";
+    if (hasEntities)
+        return "Entities were updated.";
+    if (hasRelationships)
+        return "Relationships were updated.";
+    return undefined;
+}
+export function buildDeliveryReasons(input) {
+    const items = [];
+    if (input.conflictReasons?.length)
+        items.push(mk("conflict_detected", input.conflictReasons[0]?.trim() || "Conflict detected", []));
+    if (input.validationCount > 0)
+        items.push(mk("validation_issue", `${input.validationCount} validation issue${input.validationCount === 1 ? "" : "s"} detected`, []));
+    items.push(...entityItems("entity_modified", input.entitiesModified));
+    items.push(...entityItems("entity_added", input.entitiesAdded));
+    items.push(...entityItems("entity_removed", input.entitiesRemoved));
+    if (input.relationshipsChanged > 0)
+        items.push(mk("relationship_changed", `Updated ${input.relationshipsChanged} relationships`, []));
+    if (!items.length)
+        return undefined;
+    items.sort((a, b) => ORDER[a.kind] - ORDER[b.kind]);
+    return { version: 1, items, toast: { title: "Kibi Knowledge Update", summary: toastSummary(items) ?? "", whyItMatters: toastWhy(items) ?? "" } };
+}
+function isOperationalByEntityIds(item) {
+    if (item.entityIds.length === 0)
+        return false;
+    return item.entityIds.every((id) => {
+        const dashIdx = id.indexOf("-");
+        if (dashIdx < 0)
+            return false;
+        const name = id.slice(dashIdx + 1);
+        // Entity names with file extensions are likely from operational artifact files
+        return /\.[a-zA-Z0-9]+$/.test(name);
+    });
+}
+function isOperationalItem(item, allItems) {
+    if (item.kind === "relationship_changed") {
+        // relationship_changed items have no entityIds; treat as operational when
+        // all entity-level items in the set are operational (they're relationship side-effects)
+        const entityItems = allItems.filter((i) => i.kind === "entity_added" || i.kind === "entity_modified" || i.kind === "entity_removed");
+        return entityItems.length > 0 && entityItems.every(isOperationalByEntityIds);
+    }
+    return isOperationalByEntityIds(item);
+}
+export function renderToastSummary(reasons) {
+    const domainItems = reasons.items.filter((i) => !isOperationalItem(i, reasons.items));
+    if (domainItems.length === 0) {
+        return undefined; // suppress: specific-or-silent policy
+    }
+    return {
+        title: "Kibi Knowledge Update",
+        summary: toastSummary(domainItems) ?? "",
+        whyItMatters: toastWhy(domainItems) ?? "",
+    };
+}
+export function renderFullBriefReasons(reasons) {
+    const domainItems = reasons.items.filter((i) => !isOperationalItem(i, reasons.items));
+    const lines = ["## What changed", ...domainItems.map((r) => `- ${r.text}`)];
+    const whyItMatters = toastWhy(domainItems);
+    if (whyItMatters) {
+        lines.push("", "## Why it matters", whyItMatters);
+    }
+    return lines.join("\n");
+}

package/dist/brief-intent.d.ts

@@ -6,7 +6,8 @@ export interface BriefIntentParams {
     maintenanceDegraded: boolean;
     workspaceRoot: string;
     branch: string;
-    editedFilePath: string | undefined;
+    sourceFiles: string[];
+    focusFilePath?: string;
     seedIds?: string[];
 }
 export interface BriefIntentResult {
@@ -22,9 +23,19 @@ export interface BriefIntentInputs {
     maintenanceDegraded: boolean;
     worktreeRoot: string;
     branch: string;
-    editedFile: string | undefined;
+    sourceFiles: string[];
+    focusFilePath?: string;
     seedIds?: string[];
 }
 export declare function deriveBriefIntent(params: BriefIntentParams): BriefIntentResult;
-export declare function computeBriefIntent(// implements REQ-opencode-kibi-briefing-v2
-inputs: BriefIntentInputs): BriefIntentResult;
+export declare function computeBriefIntent(inputs: BriefIntentInputs): BriefIntentResult;
+export interface BriefingContextParams {
+    sourceFiles: string[];
+    seedIds?: string[];
+    changedEntityIds?: string[];
+}
+export interface BriefingContextResult {
+    sourceFiles: string[];
+    seedIds: string[];
+}
+export declare function buildBriefingContext(params: BriefingContextParams): BriefingContextResult;

package/dist/brief-intent.js

@@ -1,5 +1,9 @@
 // implements REQ-opencode-kibi-briefing-v2, REQ-opencode-smart-enforcement-v1
-import * as path from "node:path";
+// Inlined from kibi-cli/operational-artifacts to avoid heavy module resolution
+function isOperationalArtifactPath(pathLike) {
+    const normalized = pathLike.replaceAll("\\", "/");
+    return /(^|\/)\.sisyphus\//.test(normalized);
+}
 import { getSourceLinkedRequirementIds } from "./source-linked-guidance.js";
 const ELIGIBLE_RISK_CLASSES = new Set([
     "behavior_candidate",
@@ -9,35 +13,47 @@ const STRICT_ELIGIBLE_POSTURES = new Set([
     "root_active",
     "hybrid_root_plus_vendored",
 ]);
-function hasEditedFilePath(editedFilePath) {
-    return typeof editedFilePath === "string" && editedFilePath.length > 0;
+function sortAndDedup(files) {
+    return [...new Set(files)].sort();
 }
 function deriveSeedIds(params) {
-    if (!hasEditedFilePath(params.editedFilePath)) {
-        return [];
+    if (params.seedIds !== undefined && params.seedIds.length > 0) {
+        return buildBriefingContext({
+            sourceFiles: params.sourceFiles,
+            seedIds: params.seedIds,
+        }).seedIds.slice(0, 3);
     }
-    if (params.seedIds !== undefined) {
-        return params.seedIds.slice(0, 3);
+    const focusFile = params.focusFilePath ?? params.sourceFiles[0];
+    if (!focusFile) {
+        return [];
     }
-    const absoluteEditedPath = path.isAbsolute(params.editedFilePath)
-        ? params.editedFilePath
-        : path.join(params.workspaceRoot, params.editedFilePath);
-    return getSourceLinkedRequirementIds(params.workspaceRoot, absoluteEditedPath).slice(0, 3);
+    return buildBriefingContext({
+        sourceFiles: params.sourceFiles,
+        seedIds: getSourceLinkedRequirementIds(params.workspaceRoot, focusFile),
+    }).seedIds.slice(0, 3);
 }
 // implements REQ-opencode-kibi-briefing-v2, REQ-opencode-smart-enforcement-v1
 export function deriveBriefIntent(params) {
-    const fingerprint = `brief:${params.workspaceRoot}\0${params.branch}\0${params.editedFilePath ?? ""}\0${params.riskClass}`;
-    const sourceFiles = hasEditedFilePath(params.editedFilePath)
-        ? [params.editedFilePath]
-        : [];
+    const sortedSourceFiles = sortAndDedup(params.sourceFiles);
+    const nonOperationalSourceFiles = sortedSourceFiles.filter((f) => !isOperationalArtifactPath(f));
+    const fingerprint = `brief:${params.workspaceRoot}\0${params.branch}\0${params.riskClass}\0${nonOperationalSourceFiles.join("\0")}`;
     const seedIds = deriveSeedIds(params);
-    if (!hasEditedFilePath(params.editedFilePath)) {
+    if (sortedSourceFiles.length === 0) {
         return {
             eligible: false,
-            reason: "Ineligible: edited file path is missing",
+            reason: "Ineligible: no source files in session",
             fingerprint,
-            sourceFiles,
-            seedIds,
+            sourceFiles: sortedSourceFiles,
+            seedIds: [],
+        };
+    }
+    if (nonOperationalSourceFiles.length === 0) {
+        return {
+            eligible: false,
+            reason: "All source changes are operational task-tracking artifacts",
+            fingerprint,
+            sourceFiles: sortedSourceFiles,
+            seedIds: [],
         };
     }
     if (!ELIGIBLE_RISK_CLASSES.has(params.riskClass)) {
@@ -45,7 +61,7 @@ export function deriveBriefIntent(params) {
             eligible: false,
             reason: `Ineligible: riskClass ${params.riskClass} is not auto-brief eligible`,
             fingerprint,
-            sourceFiles,
+            sourceFiles: sortedSourceFiles,
             seedIds,
         };
     }
@@ -54,7 +70,7 @@ export function deriveBriefIntent(params) {
             eligible: false,
             reason: `Ineligible: posture ${params.posture} is not authoritative`,
             fingerprint,
-            sourceFiles,
+            sourceFiles: sortedSourceFiles,
             seedIds,
         };
     }
@@ -63,7 +79,7 @@ export function deriveBriefIntent(params) {
             eligible: false,
             reason: "Ineligible: maintenance is degraded",
             fingerprint,
-            sourceFiles,
+            sourceFiles: sortedSourceFiles,
             seedIds,
         };
     }
@@ -71,11 +87,12 @@ export function deriveBriefIntent(params) {
         eligible: true,
         reason: "Eligible for auto-briefing",
         fingerprint,
-        sourceFiles,
+        sourceFiles: nonOperationalSourceFiles,
         seedIds,
     };
 }
-export function computeBriefIntent(// implements REQ-opencode-kibi-briefing-v2
+export function computeBriefIntent(
+// implements REQ-opencode-kibi-briefing-v2
 inputs) {
     return deriveBriefIntent({
         riskClass: inputs.riskClass,
@@ -83,7 +100,43 @@ inputs) {
         maintenanceDegraded: inputs.maintenanceDegraded,
         workspaceRoot: inputs.worktreeRoot,
         branch: inputs.branch,
-        editedFilePath: inputs.editedFile,
+        sourceFiles: inputs.sourceFiles,
+        ...(inputs.focusFilePath !== undefined
+            ? { focusFilePath: inputs.focusFilePath }
+            : {}),
         ...(inputs.seedIds !== undefined ? { seedIds: inputs.seedIds } : {}),
     });
 }
+export function buildBriefingContext(
+// implements REQ-opencode-kibi-briefing-v6
+params) {
+    const sourceFiles = [...new Set(params.sourceFiles)].sort();
+    const seen = new Set();
+    const seeds = [];
+    // Take first 3 changed entity IDs in original order, dedupe, sort
+    if (params.changedEntityIds) {
+        for (const id of params.changedEntityIds.slice(0, 3)) {
+            if (!seen.has(id)) {
+                seeds.push(id);
+                seen.add(id);
+            }
+        }
+    }
+    // Fill remaining slots from seedIds in original order
+    if (params.seedIds) {
+        for (const id of params.seedIds) {
+            if (seeds.length >= 5)
+                break;
+            if (!seen.has(id)) {
+                seeds.push(id);
+                seen.add(id);
+            }
+        }
+    }
+    // Sort final seedIds alphabetically
+    seeds.sort((a, b) => a.localeCompare(b));
+    return {
+        sourceFiles,
+        seedIds: seeds,
+    };
+}

package/dist/briefing-runtime.js

@@ -4,6 +4,7 @@ const WORKER_TITLE = "Kibi Auto Brief Worker";
 const READY_TOAST = "Kibi brief ready — summary added to guidance.";
 const TLDR_FALLBACK_TOAST = "Kibi brief summary added — use /brief-kibi for full details.";
 const UNAVAILABLE_TOAST = "Kibi brief unavailable — keeping /brief-kibi manual path.";
+const DEFAULT_WHY_IT_MATTERS = "This update changes how current project knowledge should be interpreted.";
 const PROMPT_INSTRUCTION = "Call only kb_briefing_generate once with the provided sourceFiles and seedIds. If briefingState is ready, copy only cited fields. If briefingState is no_briefing, return empty promptBlock/citations and keep manual cue availability. Never invent claims.";
 const PROMPT_FORMAT = {
     type: "json_schema",
@@ -140,7 +141,7 @@ function normalizeResult(payload) {
     if (briefingState === "ready" && tldr) {
         return {
             state: "tldr_fallback",
-            promptBlock: `- ${tldr}\n- Full details: run /brief-kibi.`,
+            promptBlock: `- What changed: ${tldr}\n- Why it matters: ${DEFAULT_WHY_IT_MATTERS}`,
             tldr,
             citations: [],
             showManualCue: true,

package/dist/config.d.ts

@@ -15,6 +15,9 @@ export interface KibiConfig {
         toastFailures: boolean;
         toastSuccesses: boolean;
         toastCooldownMs: number;
+        briefs?: {
+            autoSubmit: boolean;
+        };
     };
     guidance: {
         dynamic: boolean;

package/dist/config.js

@@ -11,6 +11,9 @@ const DEFAULTS = {
         toastFailures: true,
         toastSuccesses: false,
         toastCooldownMs: 10000,
+        briefs: {
+            autoSubmit: true,
+        },
     },
     guidance: {
         dynamic: true,
@@ -100,6 +103,12 @@ export function validateAndMerge(obj) {
             out.ux.toastSuccesses = u.toastSuccesses;
         if (typeof u.toastCooldownMs === "number")
             out.ux.toastCooldownMs = u.toastCooldownMs;
+        if (u.briefs && typeof u.briefs === "object") {
+            const b = u.briefs;
+            out.ux.briefs = { autoSubmit: true };
+            if (typeof b.autoSubmit === "boolean")
+                out.ux.briefs.autoSubmit = b.autoSubmit;
+        }
     }
     if (typeof src.logLevel === "string")
         out.logLevel = src.logLevel;

package/dist/e2e-coverage-signals.d.ts

@@ -0,0 +1,6 @@
+export interface E2eCoverageSignal {
+    level: "exact" | "heuristic" | "none";
+    evidence: string[];
+    reminderText: string | null;
+}
+export declare function getE2eCoverageSignal(worktree: string, filePath: string): E2eCoverageSignal;