@codedrifters/configulator 0.0.298 → 0.0.299

package/lib/index.d.mts

@@ -2711,6 +2711,26 @@ interface AgentConfigOptions {
      * @default 'balanced'
      */
     readonly defaultAgentTier?: "powerful" | "balanced" | "fast";
+    /**
+     * Per-bundle override for `defaultAgentTier`. Bundle name keyed
+     * (matches the bundle's `name` field, e.g. `'meeting-analysis'`,
+     * `'company-profile'`). Bundles not present in the map fall back
+     * to `defaultAgentTier`.
+     *
+     * Only the six tier-aware bundles (`meeting-analysis`,
+     * `company-profile`, `customer-profile`, `people-profile`,
+     * `software-profile`, `maintenance-audit`) read this map — the
+     * four reviewer/orchestrator agents (orchestrator, issue-worker,
+     * pr-reviewer, requirements-reviewer) ignore both this map and
+     * `defaultAgentTier` and stay on POWERFUL.
+     *
+     * Synth fails with a clear error if a key in the map does not
+     * match one of the six tier-aware bundle names — typos or
+     * deprecated bundle names would otherwise be silently ignored.
+     *
+     * @default {}
+     */
+    readonly bundleAgentTiers?: Readonly<Record<string, "powerful" | "balanced" | "fast">>;
     /**
      * Additional agent rules to generate alongside auto-detected and bundled rules.
      * Custom rules override bundled rules of the same name.
@@ -4848,17 +4868,19 @@ declare function renderUnblockDependentsScript(ud: ResolvedUnblockDependents): s
 
 /**
  * Build the check-blocked.sh procedure definition for a given resolved
- * tier table, scope gate, and run-ratio config. `AgentConfig.preSynthesize`
- * calls this with the consumer's resolved configs so the emitted
- * script's `tier_of()` lookup, `scope_of()` thresholds, and
- * `run_counter_tick()` cycle length match whatever the rendered
- * orchestrator-conventions rule documents.
+ * tier table and scope gate. `AgentConfig.preSynthesize` calls this
+ * with the consumer's resolved configs so the emitted script's
+ * `tier_of()` lookup and `scope_of()` thresholds match whatever the
+ * rendered orchestrator-conventions rule documents.
  *
  * Scope-gate settings default to the bundle's built-in defaults
  * (small: ≤3 AC + ≤2 sources; medium: ≤6 AC + ≤5 sources;
- * auto-file off) when the caller omits them. Run-ratio settings
- * default to the openhi 4:1 cadence with the counter persisted at
- * `.state/orchestrator-runs.json`.
+ * auto-file off) when the caller omits them.
+ *
+ * The `runRatio` parameter is retained for API compatibility but is no
+ * longer rendered into the script — the orchestrator runs a single
+ * linear cycle on every invocation, so the run counter / tick
+ * subcommand were retired.
  */
 declare function buildCheckBlockedProcedure(tiers: ReadonlyArray<ResolvedAgentTier>, scopeGate?: ResolvedScopeGate, runRatio?: ResolvedRunRatio): AgentProcedure;
 /*******************************************************************************
@@ -4879,15 +4901,22 @@ declare function buildCheckBlockedProcedure(tiers: ReadonlyArray<ResolvedAgentTi
 declare function buildUnblockDependentsProcedure(unblockDependents?: ResolvedUnblockDependents): AgentProcedure;
 /**
  * Build the orchestrator-conventions rule content for a given resolved
- * tier table, scope gate, run-ratio, scheduled-tasks, and
- * unblock-dependents config. The preamble is constant; each section
- * below it is rendered from the supplied values so consumer overrides
- * propagate into the generated rule.
+ * tier table, scope gate, scheduled-tasks, and unblock-dependents
+ * config. The preamble is constant; each section below it is rendered
+ * from the supplied values so consumer overrides propagate into the
+ * generated rule.
  *
  * Every optional parameter defaults to the bundle's built-in default
  * when the caller omits it.
+ *
+ * The `runRatio` parameter is retained for API compatibility but is
+ * no longer rendered into the conventions content — the orchestrator
+ * runs a single linear cycle on every invocation, so the
+ * dispatch/housekeeping ratio convention was retired. See Phase B
+ * (PR review sweep) in `.claude/agents/orchestrator.md` for the
+ * replacement workflow.
  */
-declare function buildOrchestratorConventionsContent(tiers: ReadonlyArray<ResolvedAgentTier>, scopeGate?: ResolvedScopeGate, runRatio?: ResolvedRunRatio, scheduledTasks?: ResolvedScheduledTasks, unblockDependents?: ResolvedUnblockDependents, excludeBundles?: ReadonlyArray<string>): string;
+declare function buildOrchestratorConventionsContent(tiers: ReadonlyArray<ResolvedAgentTier>, scopeGate?: ResolvedScopeGate, _runRatio?: ResolvedRunRatio, scheduledTasks?: ResolvedScheduledTasks, unblockDependents?: ResolvedUnblockDependents, excludeBundles?: ReadonlyArray<string>): string;
 /**
  * Resolve the orchestrator-conventions rule content and the
  * check-blocked.sh procedure content for a given (possibly absent)
@@ -4898,6 +4927,12 @@ declare function buildOrchestratorConventionsContent(tiers: ReadonlyArray<Resolv
  * scheduled-tasks config alongside both rendered artifacts so callers
  * can splice them into their rule map and procedure map in a single
  * pass.
+ *
+ * The `runRatio` parameter is retained for API compatibility but no
+ * longer feeds the rendered conventions content or the
+ * `check-blocked.sh` script — the orchestrator runs a single linear
+ * cycle on every invocation, so the run-counter / `tick` subcommand
+ * were retired.
  */
 declare function resolveOrchestratorAssets(tierConfig?: AgentTierConfig, scopeGateConfig?: ScopeGateConfig, runRatioConfig?: RunRatioConfig, scheduledTasksConfig?: ScheduledTasksConfig, unblockDependentsConfig?: UnblockDependentsConfig, excludeBundles?: ReadonlyArray<string>): {
     readonly tiers: ReadonlyArray<ResolvedAgentTier>;
@@ -5987,7 +6022,7 @@ declare const vitestBundle: AgentRuleBundle;
  * Bundles that do not read any agent path (typescript, jest,
  * pnpm, etc.) stay as const exports and are referenced unchanged.
  */
-declare function buildBuiltInBundles(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults, defaultAgentTier?: AgentModel): ReadonlyArray<AgentRuleBundle>;
+declare function buildBuiltInBundles(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults, defaultAgentTier?: AgentModel, bundleAgentTiers?: ReadonlyMap<string, AgentModel>): ReadonlyArray<AgentRuleBundle>;
 /**
  * Built-in rule bundles assembled with the default agent paths.
  * Preserved for backward compatibility with tests and consumers

package/lib/index.d.ts

@@ -2760,6 +2760,26 @@ interface AgentConfigOptions {
      * @default 'balanced'
      */
     readonly defaultAgentTier?: "powerful" | "balanced" | "fast";
+    /**
+     * Per-bundle override for `defaultAgentTier`. Bundle name keyed
+     * (matches the bundle's `name` field, e.g. `'meeting-analysis'`,
+     * `'company-profile'`). Bundles not present in the map fall back
+     * to `defaultAgentTier`.
+     *
+     * Only the six tier-aware bundles (`meeting-analysis`,
+     * `company-profile`, `customer-profile`, `people-profile`,
+     * `software-profile`, `maintenance-audit`) read this map — the
+     * four reviewer/orchestrator agents (orchestrator, issue-worker,
+     * pr-reviewer, requirements-reviewer) ignore both this map and
+     * `defaultAgentTier` and stay on POWERFUL.
+     *
+     * Synth fails with a clear error if a key in the map does not
+     * match one of the six tier-aware bundle names — typos or
+     * deprecated bundle names would otherwise be silently ignored.
+     *
+     * @default {}
+     */
+    readonly bundleAgentTiers?: Readonly<Record<string, "powerful" | "balanced" | "fast">>;
     /**
      * Additional agent rules to generate alongside auto-detected and bundled rules.
      * Custom rules override bundled rules of the same name.
@@ -4897,17 +4917,19 @@ declare function renderUnblockDependentsScript(ud: ResolvedUnblockDependents): s
 
 /**
  * Build the check-blocked.sh procedure definition for a given resolved
- * tier table, scope gate, and run-ratio config. `AgentConfig.preSynthesize`
- * calls this with the consumer's resolved configs so the emitted
- * script's `tier_of()` lookup, `scope_of()` thresholds, and
- * `run_counter_tick()` cycle length match whatever the rendered
- * orchestrator-conventions rule documents.
+ * tier table and scope gate. `AgentConfig.preSynthesize` calls this
+ * with the consumer's resolved configs so the emitted script's
+ * `tier_of()` lookup and `scope_of()` thresholds match whatever the
+ * rendered orchestrator-conventions rule documents.
  *
  * Scope-gate settings default to the bundle's built-in defaults
  * (small: ≤3 AC + ≤2 sources; medium: ≤6 AC + ≤5 sources;
- * auto-file off) when the caller omits them. Run-ratio settings
- * default to the openhi 4:1 cadence with the counter persisted at
- * `.state/orchestrator-runs.json`.
+ * auto-file off) when the caller omits them.
+ *
+ * The `runRatio` parameter is retained for API compatibility but is no
+ * longer rendered into the script — the orchestrator runs a single
+ * linear cycle on every invocation, so the run counter / tick
+ * subcommand were retired.
  */
 declare function buildCheckBlockedProcedure(tiers: ReadonlyArray<ResolvedAgentTier>, scopeGate?: ResolvedScopeGate, runRatio?: ResolvedRunRatio): AgentProcedure;
 /*******************************************************************************
@@ -4928,15 +4950,22 @@ declare function buildCheckBlockedProcedure(tiers: ReadonlyArray<ResolvedAgentTi
 declare function buildUnblockDependentsProcedure(unblockDependents?: ResolvedUnblockDependents): AgentProcedure;
 /**
  * Build the orchestrator-conventions rule content for a given resolved
- * tier table, scope gate, run-ratio, scheduled-tasks, and
- * unblock-dependents config. The preamble is constant; each section
- * below it is rendered from the supplied values so consumer overrides
- * propagate into the generated rule.
+ * tier table, scope gate, scheduled-tasks, and unblock-dependents
+ * config. The preamble is constant; each section below it is rendered
+ * from the supplied values so consumer overrides propagate into the
+ * generated rule.
  *
  * Every optional parameter defaults to the bundle's built-in default
  * when the caller omits it.
+ *
+ * The `runRatio` parameter is retained for API compatibility but is
+ * no longer rendered into the conventions content — the orchestrator
+ * runs a single linear cycle on every invocation, so the
+ * dispatch/housekeeping ratio convention was retired. See Phase B
+ * (PR review sweep) in `.claude/agents/orchestrator.md` for the
+ * replacement workflow.
  */
-declare function buildOrchestratorConventionsContent(tiers: ReadonlyArray<ResolvedAgentTier>, scopeGate?: ResolvedScopeGate, runRatio?: ResolvedRunRatio, scheduledTasks?: ResolvedScheduledTasks, unblockDependents?: ResolvedUnblockDependents, excludeBundles?: ReadonlyArray<string>): string;
+declare function buildOrchestratorConventionsContent(tiers: ReadonlyArray<ResolvedAgentTier>, scopeGate?: ResolvedScopeGate, _runRatio?: ResolvedRunRatio, scheduledTasks?: ResolvedScheduledTasks, unblockDependents?: ResolvedUnblockDependents, excludeBundles?: ReadonlyArray<string>): string;
 /**
  * Resolve the orchestrator-conventions rule content and the
  * check-blocked.sh procedure content for a given (possibly absent)
@@ -4947,6 +4976,12 @@ declare function buildOrchestratorConventionsContent(tiers: ReadonlyArray<Resolv
  * scheduled-tasks config alongside both rendered artifacts so callers
  * can splice them into their rule map and procedure map in a single
  * pass.
+ *
+ * The `runRatio` parameter is retained for API compatibility but no
+ * longer feeds the rendered conventions content or the
+ * `check-blocked.sh` script — the orchestrator runs a single linear
+ * cycle on every invocation, so the run-counter / `tick` subcommand
+ * were retired.
  */
 declare function resolveOrchestratorAssets(tierConfig?: AgentTierConfig, scopeGateConfig?: ScopeGateConfig, runRatioConfig?: RunRatioConfig, scheduledTasksConfig?: ScheduledTasksConfig, unblockDependentsConfig?: UnblockDependentsConfig, excludeBundles?: ReadonlyArray<string>): {
     readonly tiers: ReadonlyArray<ResolvedAgentTier>;
@@ -6036,7 +6071,7 @@ declare const vitestBundle: AgentRuleBundle;
  * Bundles that do not read any agent path (typescript, jest,
  * pnpm, etc.) stay as const exports and are referenced unchanged.
  */
-declare function buildBuiltInBundles(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults, defaultAgentTier?: AgentModel): ReadonlyArray<AgentRuleBundle>;
+declare function buildBuiltInBundles(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults, defaultAgentTier?: AgentModel, bundleAgentTiers?: ReadonlyMap<string, AgentModel>): ReadonlyArray<AgentRuleBundle>;
 /**
  * Built-in rule bundles assembled with the default agent paths.
  * Preserved for backward compatibility with tests and consumers