@event4u/agent-config 9.27.0 → 9.29.0

package/dist/mcp/server.mjs

@@ -129,6 +129,7 @@ __export(agent_settings_exports, {
   PROJECT_ROOT_ENV: () => PROJECT_ROOT_ENV,
   ProjectRootError: () => ProjectRootError,
   ROOT_OVERRIDE_ENV: () => ROOT_OVERRIDE_ENV,
+  USER_GLOBAL_CANONICAL_RELATIVE: () => USER_GLOBAL_CANONICAL_RELATIVE,
   USER_GLOBAL_FILENAME: () => USER_GLOBAL_FILENAME,
   canonical_settings_write_path: () => canonical_settings_write_path,
   enumerate_modules: () => enumerate_modules,
@@ -140,7 +141,8 @@ __export(agent_settings_exports, {
   load_agent_settings: () => load_agent_settings,
   logger: () => logger,
   project_settings_path: () => project_settings_path,
-  resolve_project_root: () => resolve_project_root
+  resolve_project_root: () => resolve_project_root,
+  user_global_settings_paths: () => user_global_settings_paths
 });
 import { createRequire } from "node:module";
 import * as fs3 from "node:fs";
@@ -192,12 +194,20 @@ function canonical_settings_write_path(project_root) {
 function DEFAULT_USER_GLOBAL_FILE() {
   return write_target(USER_GLOBAL_FILENAME);
 }
-function _resolve_user_global_file() {
-  const found = resolve_with_fallback(USER_GLOBAL_FILENAME);
-  if (found !== null) {
-    return found;
+function user_global_settings_paths() {
+  const paths = [];
+  const flat = resolve_with_fallback(USER_GLOBAL_FILENAME);
+  if (flat !== null) {
+    paths.push(flat);
   }
-  return DEFAULT_USER_GLOBAL_FILE();
+  const canonical = resolve_with_fallback(USER_GLOBAL_CANONICAL_RELATIVE);
+  if (canonical !== null) {
+    paths.push(canonical);
+  }
+  if (paths.length === 0) {
+    paths.push(DEFAULT_USER_GLOBAL_FILE());
+  }
+  return paths;
 }
 function _exists(p) {
   try {
@@ -442,7 +452,10 @@ function load_agent_settings(options = {}) {
   const user_global_path = options.user_global_path ?? null;
   const verbose = options.verbose ?? false;
   const cwd = options.cwd ?? null;
-  const user_global_raw = _read_yaml(user_global_path ? user_global_path : _resolve_user_global_file()) ?? {};
+  const user_global_raw = {};
+  for (const p of user_global_path ? [user_global_path] : user_global_settings_paths()) {
+    _deep_merge(user_global_raw, _read_yaml(p) ?? {});
+  }
   const [user_global_filtered, ignored] = _filter_whitelist(user_global_raw, MERGEABLE_KEYS);
   if (verbose && ignored.length > 0) {
     logger.info(
@@ -459,8 +472,32 @@ function load_agent_settings(options = {}) {
       _deep_merge(merged, layer);
     }
   }
+  _warn_removed_always_on_keys(merged);
   return merged;
 }
+function _readDottedSettingsPath(root, dotted) {
+  let node = root;
+  for (const part of dotted.split(".")) {
+    if (typeof node !== "object" || node === null || Array.isArray(node)) {
+      return void 0;
+    }
+    node = node[part];
+  }
+  return node;
+}
+function _warn_removed_always_on_keys(merged) {
+  for (const key of REMOVED_ALWAYS_ON_KEYS) {
+    if (_warnedRemovedAlwaysOnKeys.has(key)) {
+      continue;
+    }
+    if (_readDottedSettingsPath(merged, key) === void 0) {
+      continue;
+    }
+    _warnedRemovedAlwaysOnKeys.add(key);
+    process.stderr.write(`${key} was removed (always-on orchestration); ignored.
+`);
+  }
+}
 function get_modules_config(options = {}) {
   const project_root = options.project_root ?? null;
   const team_path = options.team_path ?? null;
@@ -595,12 +632,11 @@ function* iter_setting_overrides(options = {}) {
   const project_path = options.project_path ?? null;
   const user_global_path = options.user_global_path ?? null;
   const cwd = options.cwd ?? null;
-  const user_global_path_resolved = user_global_path ? user_global_path : _resolve_user_global_file();
-  const user_global_raw = _read_yaml(user_global_path_resolved) ?? {};
-  const [user_global_filtered] = _filter_whitelist(user_global_raw, MERGEABLE_KEYS);
-  if (Object.keys(user_global_filtered).length > 0) {
-    for (const key of _leaf_paths(user_global_filtered)) {
-      yield [key, _get_dotted(user_global_filtered, key), user_global_path_resolved];
+  for (const p of user_global_path ? [user_global_path] : user_global_settings_paths()) {
+    const raw = _read_yaml(p) ?? {};
+    const [filtered] = _filter_whitelist(raw, MERGEABLE_KEYS);
+    for (const key of _leaf_paths(filtered)) {
+      yield [key, _get_dotted(filtered, key), p];
     }
   }
   for (const p of _resolve_cascade_paths(cwd, project_path)) {
@@ -741,7 +777,7 @@ function _relative_to(child, root) {
 function _posix_join(a, b) {
   return `${a.split(path3.sep).join("/")}/${b}`;
 }
-var _require, Logger, logger, DEFAULT_PROJECT_FILE, LOCAL_PROJECT_FILE, LOCAL_PROJECT_SUBDIR, DEFAULT_TEAM_FILE, USER_GLOBAL_FILENAME, MERGEABLE_KEYS, _DEFAULTS, MODULES_DEFAULTS, ANCHOR_AGENT_SETTINGS, ANCHOR_AGENTS_DIR, ANCHOR_GIT, _AGENTS_DIR_MARKERS, _LEGACY_ANCHOR_ENV, ORIGIN_ROOT_FLAG, ORIGIN_EXPLICIT, ORIGIN_ENV, ORIGIN_CWD_FALLBACK, PROJECT_ROOT_ENV, ROOT_OVERRIDE_ENV, ProjectRootError;
+var _require, Logger, logger, DEFAULT_PROJECT_FILE, LOCAL_PROJECT_FILE, LOCAL_PROJECT_SUBDIR, DEFAULT_TEAM_FILE, USER_GLOBAL_FILENAME, USER_GLOBAL_CANONICAL_RELATIVE, MERGEABLE_KEYS, _DEFAULTS, MODULES_DEFAULTS, ANCHOR_AGENT_SETTINGS, ANCHOR_AGENTS_DIR, ANCHOR_GIT, _AGENTS_DIR_MARKERS, _LEGACY_ANCHOR_ENV, ORIGIN_ROOT_FLAG, ORIGIN_EXPLICIT, ORIGIN_ENV, ORIGIN_CWD_FALLBACK, PROJECT_ROOT_ENV, ROOT_OVERRIDE_ENV, ProjectRootError, REMOVED_ALWAYS_ON_KEYS, _warnedRemovedAlwaysOnKeys;
 var init_agent_settings = __esm({
   "src/scripts/_lib/agent_settings.ts"() {
     "use strict";
@@ -763,12 +799,27 @@ var init_agent_settings = __esm({
     LOCAL_PROJECT_SUBDIR = ["agents", "settings"];
     DEFAULT_TEAM_FILE = ".agent-project-settings.yml";
     USER_GLOBAL_FILENAME = "agent-settings.yml";
+    USER_GLOBAL_CANONICAL_RELATIVE = "settings/.agent-settings.yml";
     MERGEABLE_KEYS = [
+      // `name`, `ide` and `personal.bot_icon` are the PRE-MIGRATION spellings.
+      // `install.ts` migrates `ide` → `personal.ide` and `pr_comment_bot_icon`
+      // into its `personal.` home, and this list was never moved with them — so
+      // the whitelist named keys the template does not have while the keys it
+      // does have were filtered out silently. A user setting either preference
+      // user-globally got no error, no warning, and no effect
+      // (road-to-capability-answerability 4.3, ADR-219).
+      //
+      // Both spellings are listed rather than replaced: a legacy file that still
+      // uses the old name keeps working, and nothing that resolved before
+      // resolves differently. `name` has no reader anywhere and no template key;
+      // it is kept only so this change stays purely additive.
       "name",
       "ide",
+      "personal.ide",
       "rule_loading_tier",
       "memory.cadence",
       "personal.bot_icon",
+      "personal.pr_comment_bot_icon",
       "personal.autonomy",
       "telegraph.speak_scope",
       // Knowledge-card global cross-project sharing is a USER-GLOBAL setting
@@ -816,6 +867,14 @@ var init_agent_settings = __esm({
         this.name = "ProjectRootError";
       }
     };
+    REMOVED_ALWAYS_ON_KEYS = [
+      "subagents.enabled",
+      "subagents.auto",
+      "subagents.host_capabilities",
+      "subagents.budget_routing",
+      "ai_team.enabled"
+    ];
+    _warnedRemovedAlwaysOnKeys = /* @__PURE__ */ new Set();
   }
 });
 
@@ -23814,8 +23873,19 @@ ${user_prompt}`;
         "429",
         "usage limit"
       ];
-      constructor(opts) {
+      /**
+       * `identity` carries the subclass constants (`name`, `default_binary`)
+       * that construction validates against. They are passed explicitly rather
+       * than read off `this.name` / `this.default_binary` because subclass
+       * instance-field initializers (`override default_binary = 'claude'`,
+       * declared in the subclass body) run only AFTER this `super()` call
+       * returns — reading them here, before that happens, would always see the
+       * base class's own field defaults (`''`), not the subclass override.
+       */
+      constructor(opts, identity) {
         super();
+        this.name = identity.name;
+        this.default_binary = identity.default_binary;
         this.model = opts.model;
         this.timeout_seconds = opts.timeout_seconds ?? DEFAULT_CLI_TIMEOUT_SECONDS;
         this.max_calls_per_day = opts.max_calls_per_day ?? null;
@@ -24020,18 +24090,19 @@ ${user_prompt}`;
       }
     };
     AnthropicCliClient = class extends CliClient {
-      name = "anthropic";
-      default_binary = "claude";
       subscription_label = "claude-pro";
       constructor(opts = {}) {
-        super({
-          model: opts.model ?? DEFAULT_ANTHROPIC_CLI_MODEL,
-          binary: opts.binary,
-          timeout_seconds: opts.timeout_seconds,
-          max_calls_per_day: opts.max_calls_per_day,
-          warn_at: opts.warn_at,
-          cli_calls_path: opts.cli_calls_path
-        });
+        super(
+          {
+            model: opts.model ?? DEFAULT_ANTHROPIC_CLI_MODEL,
+            binary: opts.binary,
+            timeout_seconds: opts.timeout_seconds,
+            max_calls_per_day: opts.max_calls_per_day,
+            warn_at: opts.warn_at,
+            cli_calls_path: opts.cli_calls_path
+          },
+          { name: "anthropic", default_binary: "claude" }
+        );
       }
       _build_command(system_prompt, user_prompt, max_tokens) {
         void user_prompt;
@@ -24091,8 +24162,6 @@ ${user_prompt}`;
       }
     };
     OpenAICliClient = class extends CliClient {
-      name = "openai";
-      default_binary = "codex";
       subscription_label = "chatgpt-plus";
       static _AUTH_FAILURE_PATTERNS = [
         ...CliClient._AUTH_FAILURE_PATTERNS,
@@ -24101,14 +24170,17 @@ ${user_prompt}`;
         "401"
       ];
       constructor(opts = {}) {
-        super({
-          model: opts.model ?? DEFAULT_OPENAI_CLI_MODEL,
-          binary: opts.binary,
-          timeout_seconds: opts.timeout_seconds,
-          max_calls_per_day: opts.max_calls_per_day,
-          warn_at: opts.warn_at,
-          cli_calls_path: opts.cli_calls_path
-        });
+        super(
+          {
+            model: opts.model ?? DEFAULT_OPENAI_CLI_MODEL,
+            binary: opts.binary,
+            timeout_seconds: opts.timeout_seconds,
+            max_calls_per_day: opts.max_calls_per_day,
+            warn_at: opts.warn_at,
+            cli_calls_path: opts.cli_calls_path
+          },
+          { name: "openai", default_binary: "codex" }
+        );
       }
       _build_command(system_prompt, user_prompt, max_tokens) {
         void max_tokens;
@@ -24197,8 +24269,6 @@ ${user_prompt}`;
       }
     };
     GeminiCliClient = class extends CliClient {
-      name = "gemini";
-      default_binary = "gemini";
       subscription_label = "gemini-pro";
       static _AUTH_FAILURE_PATTERNS = [
         ...CliClient._AUTH_FAILURE_PATTERNS,
@@ -24207,14 +24277,17 @@ ${user_prompt}`;
         "oauth"
       ];
       constructor(opts = {}) {
-        super({
-          model: opts.model ?? DEFAULT_GEMINI_CLI_MODEL,
-          binary: opts.binary,
-          timeout_seconds: opts.timeout_seconds,
-          max_calls_per_day: opts.max_calls_per_day,
-          warn_at: opts.warn_at,
-          cli_calls_path: opts.cli_calls_path
-        });
+        super(
+          {
+            model: opts.model ?? DEFAULT_GEMINI_CLI_MODEL,
+            binary: opts.binary,
+            timeout_seconds: opts.timeout_seconds,
+            max_calls_per_day: opts.max_calls_per_day,
+            warn_at: opts.warn_at,
+            cli_calls_path: opts.cli_calls_path
+          },
+          { name: "gemini", default_binary: "gemini" }
+        );
       }
       _build_command(system_prompt, user_prompt, max_tokens) {
         void user_prompt;
@@ -24289,8 +24362,6 @@ ${user_prompt}`;
       }
     };
     XAICliClient = class extends CliClient {
-      name = "xai";
-      default_binary = "grok";
       billable = true;
       // community CLI consumes an API key — billable applies
       static _AUTH_FAILURE_PATTERNS = [
@@ -24300,14 +24371,17 @@ ${user_prompt}`;
         "unauthorized"
       ];
       constructor(opts = {}) {
-        super({
-          model: opts.model ?? DEFAULT_XAI_MODEL,
-          binary: opts.binary,
-          timeout_seconds: opts.timeout_seconds,
-          max_calls_per_day: opts.max_calls_per_day,
-          warn_at: opts.warn_at,
-          cli_calls_path: opts.cli_calls_path
-        });
+        super(
+          {
+            model: opts.model ?? DEFAULT_XAI_MODEL,
+            binary: opts.binary,
+            timeout_seconds: opts.timeout_seconds,
+            max_calls_per_day: opts.max_calls_per_day,
+            warn_at: opts.warn_at,
+            cli_calls_path: opts.cli_calls_path
+          },
+          { name: "xai", default_binary: "grok" }
+        );
       }
       _build_command(system_prompt, user_prompt, max_tokens) {
         void system_prompt;
@@ -24333,8 +24407,6 @@ ${user_prompt}`;
       }
     };
     PerplexityCliClient = class extends CliClient {
-      name = "perplexity";
-      default_binary = "perplexity";
       billable = true;
       // community CLI consumes an API key — billable applies
       static _AUTH_FAILURE_PATTERNS = [
@@ -24344,14 +24416,17 @@ ${user_prompt}`;
         "unauthorized"
       ];
       constructor(opts = {}) {
-        super({
-          model: opts.model ?? DEFAULT_PERPLEXITY_MODEL,
-          binary: opts.binary,
-          timeout_seconds: opts.timeout_seconds,
-          max_calls_per_day: opts.max_calls_per_day,
-          warn_at: opts.warn_at,
-          cli_calls_path: opts.cli_calls_path
-        });
+        super(
+          {
+            model: opts.model ?? DEFAULT_PERPLEXITY_MODEL,
+            binary: opts.binary,
+            timeout_seconds: opts.timeout_seconds,
+            max_calls_per_day: opts.max_calls_per_day,
+            warn_at: opts.warn_at,
+            cli_calls_path: opts.cli_calls_path
+          },
+          { name: "perplexity", default_binary: "perplexity" }
+        );
       }
       _build_command(system_prompt, user_prompt, max_tokens) {
         void system_prompt;
@@ -24804,6 +24879,7 @@ function _build_config(raw, source_path) {
   const cli_call_budget = _build_cli_call_budget(
     _asDict(_getOr(raw, "cli_call_budget", {}))
   );
+  const quorum = _build_quorum(_get(raw, "quorum", "majority"));
   const necessity_classifier = _build_necessity_classifier(
     _asDict(_getOr(raw, "necessity_classifier", {}))
   );
@@ -24829,6 +24905,7 @@ function _build_config(raw, source_path) {
     "debate_gates"
   );
   const restate = _build_restate(_asDict(_getOr(raw, "restate", {})), "restate");
+  const critic_protocol = _build_critic_protocol(_getOr(raw, "critic_protocol", "legacy"));
   const decision_resolution = _build_decision_resolution(
     _asDict(_getOr(raw, "decision_resolution", {}))
   );
@@ -24850,6 +24927,7 @@ function _build_config(raw, source_path) {
     advisors,
     consensus_scoring: consensus,
     cli_call_budget,
+    quorum,
     necessity_classifier,
     model_downgrade,
     debate,
@@ -24858,6 +24936,7 @@ function _build_config(raw, source_path) {
     chairman,
     debate_gates,
     restate,
+    critic_protocol,
     decision_resolution,
     routing,
     low_impact,
@@ -25059,6 +25138,15 @@ function _build_restate(d, scope) {
   }
   return { enabled: Boolean(enabled) };
 }
+function _build_critic_protocol(v) {
+  if (v === void 0 || v === null) return "legacy";
+  if (!(_isStr(v) && _VALID_CRITIC_PROTOCOLS.has(v))) {
+    throw new CouncilConfigError(
+      `\`critic_protocol\`=${_pyRepr6(v)} not in ${_sortedListRepr(_VALID_CRITIC_PROTOCOLS)}.`
+    );
+  }
+  return v;
+}
 function _build_decision_resolution(d) {
   if (!_isDict(d)) {
     throw new CouncilConfigError("`decision_resolution` must be a mapping.");
@@ -25310,7 +25398,7 @@ function _build_defaults(d) {
   if (!_isDict(d)) {
     throw new CouncilConfigError("`defaults` must be a mapping.");
   }
-  const mode = _get(d, "mode", "api");
+  const mode = _get(d, "mode", "auto");
   if (!(_isStr(mode) && _VALID_MODES.has(mode))) {
     throw new CouncilConfigError(
       `defaults.mode=${_pyRepr6(mode)} not in ${_sortedListRepr(_VALID_MODES)}.`
@@ -25471,7 +25559,7 @@ function _build_cost_budget(d) {
   }
   return cb;
 }
-function _build_member(name, cfg, default_mode = "api") {
+function _build_member(name, cfg, default_mode = "auto") {
   if (!_VALID_PROVIDERS.has(name)) {
     throw new CouncilConfigError(
       `members.${name}: unknown provider; valid: ${_sortedListRepr(_VALID_PROVIDERS)}.`
@@ -25599,6 +25687,9 @@ function _build_cli_call_budget(d) {
     );
   }
   const caps = /* @__PURE__ */ new Map();
+  for (const provider of _VALID_PROVIDERS) {
+    caps.set(provider, _DEFAULT_CLI_CALLS_PER_DAY);
+  }
   for (const [provider, value] of Object.entries(raw_caps)) {
     if (!_VALID_PROVIDERS.has(provider)) {
       throw new CouncilConfigError(
@@ -25626,6 +25717,17 @@ function _build_cli_call_budget(d) {
   }
   return { max_calls_per_day: caps, warn_at };
 }
+function _build_quorum(raw) {
+  if (raw === "majority") {
+    return "majority";
+  }
+  if (_isInt(raw) && !_isBool(raw) && raw >= 1) {
+    return raw;
+  }
+  throw new CouncilConfigError(
+    `\`quorum\`=${_pyRepr6(raw)} must be 'majority' or an integer >= 1 (got ${_pyTypeName(raw)}).`
+  );
+}
 function _build_advisor(name, cfg) {
   if (!_isDict(cfg)) {
     throw new CouncilConfigError(`advisors.${name}: must be a mapping.`);
@@ -25746,7 +25848,7 @@ function _pyTruthy3(value) {
   }
   return Object.keys(value).length > 0;
 }
-var import_yaml5, _VALID_PROVIDERS, _VALID_MODES, _RAW_KEY_PREFIXES, CouncilConfigError, _Float, _VALID_NECESSITY_MODES, _VALID_DISCLOSURE_MODES, _VALID_CHAIRMAN_MODES, COUNCIL_CONFIG_RELNAME, COUNCIL_CONFIG_USER_GLOBAL_REL, COUNCIL_CONFIG_ENV, _VALID_RESOLUTION_MODES, _IMPACT_CLASSES, _LOCKED_IMPACT_CLASSES, _DEFAULT_RESOLUTION_MODES, _VALID_MEMBER_MODES, _VALID_DISPATCH_MODES;
+var import_yaml5, _VALID_PROVIDERS, _VALID_MODES, _RAW_KEY_PREFIXES, CouncilConfigError, _Float, _VALID_NECESSITY_MODES, _VALID_DISCLOSURE_MODES, _VALID_CHAIRMAN_MODES, COUNCIL_CONFIG_RELNAME, COUNCIL_CONFIG_USER_GLOBAL_REL, COUNCIL_CONFIG_ENV, _VALID_CRITIC_PROTOCOLS, _VALID_RESOLUTION_MODES, _IMPACT_CLASSES, _LOCKED_IMPACT_CLASSES, _DEFAULT_RESOLUTION_MODES, _VALID_MEMBER_MODES, _VALID_DISPATCH_MODES, _DEFAULT_CLI_CALLS_PER_DAY;
 var init_config = __esm({
   "src/scripts/ai_council/config.ts"() {
     "use strict";
@@ -25796,6 +25898,7 @@ var init_config = __esm({
     COUNCIL_CONFIG_RELNAME = ".ai-council.yml";
     COUNCIL_CONFIG_USER_GLOBAL_REL = "settings/.ai-council.yml";
     COUNCIL_CONFIG_ENV = "AI_COUNCIL_CONFIG";
+    _VALID_CRITIC_PROTOCOLS = /* @__PURE__ */ new Set(["legacy", "load_bearing"]);
     _VALID_RESOLUTION_MODES = /* @__PURE__ */ new Set([
       "agent",
       "council",
@@ -25821,6 +25924,7 @@ var init_config = __esm({
     };
     _VALID_MEMBER_MODES = /* @__PURE__ */ new Set(["cli", "api"]);
     _VALID_DISPATCH_MODES = /* @__PURE__ */ new Set(["full", "single"]);
+    _DEFAULT_CLI_CALLS_PER_DAY = 50;
   }
 });
 
@@ -26132,6 +26236,112 @@ var init_environment_detector = __esm({
   }
 });
 
+// src/scripts/ai_council/modes.ts
+function _sortedValidModes() {
+  return Array.from(VALID_MODES).sort();
+}
+function _normalise(value) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (typeof value !== "string") {
+    return null;
+  }
+  const s = value.trim().toLowerCase();
+  return s || null;
+}
+function _validate2(mode, source) {
+  if (mode === null) {
+    return null;
+  }
+  if (!VALID_MODES.has(mode)) {
+    throw new InvalidModeError(
+      `${source} requested mode=${_pyRepr7(mode)}; expected one of: ${_pyReprList2(_sortedValidModes())}`
+    );
+  }
+  return mode;
+}
+function _pyRepr7(s) {
+  return `'${s}'`;
+}
+function _pyReprList2(items) {
+  return `[${items.map((i) => _pyRepr7(i)).join(", ")}]`;
+}
+function resolve_global_mode(aiBlock) {
+  if (aiBlock === null || aiBlock === void 0) {
+    return null;
+  }
+  const flat = _normalise(_settingsGet(aiBlock, "mode"));
+  if (flat !== null) {
+    return flat;
+  }
+  const defaults = _settingsGet(aiBlock, "defaults");
+  if (defaults === null || defaults === void 0) {
+    return null;
+  }
+  if (!(defaults instanceof Map) && typeof defaults !== "object") {
+    return null;
+  }
+  if (Array.isArray(defaults)) {
+    return null;
+  }
+  return _normalise(
+    _settingsGet(defaults, "mode")
+  );
+}
+function _settingsGet(settings, key) {
+  if (settings === null || settings === void 0) {
+    return void 0;
+  }
+  if (settings instanceof Map) {
+    return settings.get(key);
+  }
+  return settings[key];
+}
+function resolve_mode(memberName, opts = {}) {
+  const invocationMode = opts.invocationMode ?? null;
+  const memberSettings = opts.memberSettings ?? null;
+  const globalMode = opts.globalMode ?? null;
+  const inv = _validate2(
+    _normalise(invocationMode),
+    `/council mode= for ${_pyRepr7(memberName)}`
+  );
+  if (inv !== null) {
+    return inv;
+  }
+  let memberModeRaw = null;
+  if (memberSettings !== null) {
+    const v = _settingsGet(memberSettings, "mode");
+    memberModeRaw = v === void 0 ? null : v;
+  }
+  const member = _validate2(
+    _normalise(memberModeRaw),
+    `ai_council.members.${memberName}.mode`
+  );
+  if (member !== null) {
+    return member;
+  }
+  const glob2 = _validate2(_normalise(globalMode), "ai_council.mode");
+  if (glob2 !== null) {
+    return glob2;
+  }
+  return DEFAULT_MODE;
+}
+var VALID_MODES, DEFAULT_MODE, InvalidModeError;
+var init_modes = __esm({
+  "src/scripts/ai_council/modes.ts"() {
+    "use strict";
+    VALID_MODES = /* @__PURE__ */ new Set(["api", "manual", "cli", "auto"]);
+    DEFAULT_MODE = "manual";
+    InvalidModeError = class extends Error {
+      constructor(message) {
+        super(message);
+        this.name = "InvalidModeError";
+      }
+    };
+  }
+});
+
 // src/scripts/ai_council/transport_resolver.ts
 function hasSource(report2, provider, allowed) {
   return report2.auth.some((a) => a.provider === provider && allowed.has(a.source));
@@ -26166,7 +26376,8 @@ function resolveTransport(opts) {
       billing,
       authSource,
       makesProviderCall: false,
-      reason: null
+      reason: null,
+      absentReason: null
     };
   }
   if (mode === "api" || mode === "cli") {
@@ -26176,7 +26387,8 @@ function resolveTransport(opts) {
       billing,
       authSource,
       makesProviderCall: true,
-      reason: null
+      reason: null,
+      absentReason: null
     };
   }
   if (mode !== "auto") {
@@ -26196,7 +26408,8 @@ function resolveTransport(opts) {
       billing,
       authSource,
       makesProviderCall: true,
-      reason: null
+      reason: null,
+      absentReason: null
     };
   }
   const keyPresent = opts.apiKeyPresent ?? hasSource(report2, provider, KEY_AUTH_SOURCES);
@@ -26207,12 +26420,36 @@ function resolveTransport(opts) {
       billing,
       authSource,
       makesProviderCall: true,
-      reason: null
+      reason: null,
+      absentReason: null
     };
   }
-  return unavailable(provider, billing, autoUnavailableReason(provider, binary, cliAuthed));
+  return unavailable(
+    provider,
+    billing,
+    autoUnavailableReason(provider, binary, cliAuthed),
+    classifyStaticAbsentReason(binary)
+  );
+}
+function resolveMemberTransport(opts) {
+  const configuredMode = resolve_mode(opts.provider, {
+    invocationMode: opts.invocationMode ?? null,
+    memberSettings: opts.memberSettings ?? null,
+    globalMode: opts.globalMode ?? null
+  });
+  const resolved = resolveTransport({
+    provider: opts.provider,
+    mode: configuredMode,
+    report: opts.report,
+    binaryOverride: opts.binaryOverride ?? null,
+    // `exactOptionalPropertyTypes` rejects an explicit `undefined` for an
+    // optional-boolean field, so the key is omitted entirely rather than
+    // forwarded as `apiKeyPresent: undefined`.
+    ...opts.apiKeyPresent !== void 0 ? { apiKeyPresent: opts.apiKeyPresent } : {}
+  });
+  return { ...resolved, configuredMode };
 }
-function unavailable(_provider, billing, reason) {
+function unavailable(_provider, billing, reason, absentReason = null) {
   return {
     available: false,
     transport: null,
@@ -26221,9 +26458,13 @@ function unavailable(_provider, billing, reason) {
     billing,
     authSource: null,
     makesProviderCall: false,
-    reason
+    reason,
+    absentReason
   };
 }
+function classifyStaticAbsentReason(binary) {
+  return binary === null ? "no_binary" : "no_auth";
+}
 function autoUnavailableReason(provider, binary, cliAuthed) {
   const expected = PROVIDER_CLI_META[provider]?.[0] ?? provider;
   if (binary === null && !cliAuthed) {
@@ -26234,11 +26475,40 @@ function autoUnavailableReason(provider, binary, cliAuthed) {
   }
   return `no transport available: \`${expected}\` is on PATH but not authenticated and no key resolves \u2014 log in to the CLI, or add an api_key_ref`;
 }
+function classifyCliFailure(raw) {
+  const s = raw.trim().toLowerCase();
+  if (s === "binary_missing" || s === "file_not_found") return "binary_missing";
+  if (s === "auth_expired" || s === "auth_rejected" || s === "unauthorized") {
+    return "auth_rejected";
+  }
+  if (s === "cli_unsupported" || s === "unsupported" || s === "parse_failed") {
+    return "cli_unsupported";
+  }
+  if (s === "timeout") return "timeout";
+  if (s === "cli_quota_exhausted" || s === "quota_exhausted") return "quota_exhausted";
+  if (/^exit_5\d\d$/.test(s) || s === "server_error" || s === "os") return "server_error";
+  return "other";
+}
+function absentReasonFromCliFailure(failure) {
+  switch (failure) {
+    case "binary_missing":
+      return "no_binary";
+    case "auth_rejected":
+      return "no_auth";
+    case "timeout":
+      return "timeout";
+    case "quota_exhausted":
+      return "quota";
+    default:
+      return null;
+  }
+}
 var VALID_TRANSPORT_MODES, CLI_AUTH_SOURCES, KEY_AUTH_SOURCES;
 var init_transport_resolver = __esm({
   "src/scripts/ai_council/transport_resolver.ts"() {
     "use strict";
     init_environment_detector();
+    init_modes();
     VALID_TRANSPORT_MODES = /* @__PURE__ */ new Set([
       "api",
       "manual",
@@ -26512,7 +26782,6 @@ var init_config2 = __esm({
       max_consecutive_blocks: 3
     });
     AI_TEAM_DEFAULTS = Object.freeze({
-      enabled: false,
       model: "auto",
       allow_delegate: false,
       max_calls_per_day: 50,
@@ -26925,8 +27194,10 @@ __export(cmd_doctor_exports, {
   _scan_foreign: () => _scan_foreign,
   _settings_layer_chain: () => _settings_layer_chain,
   _skipped_manifest_check: () => _skipped_manifest_check,
+  _team_codex_binary_name: () => _team_codex_binary_name,
   _wizard_state_path: () => _wizard_state_path,
-  main: () => main15
+  main: () => main15,
+  shutilWhich: () => shutilWhich
 });
 import * as crypto6 from "node:crypto";
 import * as fs45 from "node:fs";
@@ -28343,6 +28614,13 @@ function osErrorStr2(exc) {
   }
   return String(exc);
 }
+function _effectiveMemberMode(member, cfg) {
+  return member.mode ?? cfg.defaults.mode;
+}
+function _mayRunOverCli(member, cfg) {
+  const mode = _effectiveMemberMode(member, cfg);
+  return mode === "cli" || mode === "auto";
+}
 function _check_council_cli(project_root) {
   const { load_cli_call_counts: load_cli_call_counts2 } = clients_exports;
   const { load_council_config: load_council_config2, resolve_config_path: resolve_config_path2 } = config_exports;
@@ -28368,7 +28646,7 @@ function _check_council_cli(project_root) {
   }
   const cli_members = [];
   for (const [name, m] of cfg.members.entries()) {
-    if (m.enabled && m.mode === "cli" && name in _CLI_PROVIDER_META) {
+    if (m.enabled && _mayRunOverCli(m, cfg) && name in _CLI_PROVIDER_META) {
       cli_members.push([name, m]);
     }
   }
@@ -28467,18 +28745,11 @@ function _team_codex_binary_name(project_root) {
     return default_bin;
   }
   const member = cfg.members.get("openai");
-  if (member && member.enabled && member.mode === "cli" && member.binary) {
+  if (member && member.enabled && _mayRunOverCli(member, cfg) && member.binary) {
     return member.binary;
   }
   return default_bin;
 }
-function _settings_flag(val) {
-  if (typeof val === "boolean") return val;
-  if (typeof val === "string") {
-    return ["true", "yes", "on", "1"].includes(val.trim().toLowerCase());
-  }
-  return false;
-}
 function _jwt_exp(token) {
   if (typeof token !== "string") return null;
   const parts = token.split(".");
@@ -28642,31 +28913,14 @@ function _check_detection(project_root) {
 }
 function _check_team(project_root) {
   const ai_team = _read_ai_team_block(project_root);
-  const enabled = _settings_flag(ai_team["enabled"]);
   const gateRaw = ai_team["review_gate"];
   const gate = typeof gateRaw === "object" && gateRaw !== null && !Array.isArray(gateRaw) ? gateRaw : {};
-  const gate_managed = _settings_flag(gate["managed"]);
-  if (!enabled) {
-    if (gate_managed) {
-      return {
-        id: "team",
-        status: "warn",
-        message: "half-configured: ai_team.review_gate.managed is on but ai_team.enabled is false \u2014 the gate never runs",
-        remedy: "set `ai_team.enabled: true` in .agent-settings.yml, or remove `ai_team.review_gate.managed`"
-      };
-    }
-    return {
-      id: "team",
-      status: "ok",
-      message: "team mode not configured (default-off)",
-      remedy: "opt in via `ai_team.enabled: true` in .agent-settings.yml, then re-run `agent-config doctor --check team`"
-    };
-  }
   const remedies = [];
   const binary_name = _team_codex_binary_name(project_root);
   const binary_resolved = shutilWhich(binary_name);
   const binary_glyph = binary_resolved !== null ? "\u2705" : "\u274C";
-  if (binary_resolved === null) {
+  const binary_missing = binary_resolved === null;
+  if (binary_missing) {
     remedies.push("install the codex CLI: `npm install -g @openai/codex`");
   }
   const auth_path = path43.join(_codex_home(), "auth.json");
@@ -28707,6 +28961,14 @@ function _check_team(project_root) {
   const gate_str = gate_signal.gate_str;
   remedies.push(...gate_signal.remedies);
   const detail = `codex binary ${binary_glyph} (${binary_name}) \xB7 ${auth_str} \xB7 ${plugin_str} \xB7 ${gate_str}`;
+  if (binary_missing && !authed) {
+    return {
+      id: "team",
+      status: "ok",
+      message: `team unavailable (default) \u2014 codex CLI not installed \xB7 ${detail}`,
+      remedy: remedies.join("; ")
+    };
+  }
   if (remedies.length > 0) {
     return {
       id: "team",
@@ -28718,7 +28980,7 @@ function _check_team(project_root) {
   return {
     id: "team",
     status: "ok",
-    message: `team mode enabled \xB7 ${detail}`,
+    message: `team available \xB7 ${detail}`,
     remedy: ""
   };
 }
@@ -29983,7 +30245,7 @@ function _check_host_manifest(projectRoot) {
     return {
       id: "host-manifest",
       status: "ok",
-      message: `no .agent-settings.yml \u2014 safe-default manifest applies (${detectedNote})`,
+      message: `no .agent-settings.yml \u2014 host capability is always probe/registry-resolved (${detectedNote})`,
       remedy: ""
     };
   }
@@ -30004,44 +30266,14 @@ function _check_host_manifest(projectRoot) {
     return {
       id: "host-manifest",
       status: "ok",
-      message: `no host_capabilities override \u2014 safe-default manifest applies (${detectedNote})`,
+      message: `no host_capabilities override \u2014 host capability is always probe/registry-resolved (${detectedNote})`,
       remedy: ""
     };
   }
-  if (typeof manifest !== "object" || Array.isArray(manifest)) {
-    return {
-      id: "host-manifest",
-      status: "fail",
-      message: "subagents.host_capabilities is not a mapping",
-      remedy: "use the four boolean fields from the host-capability manifest contract"
-    };
-  }
-  const problems = [];
-  for (const [key, value] of Object.entries(manifest)) {
-    if (!HOST_MANIFEST_KEYS.has(key)) {
-      problems.push(`unknown key '${key}'`);
-      continue;
-    }
-    if (key === "schema_version") {
-      if (value !== 1) problems.push(`schema_version must be 1 (got ${JSON.stringify(value)})`);
-      continue;
-    }
-    if (typeof value !== "boolean") {
-      problems.push(`'${key}' must be boolean (got ${JSON.stringify(value)})`);
-    }
-  }
-  if (problems.length > 0) {
-    return {
-      id: "host-manifest",
-      status: "fail",
-      message: `host_capabilities malformed: ${problems.slice(0, 4).join("; ")}`,
-      remedy: "only schema_version:1 + four boolean capability fields are valid"
-    };
-  }
   return {
     id: "host-manifest",
     status: "ok",
-    message: `host_capabilities override parses strictly (${detectedNote})`,
+    message: `subagents.host_capabilities is deprecated and ignored \u2014 host capability is always probe/registry-resolved (${detectedNote})`,
     remedy: ""
   };
 }
@@ -30198,7 +30430,7 @@ function _isCliEntry16() {
     return false;
   }
 }
-var YAML6, _HERE13, PACKAGE_ROOT2, CONFORMANCE_CHECK_IDS, THIN_STUB_MARKER, HOST_MANIFEST_KEYS, USAGE3;
+var YAML6, _HERE13, PACKAGE_ROOT2, CONFORMANCE_CHECK_IDS, THIN_STUB_MARKER, USAGE3;
 var init_cmd_conformance = __esm({
   "src/scripts/_cli/cmd_conformance.ts"() {
     "use strict";
@@ -30220,13 +30452,6 @@ var init_cmd_conformance = __esm({
       "host-manifest"
     ];
     THIN_STUB_MARKER = "Routed rule \u2014 load the body on trigger-match";
-    HOST_MANIFEST_KEYS = /* @__PURE__ */ new Set([
-      "schema_version",
-      "subagent_spawn",
-      "parallel_spawn",
-      "status_polling",
-      "separate_quota_pool"
-    ]);
     USAGE3 = "usage: agent-config conformance [-h] [--project PROJECT] [--json]\n                                [--skip-dispatcher]\n";
     if (_isCliEntry16() || process16.argv[1] === _HERE13) {
       try {
@@ -31496,12 +31721,12 @@ function _enforceSize(text, mode) {
   const n = _utf8Len(text);
   if (n > MAX_BUNDLE_BYTES) {
     throw new BundleTooLarge(
-      `Bundle for ${_pyRepr7(mode)} mode is ${n} bytes (> ${MAX_BUNDLE_BYTES} hard ceiling). Narrow the scope (smaller diff, fewer files, shorter prompt).`
+      `Bundle for ${_pyRepr8(mode)} mode is ${n} bytes (> ${MAX_BUNDLE_BYTES} hard ceiling). Narrow the scope (smaller diff, fewer files, shorter prompt).`
     );
   }
   return text;
 }
-function _pyRepr7(s) {
+function _pyRepr8(s) {
   const hasSingle = s.includes("'");
   const hasDouble = s.includes('"');
   const quote = hasSingle && !hasDouble ? '"' : "'";
@@ -31651,7 +31876,7 @@ function _pyReprStr2(s) {
   }
   return `${quote}${body}${quote}`;
 }
-function _pyRepr8(value) {
+function _pyRepr9(value) {
   return value === null ? "None" : _pyReprStr2(value);
 }
 function _splitlines8(text) {
@@ -31683,7 +31908,7 @@ function synthesis_template(mode) {
     Object.keys(_INPUT_MODE_TO_SYNTHESIS_KEY)
   );
   throw new Error(
-    `Unknown synthesis mode ${_pyRepr8(mode)}. Expected one of: [${expected.map((m) => _pyReprStr2(m)).join(", ")}]`
+    `Unknown synthesis mode ${_pyRepr9(mode)}. Expected one of: [${expected.map((m) => _pyReprStr2(m)).join(", ")}]`
   );
 }
 function _strip_host_identity(text) {
@@ -31733,7 +31958,7 @@ function system_prompt_for(mode, opts = {}) {
   if (!_hasKey(_MODE_TABLE, mode)) {
     const expected = Object.keys(_MODE_TABLE).sort();
     throw new Error(
-      `Unknown council mode ${_pyRepr8(mode)}. Expected one of: [${expected.map((m) => _pyReprStr2(m)).join(", ")}]`
+      `Unknown council mode ${_pyRepr9(mode)}. Expected one of: [${expected.map((m) => _pyReprStr2(m)).join(", ")}]`
     );
   }
   const head = handoff_preamble(project, original_ask);
@@ -32413,109 +32638,30 @@ var init_solo_dispatch = __esm({
   }
 });
 
-// src/scripts/ai_council/modes.ts
-function _sortedValidModes() {
-  return Array.from(VALID_MODES).sort();
-}
-function _normalise(value) {
-  if (value === null || value === void 0) {
-    return null;
-  }
-  if (typeof value !== "string") {
-    return null;
-  }
-  const s = value.trim().toLowerCase();
-  return s || null;
-}
-function _validate2(mode, source) {
-  if (mode === null) {
-    return null;
-  }
-  if (!VALID_MODES.has(mode)) {
-    throw new InvalidModeError(
-      `${source} requested mode=${_pyRepr9(mode)}; expected one of: ${_pyReprList2(_sortedValidModes())}`
+// src/scripts/ai_council/quorum.ts
+function resolveQuorumThreshold(total, setting = "majority") {
+  if (!Number.isInteger(total) || total < 0) {
+    throw new RangeError(
+      `resolveQuorumThreshold: total must be a non-negative integer (got ${total}).`
     );
   }
-  return mode;
-}
-function _pyRepr9(s) {
-  return `'${s}'`;
-}
-function _pyReprList2(items) {
-  return `[${items.map((i) => _pyRepr9(i)).join(", ")}]`;
-}
-function resolve_global_mode(aiBlock) {
-  if (aiBlock === null || aiBlock === void 0) {
-    return null;
-  }
-  const flat = _normalise(_settingsGet(aiBlock, "mode"));
-  if (flat !== null) {
-    return flat;
-  }
-  const defaults = _settingsGet(aiBlock, "defaults");
-  if (defaults === null || defaults === void 0) {
-    return null;
-  }
-  if (!(defaults instanceof Map) && typeof defaults !== "object") {
-    return null;
+  if (total === 0) {
+    return 0;
   }
-  if (Array.isArray(defaults)) {
-    return null;
+  if (setting === "majority") {
+    return Math.ceil(total / 2);
   }
-  return _normalise(
-    _settingsGet(defaults, "mode")
-  );
+  return Math.min(Math.max(setting, 1), total);
 }
-function _settingsGet(settings, key) {
-  if (settings === null || settings === void 0) {
-    return void 0;
-  }
-  if (settings instanceof Map) {
-    return settings.get(key);
-  }
-  return settings[key];
+function evaluateQuorum(total, present, setting = "majority") {
+  const threshold = resolveQuorumThreshold(total, setting);
+  const clampedPresent = Math.min(Math.max(present, 0), total);
+  const status3 = clampedPresent >= threshold ? "concluded" : "inconclusive";
+  return { status: status3, threshold, total, present: clampedPresent };
 }
-function resolve_mode(memberName, opts = {}) {
-  const invocationMode = opts.invocationMode ?? null;
-  const memberSettings = opts.memberSettings ?? null;
-  const globalMode = opts.globalMode ?? null;
-  const inv = _validate2(
-    _normalise(invocationMode),
-    `/council mode= for ${_pyRepr9(memberName)}`
-  );
-  if (inv !== null) {
-    return inv;
-  }
-  let memberModeRaw = null;
-  if (memberSettings !== null) {
-    const v = _settingsGet(memberSettings, "mode");
-    memberModeRaw = v === void 0 ? null : v;
-  }
-  const member = _validate2(
-    _normalise(memberModeRaw),
-    `ai_council.members.${memberName}.mode`
-  );
-  if (member !== null) {
-    return member;
-  }
-  const glob2 = _validate2(_normalise(globalMode), "ai_council.mode");
-  if (glob2 !== null) {
-    return glob2;
-  }
-  return DEFAULT_MODE;
-}
-var VALID_MODES, DEFAULT_MODE, InvalidModeError;
-var init_modes = __esm({
-  "src/scripts/ai_council/modes.ts"() {
+var init_quorum = __esm({
+  "src/scripts/ai_council/quorum.ts"() {
     "use strict";
-    VALID_MODES = /* @__PURE__ */ new Set(["api", "manual", "cli", "auto"]);
-    DEFAULT_MODE = "manual";
-    InvalidModeError = class extends Error {
-      constructor(message) {
-        super(message);
-        this.name = "InvalidModeError";
-      }
-    };
   }
 });
 
@@ -34977,6 +35123,37 @@ One sentence, and the single strongest reason.`;
   }
 });
 
+// src/scripts/ai_council/handoff.ts
+function isEmptyHandoff(h) {
+  return h.decision === null && h.rejected_alternatives === null && h.constraints === null;
+}
+function buildHandoffFromStanceTally(tally) {
+  if (tally === null || tally.consensus === null) {
+    return EMPTY_HANDOFF;
+  }
+  const winner = tally.consensus;
+  const rejected = tally.options.filter((o) => o !== winner).map((o) => ({
+    option: o.label,
+    reason: `backed by ${o.backers.length} member(s), weight ${o.weight.toFixed(2)} of ${tally.threshold.toFixed(2)} needed to conclude`
+  }));
+  return {
+    decision: winner.label,
+    rejected_alternatives: rejected.length > 0 ? rejected : null,
+    constraints: null
+  };
+}
+var EMPTY_HANDOFF;
+var init_handoff = __esm({
+  "src/scripts/ai_council/handoff.ts"() {
+    "use strict";
+    EMPTY_HANDOFF = {
+      decision: null,
+      rejected_alternatives: null,
+      constraints: null
+    };
+  }
+});
+
 // src/scripts/ai_council/orchestrator.ts
 var orchestrator_exports = {};
 __export(orchestrator_exports, {
@@ -35956,11 +36133,58 @@ ${body}`;
   blocks.push(`## Convergence / Divergence
 
 ${body}`);
+  if (opts.handoff && !isEmptyHandoff(opts.handoff)) {
+    blocks.push(_render_handoff(opts.handoff));
+  }
   if (blind !== null) {
     blocks.push(render_deanonymization_block("### De-anonymization map", blind.label_to_source));
   }
+  if (opts.quorum) {
+    blocks.push(_render_quorum_line(opts.quorum));
+  }
+  const absent = opts.absent_members ?? [];
+  if (absent.length > 0) {
+    blocks.push(_render_absent_members(absent));
+  }
   return blocks.join("\n\n---\n\n");
 }
+function _render_quorum_line(q) {
+  const verdict = q.status === "concluded" ? "concluded" : "INCONCLUSIVE \u2014 release gate holds";
+  return `**Quorum:** ${q.present}/${q.total} present, needed ${q.threshold} \u2014 ${verdict}.`;
+}
+function _render_absent_members(absent) {
+  const lines = ["### Absent Members", ""];
+  for (const a of absent) {
+    const tag = a.reason !== null ? ` (${a.reason})` : "";
+    lines.push(`- **${a.member}**${tag} \u2014 ${a.detail}`);
+  }
+  return lines.join("\n");
+}
+function _render_handoff(h) {
+  const lines = ["### Handoff", ""];
+  lines.push(`**Decision:** ${h.decision ?? "none recorded \u2014 no structured verdict this pass."}`);
+  lines.push("");
+  if (h.rejected_alternatives !== null && h.rejected_alternatives.length > 0) {
+    lines.push("**Rejected alternatives:**");
+    lines.push("");
+    for (const alt of h.rejected_alternatives) {
+      lines.push(`- **${alt.option}** \u2014 ${alt.reason}`);
+    }
+  } else {
+    lines.push("**Rejected alternatives:** none recorded.");
+  }
+  lines.push("");
+  if (h.constraints !== null && h.constraints.length > 0) {
+    lines.push("**Constraints:**");
+    lines.push("");
+    for (const c of h.constraints) {
+      lines.push(`- ${c}`);
+    }
+  } else {
+    lines.push("**Constraints:** none recorded.");
+  }
+  return lines.join("\n");
+}
 function _render_peer_review(peer_review) {
   const lines = ["## Peer-Review (Karpathy)"];
   let label_idx = 0;
@@ -36085,6 +36309,7 @@ var init_orchestrator = __esm({
     init_debate_gates();
     init_stance_tally();
     init_blind_review();
+    init_handoff();
     CostBudget = class {
       max_input_tokens;
       max_output_tokens;
@@ -37669,6 +37894,7 @@ __export(council_cli_exports, {
   CouncilDisabledError: () => CouncilDisabledError,
   _parse_model_overrides: () => _parse_model_overrides,
   _parse_siblings_overrides: () => _parse_siblings_overrides,
+  _postRunQuorum: () => _postRunQuorum,
   _synthesize_ai_council_block: () => _synthesize_ai_council_block,
   build_members: () => build_members,
   build_question: () => build_question,
@@ -37679,6 +37905,7 @@ __export(council_cli_exports, {
   cmd_replay: () => cmd_replay,
   cmd_run: () => cmd_run,
   cmd_shadow_report: () => cmd_shadow_report,
+  cmd_status: () => cmd_status,
   format_estimate_table: () => format_estimate_table,
   load_settings: () => load_settings,
   main: () => main17
@@ -37969,6 +38196,13 @@ function _synthesize_ai_council_block(cfg) {
       max_calls_per_day: _mapToObject(cfg.cli_call_budget.max_calls_per_day),
       warn_at: cfg.cli_call_budget.warn_at
     },
+    // Phase 3.3 (road-to-always-on-orchestration): was validated by
+    // `_build_config`/`_build_quorum` but never forwarded into the
+    // synthesized block, so `build_members` always saw `undefined` and
+    // silently fell back to `'majority'` regardless of the user's
+    // configured `quorum: <k>`. Additive key — callers that never read
+    // it observe no change.
+    quorum: cfg.quorum,
     necessity_classifier: {
       enabled: cfg.necessity_classifier.enabled,
       mode: cfg.necessity_classifier.mode,
@@ -38007,15 +38241,63 @@ function _mapToObject(m) {
   }
   return out;
 }
+function _member_api_key_present(cfg) {
+  const ref = cfg["api_key_ref"];
+  if (typeof ref !== "string" || ref.trim() === "") {
+    return void 0;
+  }
+  try {
+    resolve_api_key(ref);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function _quorum_setting_from(ai) {
+  const raw = ai["quorum"];
+  if (raw === "majority") {
+    return "majority";
+  }
+  if (typeof raw === "number" && Number.isInteger(raw) && raw >= 1) {
+    return raw;
+  }
+  return "majority";
+}
+function _postRunQuorum(members, responses, ai_cfg) {
+  const absent = [];
+  let present = 0;
+  for (let i = 0; i < members.length; i++) {
+    const m = members[i];
+    const r = responses[i];
+    if (r !== void 0 && !r.error) {
+      present += 1;
+      continue;
+    }
+    const raw = r?.error ?? "no response";
+    const failure = classifyCliFailure(raw);
+    absent.push({
+      member: m.name,
+      reason: absentReasonFromCliFailure(failure) ?? "unavailable",
+      detail: raw
+    });
+  }
+  return { quorum: evaluateQuorum(members.length, present, _quorum_setting_from(ai_cfg)), absent };
+}
+function _format_quorum_line(q) {
+  const verdict = q.status === "concluded" ? "concluded" : "INCONCLUSIVE \u2014 release gate holds";
+  return `council:quorum \xB7 ${q.present}/${q.total} present, needed ${q.threshold} \u2014 ${verdict}.`;
+}
 function build_members(settings, opts = {}) {
   const invocation_mode = opts.invocation_mode ?? null;
   const model_overrides = opts.model_overrides ?? null;
   const siblings_overrides = opts.siblings_overrides ?? null;
   const skipped = opts.skipped ?? null;
+  const quorum_out = opts.quorum_out ?? null;
+  const report2 = opts.environment_report ?? detectEnvironment();
   const ai = _isDict3(settings) ? settings["ai_council"] || {} : {};
   if (!_pyBool2(ai["enabled"])) {
     throw new CouncilDisabledError(
-      "ai_council.enabled is false in .agent-settings.yml \u2014 flip it on before invoking council:* commands."
+      `enabled is false in the council config (${COUNCIL_CONFIG_USER_GLOBAL_REL} under the user-global agent-config root) \u2014 flip it on before invoking council:* commands. This config is NEVER project-local (ADR-104), so do not look for it, or create it, in the project tree. \`agent-config council:status\` prints the resolved path.`
     );
   }
   const members_cfg = ai["members"] || {};
@@ -38045,25 +38327,36 @@ function build_members(settings, opts = {}) {
     );
   }
   const members = [];
+  let total_enabled = 0;
+  let absent_count = 0;
   for (const name of Object.keys(members_cfg)) {
     const cfg = members_cfg[name] || {};
     if (!_pyBool2(cfg["enabled"])) {
       if (name in siblings) {
         throw new CouncilDisabledError(
-          `--siblings targets member ${_pyReprStr5(name)} but it is not enabled in .agent-settings.yml (ai_council.members.${name}.enabled).`
+          `--siblings targets member ${_pyReprStr5(name)} but it is not enabled in the council config (members.${name}.enabled in ${COUNCIL_CONFIG_USER_GLOBAL_REL} under the user-global root).`
         );
       }
       continue;
     }
-    const mode = resolve_mode(name, {
+    total_enabled += 1;
+    const api_key_present = _member_api_key_present(cfg);
+    const resolved = resolveMemberTransport({
+      provider: name,
+      report: report2,
       invocationMode: invocation_mode,
       memberSettings: cfg,
-      globalMode: global_mode ?? null
+      globalMode: global_mode ?? null,
+      binaryOverride: cfg["binary"] ?? null,
+      // `exactOptionalPropertyTypes` rejects an explicit `undefined` —
+      // see `resolveMemberTransport`'s own forwarding call for the
+      // same pattern.
+      ...api_key_present !== void 0 ? { apiKeyPresent: api_key_present } : {}
     });
     if (name in siblings) {
-      if (mode !== "api") {
+      if (resolved.transport !== "api") {
         throw new CouncilDisabledError(
-          `--siblings requires mode=api for member ${_pyReprStr5(name)} (got ${_pyReprStr5(mode)}).`
+          `--siblings requires mode=api for member ${_pyReprStr5(name)} (configured mode=${_pyReprStr5(resolved.configuredMode)}, resolved transport=${_pyReprStr5(resolved.transport ?? "none")}).`
         );
       }
       const api_key_ref = cfg["api_key_ref"] ?? null;
@@ -38080,19 +38373,49 @@ function build_members(settings, opts = {}) {
       }
       continue;
     }
+    if (resolved.transport === null) {
+      const detail = resolved.reason ?? `member ${name} has no available transport`;
+      const entry = {
+        member: name,
+        reason: resolved.absentReason ?? "unavailable",
+        detail
+      };
+      absent_count += 1;
+      if (skipped !== null) {
+        skipped.push(entry);
+      }
+      _stderr2(`[council] SKIP ${name}: ${detail}
+`);
+      continue;
+    }
     const model = overrides[name] || cfg["model"] || null;
-    if (mode === "api" && _API_PROVIDERS.has(name)) {
-      members.push(
-        _construct_api_member(name, model, {
-          api_key_ref: cfg["api_key_ref"] ?? null,
-          // Council opts in explicitly (client-default OFF); on unless
-          // the operator sets `prompt_cache: false`.
-          enable_prompt_cache: cfg["prompt_cache"] !== false,
-          // road-to-cache-economy Phase 4 — see the siblings branch above.
-          prompt_cache_ttl: cfg["prompt_cache_ttl"] ?? void 0
-        })
-      );
-    } else if (mode === "cli" && _CLI_PROVIDERS.has(name)) {
+    if (resolved.transport === "api" && _API_PROVIDERS.has(name)) {
+      try {
+        members.push(
+          _construct_api_member(name, model, {
+            api_key_ref: cfg["api_key_ref"] ?? null,
+            // Council opts in explicitly (client-default OFF); on unless
+            // the operator sets `prompt_cache: false`.
+            enable_prompt_cache: cfg["prompt_cache"] !== false,
+            // road-to-cache-economy Phase 4 — see the siblings branch above.
+            prompt_cache_ttl: cfg["prompt_cache_ttl"] ?? void 0
+          })
+        );
+      } catch (exc) {
+        if (!(exc instanceof CouncilDisabledError)) {
+          throw exc;
+        }
+        const detail = exc.message;
+        const entry = { member: name, reason: "no_auth", detail };
+        absent_count += 1;
+        if (skipped !== null) {
+          skipped.push(entry);
+        }
+        _stderr2(`[council] SKIP ${name}: ${detail}
+`);
+        continue;
+      }
+    } else if (resolved.transport === "cli" && _CLI_PROVIDERS.has(name)) {
       try {
         members.push(
           _construct_cli_member(name, model, {
@@ -38112,6 +38435,7 @@ function build_members(settings, opts = {}) {
           reason: "binary_missing",
           detail
         };
+        absent_count += 1;
         if (skipped !== null) {
           skipped.push(entry);
         }
@@ -38119,22 +38443,22 @@ function build_members(settings, opts = {}) {
 `);
         continue;
       }
-    } else if (mode === "cli") {
+    } else if (resolved.transport === "cli") {
       throw new CouncilDisabledError(
         `member ${_pyReprStr5(name)} resolves to mode=cli but no CLI client is wired (known: ${_pyReprStrList(_pySortedStr(_CLI_PROVIDERS))}).`
       );
-    } else if (mode === "manual") {
+    } else if (resolved.transport === "manual") {
       members.push(new ManualClient({ name, model: model || "manual" }));
-    } else if (mode === "playwright") {
-      throw new CouncilDisabledError(
-        `member ${_pyReprStr5(name)} resolves to mode=playwright (Phase 2c, not wired).`
-      );
     } else {
       throw new CouncilDisabledError(
-        `member ${_pyReprStr5(name)} has no transport \u2014 mode=${mode}, name not in ${_pyReprStrList(_pySortedStr(_API_PROVIDERS))}.`
+        `member ${_pyReprStr5(name)} has no transport \u2014 resolved=${_pyReprStr5(resolved.transport)}, configured mode=${_pyReprStr5(resolved.configuredMode)}, name not in ${_pyReprStrList(_pySortedStr(_API_PROVIDERS))}.`
       );
     }
   }
+  if (quorum_out !== null) {
+    const present = total_enabled - absent_count;
+    quorum_out.result = evaluateQuorum(total_enabled, present, _quorum_setting_from(ai));
+  }
   if (members.length === 0) {
     if (skipped && skipped.length > 0) {
       const names = skipped.map((s) => String(s["member"])).join(", ");
@@ -38143,7 +38467,7 @@ function build_members(settings, opts = {}) {
       );
     }
     throw new CouncilDisabledError(
-      "no council member has `enabled: true` \u2014 enable at least one in .agent-settings.yml under ai_council.members.*."
+      `no council member has \`enabled: true\` \u2014 enable at least one under members.* in ${COUNCIL_CONFIG_USER_GLOBAL_REL} (user-global root; never the project tree, ADR-104). \`agent-config council:status\` prints the resolved path.`
     );
   }
   return members;
@@ -38571,6 +38895,59 @@ function _objToMap(o) {
   }
   return m;
 }
+function _deserialise_handoff(data) {
+  if (!_isDict3(data)) {
+    return null;
+  }
+  const d = data;
+  const decision = typeof d["decision"] === "string" ? d["decision"] : null;
+  const rawAlts = d["rejected_alternatives"];
+  const alts = Array.isArray(rawAlts) ? rawAlts.filter(
+    (a) => _isDict3(a) && typeof a["option"] === "string" && typeof a["reason"] === "string"
+  ).map((a) => ({ option: a["option"], reason: a["reason"] })) : [];
+  const rawConstraints = d["constraints"];
+  const constraints = Array.isArray(rawConstraints) ? rawConstraints.filter((c) => typeof c === "string") : [];
+  return {
+    decision,
+    rejected_alternatives: alts.length > 0 ? alts : null,
+    constraints: constraints.length > 0 ? constraints : null
+  };
+}
+function _deserialise_absent_members(data) {
+  if (!Array.isArray(data)) {
+    return null;
+  }
+  const out = [];
+  for (const entry of data) {
+    if (!_isDict3(entry)) {
+      continue;
+    }
+    const d = entry;
+    const member = d["member"];
+    const detail = d["detail"];
+    if (typeof member !== "string" || typeof detail !== "string") {
+      continue;
+    }
+    const raw = d["reason"];
+    const reason = typeof raw === "string" && _VALID_ABSENT_REASONS.has(raw) ? raw : null;
+    out.push({ member, reason, detail });
+  }
+  return out.length > 0 ? out : null;
+}
+function _deserialise_quorum(data) {
+  if (!_isDict3(data)) {
+    return null;
+  }
+  const d = data;
+  const status3 = d["status"];
+  const threshold = d["threshold"];
+  const total = d["total"];
+  const present = d["present"];
+  if (status3 !== "concluded" && status3 !== "inconclusive" || typeof threshold !== "number" || typeof total !== "number" || typeof present !== "number") {
+    return null;
+  }
+  return { status: status3, threshold, total, present };
+}
 function _resolve_rounds(args, ai_cfg) {
   if (_getattr3(args, "rounds", null) !== null) {
     return _pyInt6(args.rounds);
@@ -38608,12 +38985,14 @@ function cmd_estimate(args, opts = {}) {
   const advisor_plans = _build_advisor_plans(ai_cfg, REPO_ROOT3);
   const explicit_overrides = _parse_model_overrides(_getattr3(args, "model", null));
   const skipped = [];
+  const quorum_out = { result: null };
   if (members === null) {
     members = build_members(settings, {
       invocation_mode: args.mode_override,
       model_overrides: _advisor_model_overrides(advisor_plans, explicit_overrides),
       siblings_overrides: _parse_siblings_overrides(_getattr3(args, "siblings", null)),
-      skipped
+      skipped,
+      quorum_out
     });
   }
   if (table === null) {
@@ -38649,6 +39028,9 @@ function cmd_estimate(args, opts = {}) {
   if (skipped.length > 0) {
     _stdout2(format_install_hints(skipped) + "\n");
   }
+  if (quorum_out.result !== null) {
+    _stdout2(_format_quorum_line(quorum_out.result) + "\n");
+  }
   _stdout2(
     format_estimate_table(billable, estimates, {
       consensus_delta_usd: extra_usd,
@@ -39027,6 +39409,75 @@ function _emit_shadow_slo_banner() {
     return;
   }
 }
+function cmd_status(args, opts = {}) {
+  const env = opts.env ?? process.env;
+  const override = env[COUNCIL_CONFIG_ENV];
+  const path_ = resolve_config_path(REPO_ROOT3, { env });
+  const exists3 = fs56.existsSync(String(path_));
+  const provenance = override ? `${COUNCIL_CONFIG_ENV} override` : "user-global";
+  let cfg = null;
+  let parse_error = null;
+  if (exists3) {
+    try {
+      cfg = load_council_config(path_);
+    } catch (exc) {
+      parse_error = exc instanceof Error ? exc.message : String(exc);
+    }
+  }
+  const enabledMembers = cfg === null ? [] : [...cfg.members.entries()].filter(([, m]) => m.enabled);
+  const configured = cfg !== null && cfg.enabled && enabledMembers.length > 0;
+  if (_getattr3(args, "json", false)) {
+    _stdout2(
+      `${JSON.stringify({
+        configured,
+        path: String(path_),
+        exists: exists3,
+        provenance,
+        enabled: cfg?.enabled ?? null,
+        members_total: cfg === null ? null : cfg.members.size,
+        members_enabled: cfg === null ? null : enabledMembers.length,
+        member_names: enabledMembers.map(([n]) => n),
+        parse_error,
+        project_tree_consulted: false
+      })}
+`
+    );
+    return 0;
+  }
+  _stdout2(`council:status \xB7 ${configured ? "CONFIGURED" : "NOT CONFIGURED"}
+`);
+  _stdout2(`  config path      ${String(path_)}
+`);
+  _stdout2(`  resolved by      ${provenance}
+`);
+  _stdout2(`  file exists      ${exists3 ? "yes" : "no"}
+`);
+  if (parse_error !== null) {
+    _stdout2(`  parse error      ${parse_error}
+`);
+  }
+  if (cfg !== null) {
+    _stdout2(`  enabled          ${cfg.enabled ? "yes" : "no"}
+`);
+    _stdout2(`  members          ${enabledMembers.length} enabled of ${cfg.members.size}
+`);
+    if (enabledMembers.length > 0) {
+      _stdout2(`                   ${enabledMembers.map(([n]) => n).join(", ")}
+`);
+    }
+  }
+  _stdout2("\n");
+  _stdout2("  The project tree is NEVER consulted (ADR-104). No project file \u2014\n");
+  _stdout2("  `.agent-settings.yml` included \u2014 indicates council availability in\n");
+  _stdout2("  either direction. Do not infer it from one; run this instead.\n");
+  if (!configured) {
+    _stdout2(`
+  To configure: write ${COUNCIL_CONFIG_USER_GLOBAL_REL} under the user-global
+`);
+    _stdout2("  agent-config root, with `enabled: true` and at least one enabled member.\n");
+  }
+  return 0;
+}
 function _apply_solo_dispatch(members) {
   let cfg;
   try {
@@ -39087,12 +39538,14 @@ function cmd_run(args, opts = {}) {
   const advisor_plans = _build_advisor_plans(ai_cfg, REPO_ROOT3);
   const explicit_overrides = _parse_model_overrides(_getattr3(args, "model", null));
   const skipped = [];
+  const quorum_out = { result: null };
   if (members === null) {
     members = build_members(settings, {
       invocation_mode: args.mode_override,
       model_overrides: _advisor_model_overrides(advisor_plans, explicit_overrides),
       siblings_overrides: _parse_siblings_overrides(_getattr3(args, "siblings", null)),
-      skipped
+      skipped,
+      quorum_out
     });
   }
   if (_getattr3(args, "single", false)) {
@@ -39152,6 +39605,9 @@ function cmd_run(args, opts = {}) {
   if (skipped.length > 0) {
     _stdout2(format_install_hints(skipped) + "\n");
   }
+  if (quorum_out.result !== null) {
+    _stdout2(_format_quorum_line(quorum_out.result) + "\n");
+  }
   _stdout2(
     format_estimate_table(billable, estimates, {
       consensus_delta_usd: extra_usd,
@@ -39226,6 +39682,14 @@ function cmd_run(args, opts = {}) {
       stance_repairs.push(r);
     }
   });
+  const post_run = _postRunQuorum(members, responses, ai_cfg);
+  quorum_out.result = post_run.quorum;
+  skipped.push(...post_run.absent);
+  const handoff = buildHandoffFromStanceTally(
+    stance_tally_on ? tally_stances(
+      responses.filter((r) => !r.error).map((r) => ({ member: `${r.provider}:${r.model}`, text: r.text }))
+    ) : null
+  );
   const persona_labels = build_persona_labels(advisor_plans, billable);
   const peer_review = _maybe_run_peer_review(
     ai_cfg,
@@ -39300,6 +39764,13 @@ function cmd_run(args, opts = {}) {
   if (blind_review_map !== null) {
     payload["blind_review_map"] = _mapToObject(blind_review_map);
   }
+  if (quorum_out.result !== null) {
+    payload["quorum"] = quorum_out.result;
+  }
+  if (skipped.length > 0) {
+    payload["absent_members"] = skipped;
+  }
+  payload["handoff"] = handoff;
   const out_path = _validate_council_output_path(args.output, {
     kind: "responses",
     subcommand: "run"
@@ -39653,7 +40124,10 @@ function cmd_render(args) {
     stance_tally: payload["stance_tally"] === true,
     chairman_fields: payload["chairman_fields"] === true,
     blind: _isDict3(blind_map_raw) ? { label_to_source: _objToMap(blind_map_raw) } : null,
-    chairman: _isDict3(payload["chairman"]) ? payload["chairman"] : null
+    chairman: _isDict3(payload["chairman"]) ? payload["chairman"] : null,
+    handoff: _deserialise_handoff(payload["handoff"]),
+    absent_members: _deserialise_absent_members(payload["absent_members"]),
+    quorum: _deserialise_quorum(payload["quorum"])
   });
   if (_getattr3(args, "output", null)) {
     const out_path = _validate_council_output_path(args.output, {
@@ -39862,7 +40336,8 @@ function _defaultArgs() {
     low_impact_stats: false,
     reset: null,
     log: null,
-    window_days: 7
+    window_days: 7,
+    json: false
   };
 }
 function _usageFor(cmd) {
@@ -39979,6 +40454,12 @@ function _specsFor(cmd) {
         ],
         requiredOpts: []
       };
+    case "status":
+      return {
+        positionals: [],
+        opts: [{ flag: "--json", takesValue: false, apply: (o) => o.json = true }],
+        requiredOpts: []
+      };
     default:
       return { positionals: [], opts: [], requiredOpts: [] };
   }
@@ -40152,6 +40633,9 @@ function main17(argv = null) {
     if (args.cmd === "shadow-report") {
       return cmd_shadow_report(args);
     }
+    if (args.cmd === "status") {
+      return cmd_status(args);
+    }
   } catch (exc) {
     if (exc instanceof CouncilDisabledError) {
       _stderr2(`\u274C  council:${args.cmd}: ${exc.message}
@@ -40183,12 +40667,13 @@ function _isCliEntry17() {
     return false;
   }
 }
-var _ArgExit2, ArgumentTypeError, _PROG9, SCHEMA_VERSION8, _API_PROVIDERS, _CLI_PROVIDERS, _HERE15, REPO_ROOT3, SETTINGS_FILE2, AI_COUNCIL_FILE, COUNCIL_CANONICAL_DIRS, CouncilDisabledError, _CLI_FACTORY, ValueError4, FileNotFoundError3, _SUBCOMMANDS, _TOP_USAGE2;
+var _ArgExit2, ArgumentTypeError, _PROG9, SCHEMA_VERSION8, _API_PROVIDERS, _CLI_PROVIDERS, _HERE15, REPO_ROOT3, SETTINGS_FILE2, AI_COUNCIL_FILE, COUNCIL_CANONICAL_DIRS, CouncilDisabledError, _CLI_FACTORY, ValueError4, _VALID_ABSENT_REASONS, FileNotFoundError3, _SUBCOMMANDS, _TOP_USAGE2;
 var init_council_cli = __esm({
   "src/scripts/council_cli.ts"() {
     "use strict";
     init_agent_settings();
     init_agent_settings();
+    init_environment_detector();
     init_bundler();
     init_chairman();
     init_text_similarity();
@@ -40199,6 +40684,9 @@ var init_council_cli = __esm({
     init_config();
     init_solo_dispatch();
     init_modes();
+    init_transport_resolver();
+    init_transport_resolver();
+    init_quorum();
     init_events_log();
     init_necessity();
     init_orchestrator();
@@ -40209,6 +40697,8 @@ var init_council_cli = __esm({
     init_shadow_dispatch();
     init_low_impact();
     init_blind_review();
+    init_stance_tally();
+    init_handoff();
     _ArgExit2 = class extends Error {
     };
     ArgumentTypeError = class extends Error {
@@ -40249,11 +40739,17 @@ var init_council_cli = __esm({
     };
     ValueError4 = class extends Error {
     };
+    _VALID_ABSENT_REASONS = /* @__PURE__ */ new Set([
+      "no_binary",
+      "no_auth",
+      "timeout",
+      "quota"
+    ]);
     FileNotFoundError3 = class extends Error {
     };
-    _SUBCOMMANDS = ["estimate", "run", "debate", "render", "replay", "quota", "shadow-report"];
+    _SUBCOMMANDS = ["estimate", "run", "debate", "render", "replay", "quota", "shadow-report", "status"];
     _TOP_USAGE2 = `usage: ${_PROG9} [-h]
-                            {estimate,run,debate,render,replay,quota,shadow-report}
+                            {estimate,run,debate,render,replay,quota,shadow-report,status}
                             ...
 `;
     if (_isCliEntry17()) {