pi-advisor-flow 0.9.2-dev.4 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-advisor-flow",
-  "version": "0.9.2-dev.4",
+  "version": "0.10.0",
   "description": "Advanced Executor/Advisor flow for Pi, fully configurable and extendable.",
   "keywords": [
     "advisor",
@@ -55,7 +55,7 @@
     "@earendil-works/pi-coding-agent": "1.0.0",
     "@earendil-works/pi-tui": "1.0.0",
     "@oxlint/plugins": "1.86.0",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.4",
     "@typesafe-ai/sdk": "^0.6.0",
     "bun-types": "1.4.2",
     "husky": "^9.1.7",

package/src/commands/activation-preparation.ts

@@ -2,11 +2,13 @@ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 import {
   advisorEffortRef,
+  advisorFallbackModelRef,
   advisorRef,
   executorEffortRef,
   executorRef,
   getPersistedModelRefs,
   setAdvisorEffortRef,
+  setAdvisorFallbackModelRef,
   setAdvisorRef,
   setExecutorEffortRef,
   setExecutorRef,
@@ -99,6 +101,7 @@ export const prepareActivationModels = async (
   const selection = await selectAdvisorModels(ctx, {
     advisor: advisorOverride || persisted.advisor ? advisorRef : "",
     advisorEffort: advisorEffortRef,
+    advisorFallbackModel: advisorFallbackModelRef,
     executor:
       executorOverride || plan.pendingExecutor || persisted.executor
         ? executorRef
@@ -111,6 +114,7 @@ export const prepareActivationModels = async (
     return;
   }
   setAdvisorRef(selection.advisor);
+  setAdvisorFallbackModelRef(selection.advisorFallbackModel);
   setAdvisorEffortRef(selection.advisorEffort);
   setExecutorRef(selection.executor);
   setExecutorEffortRef(selection.executorEffort);

package/src/commands/manual-consultation.ts

@@ -14,7 +14,11 @@ import { notify } from "./runtime.ts";
 import type { CommandRuntime, ManualAdvisorProgressState } from "./types.ts";
 
 interface ManualResultDetails {
+  adviceId?: string;
   advisor: string;
+  agentRulesBytes?: number;
+  followUp?: boolean;
+  preferenceBytes?: number;
   question?: string;
   text: string;
   usage?: AdvisorUsageSnapshot;
@@ -48,7 +52,15 @@ export const startManualConsultation = async (
   const finishHerdrActivity = runtime.herdrActivity.start();
   let scoutDetails: ScoutToolDetails | undefined;
   try {
-    const { adviceId, markdown, usage } = await runtime.requestAdvisor(
+    const {
+      adviceId,
+      agentRulesBytes,
+      followUp,
+      markdown,
+      model,
+      preferenceBytes,
+      usage,
+    } = await runtime.requestAdvisor(
       ctx,
       question,
       controller.signal,
@@ -84,8 +96,9 @@ export const startManualConsultation = async (
     runtime.advisorSessionState.recordInvocation({
       cost: advisorUsageCost(usage),
       executionEffect: "continued",
+      followUp,
       kind: "markdown",
-      model: advisorRef,
+      model: model ?? advisorRef,
       trigger: "manual",
       usage,
     });
@@ -102,7 +115,11 @@ export const startManualConsultation = async (
     }
     runtime.updateAdvisorUsageStatus(ctx);
     const details: ManualResultDetails = {
-      advisor: advisorRef,
+      adviceId,
+      advisor: model ?? advisorRef,
+      agentRulesBytes,
+      followUp,
+      preferenceBytes,
       question,
       text: markdown,
     };

package/src/commands/model-commands.ts

@@ -1,10 +1,12 @@
 import {
   advisorEffortRef,
+  advisorFallbackModelRef,
   advisorRef,
   executorEffortRef,
   executorRef,
   getPersistedModelRefs,
   setAdvisorEffortRef,
+  setAdvisorFallbackModelRef,
   setAdvisorRef,
   setExecutorEffortRef,
   setExecutorRef,
@@ -24,7 +26,7 @@ export const registerModelCommands = (runtime: CommandRuntime) => {
 
   runtime.pi.registerCommand("advisor-models", {
     description:
-      "Select and persist the Executor and Advisor models with reasoning levels",
+      "Select and persist the Executor, Advisor, and optional fallback models with reasoning levels",
     handler: async (_args, ctx) => {
       if (!(loadCommandConfig(ctx) && ctx.hasUI)) {
         return;
@@ -36,6 +38,7 @@ export const registerModelCommands = (runtime: CommandRuntime) => {
       const selection = await selectAdvisorModels(ctx, {
         advisor: persisted.advisor ? advisorRef : "",
         advisorEffort: advisorEffortRef,
+        advisorFallbackModel: advisorFallbackModelRef,
         executor:
           runtime.pendingExecutorModelRef ??
           (persisted.executor ? executorRef : ""),
@@ -49,6 +52,7 @@ export const registerModelCommands = (runtime: CommandRuntime) => {
 
       setExecutorRef(selection.executor);
       setAdvisorRef(selection.advisor);
+      setAdvisorFallbackModelRef(selection.advisorFallbackModel);
       setExecutorEffortRef(selection.executorEffort);
       setAdvisorEffortRef(selection.advisorEffort);
 

package/src/commands/model-picker.ts

@@ -1,6 +1,7 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 import { SearchableModelSelector } from "../ui/model-selector.ts";
+import { FALLBACK_ADVISOR_MODEL_DISABLED } from "../ui/types.ts";
 import {
   effortChoices,
   getAvailableModelRefs,
@@ -10,6 +11,7 @@ import {
 export interface AdvisorModelSelection {
   advisor: string;
   advisorEffort: string | undefined;
+  advisorFallbackModel: string | undefined;
   executor: string;
   executorEffort: string | undefined;
 }
@@ -17,6 +19,7 @@ export interface AdvisorModelSelection {
 export interface AdvisorModelPickerOptions {
   advisor: string | undefined;
   advisorEffort: string | undefined;
+  advisorFallbackModel: string | undefined;
   executor: string | undefined;
   executorEffort: string | undefined;
   selectAdvisor: boolean;
@@ -46,7 +49,13 @@ export const selectAdvisorModels = async (
         )
     ),
   ];
-  let { advisor, advisorEffort, executor, executorEffort } = options;
+  let {
+    advisor,
+    advisorEffort,
+    advisorFallbackModel,
+    executor,
+    executorEffort,
+  } = options;
 
   if (options.selectExecutor) {
     const selectedExecutor = await ctx.ui.custom<string | undefined>(
@@ -104,8 +113,41 @@ export const selectAdvisorModels = async (
     advisorEffort = selectedEffort(selectedAdvisorEffort);
   }
 
+  const selectedFallback = await ctx.ui.custom<string | undefined>(
+    (tui, theme, keybindings, done) =>
+      new SearchableModelSelector({
+        allOptions: [
+          FALLBACK_ADVISOR_MODEL_DISABLED,
+          ...new Set([
+            ...allOptions,
+            ...(refs || !advisorFallbackModel ? [] : [advisorFallbackModel]),
+          ]),
+        ],
+        currentOption: advisorFallbackModel ?? FALLBACK_ADVISOR_MODEL_DISABLED,
+        keybindings,
+        onCancel: () => done(undefined),
+        onSelect: done,
+        theme,
+        title: "Select Fallback Advisor Model (optional)",
+        tui,
+      })
+  );
+  if (selectedFallback === undefined) {
+    return undefined;
+  }
+  advisorFallbackModel =
+    selectedFallback === FALLBACK_ADVISOR_MODEL_DISABLED
+      ? undefined
+      : selectedFallback;
+
   if (!(advisor && executor)) {
     return undefined;
   }
-  return { advisor, advisorEffort, executor, executorEffort };
+  return {
+    advisor,
+    advisorEffort,
+    advisorFallbackModel,
+    executor,
+    executorEffort,
+  };
 };

package/src/commands/outcome-stats.ts

@@ -0,0 +1,98 @@
+import { aggregateOutcomeRecords, readOutcomeLog } from "../outcome-stats.ts";
+import type { OutcomeStats } from "../outcome-stats.ts";
+import { OUTCOME_LOG_MAX_BYTES } from "../outcomes.ts";
+import type { CommandRuntime } from "./types.ts";
+
+export interface AdvisorStatsDetails {
+  error?: string;
+  malformedLines: number;
+  stats?: OutcomeStats;
+}
+
+const percent = (rate: number | undefined) =>
+  rate === undefined ? "n/a" : `${(rate * 100).toFixed(1)}%`;
+
+const validatedCount = (value: { failed: number; passed: number }) =>
+  value.failed + value.passed;
+
+const timestamp = (value: string | undefined) =>
+  value ? new Date(value).toLocaleString() : "n/a";
+
+export const formatAdvisorStats = ({
+  error,
+  malformedLines,
+  stats,
+}: AdvisorStatsDetails): string => {
+  if (error) {
+    return `**Could not read Advisor outcomes.**\n\n${error}`;
+  }
+  if (!stats || stats.total === 0) {
+    const ignored = malformedLines
+      ? `\n\nIgnored ${malformedLines} malformed ledger line${malformedLines === 1 ? "" : "s"}.`
+      : "";
+    return `**No Advisor outcomes recorded yet.**\n\nEnable outcome logging and record an outcome after an Advisor response to build this report.${ignored}`;
+  }
+  const { validationByAdoption } = stats;
+  const { followed } = validationByAdoption;
+  const notFollowed = validationByAdoption["not-followed"];
+  const triggerLines = Object.entries(stats.byTrigger).map(
+    ([trigger, count]) => `- ${trigger}: ${count}`
+  );
+  const adoptionLines = Object.entries(stats.adoption).map(
+    ([adoption, count]) => `- ${adoption}: ${count}`
+  );
+  const validationLines = [
+    `- followed: ${percent(followed.passRate)} passed (${followed.passed}/${validatedCount(followed)})`,
+    `- not-followed: ${percent(notFollowed.passRate)} passed (${notFollowed.passed}/${validatedCount(notFollowed)})`,
+  ];
+  const ignored = malformedLines
+    ? `\n\nIgnored ${malformedLines} malformed ledger line${malformedLines === 1 ? "" : "s"}.`
+    : "";
+  return [
+    `**${stats.total} Advisor outcome${stats.total === 1 ? "" : "s"}**`,
+    "",
+    "**By trigger**",
+    ...triggerLines,
+    "",
+    "**Adoption**",
+    ...adoptionLines,
+    "",
+    "**Validation passed rate (passed / passed + failed)**",
+    ...validationLines,
+    "",
+    `Distinct advices seen: ${stats.distinctAdvices}`,
+    `Time window: ${timestamp(stats.firstTimestamp)} → ${timestamp(stats.lastTimestamp)}`,
+    `Ledger window: capped at ${OUTCOME_LOG_MAX_BYTES / (1024 * 1024)} MiB and rewritten on overflow; this report covers only retained records.${ignored}`,
+  ].join("\n");
+};
+
+const readAdvisorStats = async (): Promise<AdvisorStatsDetails> => {
+  try {
+    const log = await readOutcomeLog();
+    const stats = aggregateOutcomeRecords(log.records, log.malformedLines);
+    return { malformedLines: log.malformedLines, stats };
+  } catch (error) {
+    return {
+      error: error instanceof Error ? error.message : String(error),
+      malformedLines: 0,
+    };
+  }
+};
+
+export const registerOutcomeStatsCommand = (runtime: CommandRuntime) => {
+  runtime.pi.registerCommand("advisor-stats", {
+    description: "Show retained Advisor outcome adoption and validation stats",
+    handler: async (_args, _ctx) => {
+      const details = await readAdvisorStats();
+      runtime.pi.sendMessage(
+        {
+          content: [],
+          customType: "advisor-stats-result",
+          details,
+          display: true,
+        },
+        { deliverAs: "steer", triggerTurn: false }
+      );
+    },
+  });
+};

package/src/commands/registration.ts

@@ -7,6 +7,7 @@ import { activateAdvisor } from "./activation.ts";
 import { registerCommandLifecycle } from "./lifecycle.ts";
 import { registerManualCommand } from "./manual-command.ts";
 import { registerModelCommands } from "./model-commands.ts";
+import { registerOutcomeStatsCommand } from "./outcome-stats.ts";
 import { registerCommandRenderers } from "./renderers.ts";
 import { createCommandRuntime } from "./runtime.ts";
 import { registerSettingsCommands } from "./settings-commands.ts";
@@ -24,5 +25,6 @@ export const registerCommands = (
   registerCommandLifecycle(runtime, activate);
   registerManualCommand(runtime);
   registerModelCommands(runtime);
+  registerOutcomeStatsCommand(runtime);
   registerSettingsCommands(runtime);
 };

package/src/commands/renderers.ts

@@ -15,6 +15,8 @@ import {
 } from "../tools/render-common.ts";
 import { formatAdvisorUsage } from "../usage.ts";
 import { ManualAdvisorProgressComponent } from "./manual-progress.ts";
+import { formatAdvisorStats } from "./outcome-stats.ts";
+import type { AdvisorStatsDetails } from "./outcome-stats.ts";
 import type { CommandRuntime } from "./types.ts";
 
 interface ManualCallEntryDetails {
@@ -24,10 +26,22 @@ interface ManualCallEntryDetails {
 
 interface ManualResultDetails {
   advisor?: string;
+  agentRulesBytes?: number;
+  preferenceBytes?: number;
   text?: string;
   usage?: unknown;
 }
 
+const formatByteSize = (bytes: number) => {
+  if (bytes >= 1024 * 1024) {
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+  }
+  if (bytes >= 1024) {
+    return `${Math.round(bytes / 1024)} KiB`;
+  }
+  return `${bytes} B`;
+};
+
 const manualCallRenderer =
   (runtime: CommandRuntime): EntryRenderer<ManualCallEntryDetails> =>
   (entry, { expanded }, theme) => {
@@ -70,12 +84,45 @@ const manualResultRenderer: MessageRenderer<ManualResultDetails> = (
       box.addChild(new Text(theme.fg("dim", `  Usage: ${usage}`), 0, 0));
     }
   }
+  const attachments = [
+    details?.agentRulesBytes
+      ? `AGENTS.md rules attached · ${formatByteSize(details.agentRulesBytes)}`
+      : undefined,
+    details?.preferenceBytes
+      ? `Project preferences attached · ${formatByteSize(details.preferenceBytes)}`
+      : undefined,
+  ].filter((value): value is string => value !== undefined);
+  if (attachments.length) {
+    box.addChild(
+      new Text(theme.fg("dim", `  ${attachments.join(" · ")}`), 0, 0)
+    );
+  }
   box.addChild(
     new Markdown(adviceForDisplay(advice, expanded), 0, 0, getMarkdownTheme())
   );
   return box;
 };
 
+const outcomeStatsRenderer: MessageRenderer<AdvisorStatsDetails> = (
+  message,
+  _options,
+  theme
+) => {
+  const box = new Box(1, 1, (text) => theme.bg("customMessageBg", text));
+  box.addChild(
+    new Text(theme.fg("accent", theme.bold("◆ ADVISOR · OUTCOME STATS")), 0, 0)
+  );
+  box.addChild(
+    new Markdown(
+      formatAdvisorStats(message.details ?? { malformedLines: 0 }),
+      0,
+      0,
+      getMarkdownTheme()
+    )
+  );
+  return box;
+};
+
 export const registerCommandRenderers = (runtime: CommandRuntime) => {
   runtime.pi.registerEntryRenderer?.(
     "advisor-manual-call",
@@ -85,4 +132,8 @@ export const registerCommandRenderers = (runtime: CommandRuntime) => {
     "advisor-manual-result",
     manualResultRenderer
   );
+  runtime.pi.registerMessageRenderer?.(
+    "advisor-stats-result",
+    outcomeStatsRenderer
+  );
 };

package/src/commands/runtime.ts

@@ -77,7 +77,15 @@ class CommandRuntime implements CommandRuntimeContract {
           undefined,
           undefined,
           undefined,
-          onScout
+          onScout,
+          undefined,
+          undefined,
+          (adviceId, payload, replacesAdviceId) =>
+            this.advisorSessionState.captureFollowUp(
+              adviceId,
+              payload,
+              replacesAdviceId
+            )
         ));
   }
 

package/src/commands/settings-persistence.ts

@@ -3,6 +3,7 @@ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import {
   getAdvisorSettings,
   getPersistedModelRefs,
+  setAdvisorAgentsMdContextRef,
   setAdvisorAutoLoopGateRef,
   setAdvisorBlockOnBlockedRef,
   setAdvisorCollapseResponsesRef,
@@ -10,6 +11,7 @@ import {
   setAdvisorCustomInvocationRef,
   setAdvisorDisableSameModelRef,
   setAdvisorEffortRef,
+  setAdvisorFallbackModelRef,
   setAdvisorFailureGateRef,
   setAdvisorFailureModeRef,
   setAdvisorGitContextMaxCharsRef,
@@ -68,6 +70,7 @@ const applySessionSettings = (settings: AdvisorSettings) => {
   );
   setContextMaxCharsRef(settings.contextMaxChars);
   setAdvisorPlanGateRef(settings.planGate);
+  setAdvisorFallbackModelRef(settings.fallbackModel);
   setAdvisorFailureGateRef(settings.failureGate);
   setAdvisorCompletionGateRef(settings.completionGate);
   setAdvisorDisableSameModelRef(settings.disableSameModel ?? true);
@@ -126,6 +129,7 @@ const applyDisclosureSettings = (settings: AdvisorSettings) => {
   setAdvisorGitContextRef(settings.gitContext ?? "summary");
   setAdvisorGitContextMaxCharsRef(settings.gitContextMaxChars ?? 20_000);
   setAdvisorToolPoliciesRef(settings.toolPolicies ?? {});
+  setAdvisorAgentsMdContextRef(settings.agentsMdContext ?? true);
   setAdvisorTrackedFileContentRef(settings.trackedFileContent ?? false);
   setAdvisorUntrackedContentRef(settings.untrackedContent ?? false);
   setAdvisorOutcomeLoggingRef(settings.outcomeLogging ?? false);

package/src/commands/types.ts

@@ -19,10 +19,13 @@ export type ManualConsult = (
   gitContext?: GitContextLevel
 ) => Promise<{
   adviceId?: string;
-  markdown: string;
-  thinkingText: string;
+  agentRulesBytes?: number;
   draftBytes?: number;
+  followUp?: boolean;
+  markdown: string;
+  model?: string;
   preferenceBytes?: number;
+  thinkingText: string;
   usage?: unknown;
 }>;
 

package/src/config/defaults.ts

@@ -1,4 +1,5 @@
 import {
+  setAdvisorAgentsMdContextRef,
   setAdvisorAutoLoopGateRef,
   setAdvisorBlockOnBlockedRef,
   setAdvisorCollapseResponsesRef,
@@ -29,6 +30,7 @@ import {
   setAdvisorPlanGateRef,
   setAdvisorRedactSecretsRef,
   setAdvisorRef,
+  setAdvisorFallbackModelRef,
   setAdvisorScoutEnabledRef,
   setAdvisorScoutTimeoutMsRef,
   setAdvisorSessionSummaryRef,
@@ -68,6 +70,8 @@ import {
 export const resetDefaults = () => {
   setExecutorRef("");
   setAdvisorRef("");
+  setAdvisorFallbackModelRef(undefined);
+  setAdvisorAgentsMdContextRef(true);
   setPersistedModelRefs(undefined, undefined);
   setExecutorEffortRef(undefined);
   setAdvisorEffortRef(undefined);
@@ -137,8 +141,17 @@ const applyNonEmptyStringConfig = (
 export const applyConfig = (config: AdvisorConfig) => {
   applyNonEmptyStringConfig(config.executor, setExecutorRef);
   applyNonEmptyStringConfig(config.advisor, setAdvisorRef);
+  applyNonEmptyStringConfig(
+    config.advisorFallbackModel,
+    setAdvisorFallbackModelRef
+  );
   applyNonEmptyStringConfig(config.executorEffort, setExecutorEffortRef);
   applyNonEmptyStringConfig(config.advisorEffort, setAdvisorEffortRef);
+  applyOptionalConfig(
+    config,
+    "advisorAgentsMdContext",
+    setAdvisorAgentsMdContextRef
+  );
   applyOptionalConfig(config, "contextMaxChars", setContextMaxCharsRef);
   applyOptionalConfig(config, "advisorPlanGate", setAdvisorPlanGateRef);
   applyOptionalConfig(config, "advisorFailureGate", setAdvisorFailureGateRef);

package/src/config/schema.ts

@@ -2,6 +2,7 @@ import { isString } from "../content-utils.ts";
 import type { JsonValue } from "../content-utils.ts";
 import { GIT_CONTEXT_LEVELS, isValidGitContextLevel } from "../git.ts";
 import {
+  advisorAgentsMdContextRef,
   advisorAutoLoopGateRef,
   advisorBlockOnBlockedRef,
   advisorCollapseResponsesRef,
@@ -9,6 +10,7 @@ import {
   advisorCustomInvocationRef,
   advisorDisableSameModelRef,
   advisorEffortRef,
+  advisorFallbackModelRef,
   advisorFailureGateRef,
   advisorFailureModeRef,
   advisorGitContextMaxCharsRef,
@@ -171,6 +173,12 @@ export const CONFIG_SCHEMA = {
     persisted: true,
     type: "string",
   },
+  advisorAgentsMdContext: {
+    accepted: "true or false",
+    current: () => advisorAgentsMdContextRef,
+    persisted: true,
+    type: "boolean",
+  },
   advisorAutoLoopGate: {
     accepted: "true or false",
     current: () => advisorAutoLoopGateRef,
@@ -219,6 +227,12 @@ export const CONFIG_SCHEMA = {
     persisted: true,
     type: "boolean",
   },
+  advisorFallbackModel: {
+    accepted: "a provider/model string",
+    current: () => configuredModelRef(advisorFallbackModelRef),
+    persisted: true,
+    type: "string",
+  },
   advisorGitContext: {
     accepted: GIT_CONTEXT_LEVELS.join(", "),
     current: () => advisorGitContextRef,

package/src/config/state.ts

@@ -25,6 +25,8 @@ import type {
 // An empty ref means no model has been selected yet.
 export let executorRef = "";
 export let advisorRef = "";
+export let advisorFallbackModelRef: string | undefined;
+export let advisorAgentsMdContextRef = true;
 let persistedExecutorRef: string | undefined;
 let persistedAdvisorRef: string | undefined;
 export let executorEffortRef: string | undefined;
@@ -80,6 +82,12 @@ export const setExecutorRef = (ref: string) => {
 export const setAdvisorRef = (ref: string) => {
   advisorRef = ref;
 };
+export const setAdvisorFallbackModelRef = (ref: string | undefined) => {
+  advisorFallbackModelRef = ref?.trim() || undefined;
+};
+export const setAdvisorAgentsMdContextRef = (enabled: boolean) => {
+  advisorAgentsMdContextRef = enabled;
+};
 /** Returns model refs explicitly persisted in the global Advisor config. */
 export const getPersistedModelRefs = () => ({
   advisor: persistedAdvisorRef,
@@ -234,6 +242,7 @@ export const setShowUsageFooterRef = (enabled: boolean) => {
  * imported mutable bindings, which can be snapshotted by extension loaders.
  */
 export const getAdvisorSettings = () => ({
+  agentsMdContext: advisorAgentsMdContextRef,
   alwaysOn: alwaysOnRef,
   autoLoopGate: advisorAutoLoopGateRef,
   blockOnBlocked: advisorBlockOnBlockedRef,
@@ -245,6 +254,7 @@ export const getAdvisorSettings = () => ({
   effort: advisorEffortRef,
   failureGate: advisorFailureGateRef,
   failureMode: advisorFailureModeRef,
+  fallbackModel: advisorFallbackModelRef,
   gitContext: advisorGitContextRef,
   gitContextMaxChars: advisorGitContextMaxCharsRef,
   herdrIntegration: advisorHerdrIntegrationRef,

package/src/config/types.ts

@@ -60,6 +60,8 @@ export const GATE_FAILURE_MODES: GateFailureMode[] = [
 
 export interface AdvisorConfig {
   advisor?: string;
+  advisorFallbackModel?: string;
+  advisorAgentsMdContext?: boolean;
   advisorAutoLoopGate?: boolean;
   advisorBlockOnBlocked?: boolean;
   advisorCollapseResponses?: boolean;

package/src/config.ts

@@ -1,12 +1,14 @@
 // biome-ignore lint/performance/noBarrelFile: this facade intentionally preserves the public config module contract.
 export { parseArgs } from "./config/args.ts";
 export {
+  advisorAgentsMdContextRef,
   advisorAutoLoopGateRef,
   advisorBlockOnBlockedRef,
   advisorCollapseResponsesRef,
   advisorCompletionGateRef,
   advisorCustomInvocationRef,
   advisorEffortRef,
+  advisorFallbackModelRef,
   advisorFailureGateRef,
   advisorFailureModeRef,
   advisorGitContextMaxCharsRef,
@@ -34,12 +36,14 @@ export {
   getAdvisorSettings,
   getPersistedModelRefs,
   isSimpleMode,
+  setAdvisorAgentsMdContextRef,
   setAdvisorAutoLoopGateRef,
   setAdvisorBlockOnBlockedRef,
   setAdvisorCollapseResponsesRef,
   setAdvisorCompletionGateRef,
   setAdvisorCustomInvocationRef,
   setAdvisorEffortRef,
+  setAdvisorFallbackModelRef,
   setAdvisorFailureGateRef,
   setAdvisorFailureModeRef,
   setAdvisorGitContextMaxCharsRef,