@codedrifters/configulator 0.0.254 → 0.0.256

package/lib/index.d.mts

@@ -925,6 +925,201 @@ interface AgentPathsConfig {
      */
     readonly industriesRoot?: string;
 }
+/*******************************************************************************
+ *
+ * Priority Rules
+ *
+ ******************************************************************************/
+/**
+ * A single project-specific priority-detection rule.
+ *
+ * Rules let consuming repos declare a sector-prefix regex, label, body
+ * regex, or explicit issue-number pin that maps to one of the five
+ * `priority:*` tiers. The `base` bundle renders a "Project-specific
+ * priority rules" subsection into the `issue-label-conventions` rule
+ * when `AgentConfigOptions.priorityRules` is non-empty, in precedence
+ * order.
+ *
+ * Precedence is **first match wins** — rules are evaluated in the
+ * order supplied, and the bundle's default inference heuristics act as
+ * the fallback when nothing matches.
+ *
+ * @see AgentConfigOptions.priorityRules
+ */
+interface PriorityRule {
+    /** Target priority tier the rule maps matched issues to. */
+    readonly priority: "critical" | "high" | "medium" | "low" | "trivial";
+    /**
+     * Match predicate. At least one sub-field should be set; multiple
+     * sub-fields on the same rule combine as a logical OR (any one
+     * matching fires the rule).
+     */
+    readonly match: {
+        /** Any of these labels present on the issue matches. */
+        readonly labels?: ReadonlyArray<string>;
+        /** Regex applied to the issue title, anchored as supplied. */
+        readonly titleRegex?: string;
+        /** Regex applied to the issue body, anchored as supplied. */
+        readonly bodyRegex?: string;
+        /** Explicit issue numbers pinned to this priority. */
+        readonly issueNumbers?: ReadonlyArray<number>;
+    };
+    /**
+     * Human-readable rationale rendered into the generated rule
+     * content so reviewers understand why the rule exists.
+     */
+    readonly rationale: string;
+}
+/*******************************************************************************
+ *
+ * Focus Scoring
+ *
+ ******************************************************************************/
+/**
+ * Match predicate for a single focus area. At least one sub-field
+ * should be set; multiple sub-fields on the same match combine as a
+ * logical OR (any one matching contributes the focus area's weight).
+ *
+ * @see FocusArea
+ */
+interface FocusAreaMatch {
+    /** Any of these labels present on the issue matches. */
+    readonly labels?: ReadonlyArray<string>;
+    /**
+     * Case-insensitive substrings matched against the issue title.
+     * A hit on any single keyword fires the match.
+     */
+    readonly titleKeywords?: ReadonlyArray<string>;
+    /**
+     * Case-insensitive substrings matched against the issue body.
+     * A hit on any single keyword fires the match.
+     */
+    readonly bodyKeywords?: ReadonlyArray<string>;
+}
+/**
+ * A single scored focus area — a named customer, segment,
+ * organization, software product, regulation, or person the project
+ * cares about right now. Matching issues receive this area's
+ * `weight` as a priority boost at triage time.
+ *
+ * @see FocusConfig
+ * @see ./bundles/focus.ts#renderFocusSection
+ */
+interface FocusArea {
+    /** Human-readable name for the focus area (e.g. "Acme Corp"). */
+    readonly name: string;
+    /**
+     * Consuming-repo-defined vocabulary describing what kind of entity
+     * this focus area represents (e.g. `"customer"`, `"segment"`,
+     * `"organization"`, `"software"`, `"regulation"`, `"person"`).
+     * The `AgentExpansionRules.allowedTypes` /
+     * `AgentExpansionRules.forbiddenTypes` lists gate what values
+     * agents are permitted to introduce.
+     */
+    readonly type: string;
+    /**
+     * Provenance. `"human"` entries are curated by a maintainer;
+     * `"agent"` entries were appended by an agent under the
+     * agent-expansion rules and must carry a `discoveredIn` reference.
+     */
+    readonly source: "human" | "agent";
+    /**
+     * Issue reference (e.g. `"#123"`) that introduced the focus area.
+     * Required when `source` is `"agent"` so the provenance of every
+     * agent-appended entry is auditable; optional for human entries.
+     */
+    readonly discoveredIn?: string;
+    /** Match predicate that decides which issues this area applies to. */
+    readonly match: FocusAreaMatch;
+    /**
+     * Positive integer weight contributed to the issue's focus score
+     * when the match fires. Consuming repos typically cap this with
+     * `AgentExpansionRules.maxWeight` (default 8 in openhi's reference
+     * implementation).
+     */
+    readonly weight: number;
+}
+/**
+ * Guard-rails on what agents are allowed to append to `focus.json`
+ * without human review. The agent-expansion contract is append-only:
+ * agents never modify or remove existing entries.
+ */
+interface AgentExpansionRules {
+    /**
+     * Hard cap on the `weight` an agent may set on a newly appended
+     * focus area. Human curators may use higher weights.
+     */
+    readonly maxWeight: number;
+    /**
+     * Whitelist of `FocusArea.type` values agents are permitted to
+     * introduce. Any type outside this list must be added by a human.
+     */
+    readonly allowedTypes: ReadonlyArray<string>;
+    /**
+     * Explicit blocklist of `FocusArea.type` values agents must never
+     * introduce, even if the list accidentally overlaps
+     * `allowedTypes`. `forbiddenTypes` wins on conflict.
+     */
+    readonly forbiddenTypes: ReadonlyArray<string>;
+    /**
+     * Optional cap on the number of entries in each keyword array
+     * (`match.labels`, `match.titleKeywords`, `match.bodyKeywords`)
+     * on an agent-appended focus area. Prevents runaway keyword
+     * expansion. Human entries are not subject to this cap.
+     */
+    readonly maxKeywords?: number;
+}
+/**
+ * Top-level configuration for the focus-scoring engine. The schema
+ * and agent-expansion rules live in the configulator bundle; the
+ * actual `focus.json` file is authored and curated in the consuming
+ * repo.
+ *
+ * When supplied via `AgentConfigOptions.focus`, the `base` bundle
+ * appends a "Focus scoring" subsection to the
+ * `issue-label-conventions` rule that teaches agents how to read
+ * `focus.json`, how focus weight interacts with the
+ * `priority:*` taxonomy, and what they may and may not append to
+ * the file.
+ *
+ * @see FocusArea
+ * @see AgentExpansionRules
+ * @see ./bundles/focus.ts#renderFocusSection
+ */
+interface FocusConfig {
+    /**
+     * Path to the focus file relative to the repo root.
+     * @default ".claude/focus.json"
+     */
+    readonly focusFilePath?: string;
+    /**
+     * Schema version the consuming repo's `focus.json` conforms to.
+     * Bump when the schema changes in a backwards-incompatible way.
+     * @default 1
+     */
+    readonly schemaVersion?: number;
+    /**
+     * Cumulative focus-score thresholds that map into the
+     * `priority:*` taxonomy. An issue whose total focus score
+     * (sum of matched focus-area weights) reaches `high` is boosted
+     * to `priority:high`; reaching `medium` keeps it at
+     * `priority:medium`. Scores below `medium` do not affect the
+     * inferred priority.
+     *
+     * @remarks `high` and `medium` must be integers. The JSON schema
+     * at `schemas/focus.schema.json` enforces this for `focus.json`.
+     */
+    readonly thresholds?: {
+        readonly high: number;
+        readonly medium: number;
+    };
+    /**
+     * Guard-rails that govern what agents may append to `focus.json`.
+     * When omitted, the rendered rule documents that agents must
+     * **not** append to `focus.json` without human review.
+     */
+    readonly agentExpansionRules?: AgentExpansionRules;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -1023,6 +1218,40 @@ interface AgentConfigOptions {
      * does not yet alter generated rules.
      */
     readonly paths?: AgentPathsConfig;
+    /**
+     * Project-specific priority-detection rules. Each rule declares a
+     * match predicate (labels, title regex, body regex, or explicit
+     * issue numbers) and a target `priority:*` tier.
+     *
+     * When non-empty, the `base` bundle renders a "Project-specific
+     * priority rules" subsection into the `issue-label-conventions`
+     * rule. Precedence is **first match wins**; the bundle's default
+     * inference heuristics act as the fallback when no rule matches.
+     *
+     * @see PriorityRule
+     * @see ./bundles/priority-rules.ts#renderPriorityRulesSection
+     */
+    readonly priorityRules?: ReadonlyArray<PriorityRule>;
+    /**
+     * Focus-scoring configuration. Declares the path to the consuming
+     * repo's `focus.json` file, score thresholds, and the
+     * agent-expansion rules that govern what agents may append to the
+     * file.
+     *
+     * When set, the `base` bundle appends a "Focus scoring"
+     * subsection to the `issue-label-conventions` rule that teaches
+     * agents (a) how to read `focus.json`, (b) how focus weight
+     * interacts with the `priority:*` taxonomy, and (c) the
+     * agent-driven expansion contract. The actual `focus.json` file
+     * is authored and curated in the consuming repo — configulator
+     * ships the schema and agent instructions only.
+     *
+     * @see FocusConfig
+     * @see FocusArea
+     * @see AgentExpansionRules
+     * @see ./bundles/focus.ts#renderFocusSection
+     */
+    readonly focus?: FocusConfig;
 }
 
 /**
@@ -1295,6 +1524,36 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * Render the markdown subsection appended to the
+ * `issue-label-conventions` rule when `AgentConfigOptions.focus` is
+ * supplied. Returns an empty string when `focus` is undefined so
+ * callers can unconditionally concatenate the result.
+ *
+ * The section documents three things for agents:
+ *
+ * 1. How to read `focus.json` at triage time
+ * 2. How focus weight interacts with the `priority:*` taxonomy
+ * 3. The agent-driven expansion contract (what agents may append)
+ *
+ * Configulator ships this rule content plus a JSON Schema that
+ * validates the `focus.json` file; the file itself is authored and
+ * curated in the consuming repo.
+ */
+declare function renderFocusSection(focus: FocusConfig | undefined): string;
+
+/**
+ * Render the markdown subsection appended to the
+ * `issue-label-conventions` rule when `AgentConfigOptions.priorityRules`
+ * is non-empty. Returns an empty string when the supplied array is
+ * empty so callers can unconditionally concatenate the result.
+ *
+ * Precedence is **first match wins** — rules render in the order
+ * supplied. The bundle's default inference heuristics act as the
+ * fallback when no rule matches.
+ */
+declare function renderPriorityRulesSection(rules: ReadonlyArray<PriorityRule>): string;
+
 /**
  * Requirements-analyst bundle — opt-in via `includeBundles: [\"requirements-analyst\"]`.
  *
@@ -4017,4 +4276,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPathsConfig, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_AGENT_PATHS, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedProjectMetadata, STARLIGHT_ROLE, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentExpansionRules, type AgentModel, type AgentPathsConfig, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_AGENT_PATHS, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, type PriorityRule, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedProjectMetadata, STARLIGHT_ROLE, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, renderFocusSection, renderPriorityRulesSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };

package/lib/index.d.ts

@@ -974,6 +974,201 @@ interface AgentPathsConfig {
      */
     readonly industriesRoot?: string;
 }
+/*******************************************************************************
+ *
+ * Priority Rules
+ *
+ ******************************************************************************/
+/**
+ * A single project-specific priority-detection rule.
+ *
+ * Rules let consuming repos declare a sector-prefix regex, label, body
+ * regex, or explicit issue-number pin that maps to one of the five
+ * `priority:*` tiers. The `base` bundle renders a "Project-specific
+ * priority rules" subsection into the `issue-label-conventions` rule
+ * when `AgentConfigOptions.priorityRules` is non-empty, in precedence
+ * order.
+ *
+ * Precedence is **first match wins** — rules are evaluated in the
+ * order supplied, and the bundle's default inference heuristics act as
+ * the fallback when nothing matches.
+ *
+ * @see AgentConfigOptions.priorityRules
+ */
+interface PriorityRule {
+    /** Target priority tier the rule maps matched issues to. */
+    readonly priority: "critical" | "high" | "medium" | "low" | "trivial";
+    /**
+     * Match predicate. At least one sub-field should be set; multiple
+     * sub-fields on the same rule combine as a logical OR (any one
+     * matching fires the rule).
+     */
+    readonly match: {
+        /** Any of these labels present on the issue matches. */
+        readonly labels?: ReadonlyArray<string>;
+        /** Regex applied to the issue title, anchored as supplied. */
+        readonly titleRegex?: string;
+        /** Regex applied to the issue body, anchored as supplied. */
+        readonly bodyRegex?: string;
+        /** Explicit issue numbers pinned to this priority. */
+        readonly issueNumbers?: ReadonlyArray<number>;
+    };
+    /**
+     * Human-readable rationale rendered into the generated rule
+     * content so reviewers understand why the rule exists.
+     */
+    readonly rationale: string;
+}
+/*******************************************************************************
+ *
+ * Focus Scoring
+ *
+ ******************************************************************************/
+/**
+ * Match predicate for a single focus area. At least one sub-field
+ * should be set; multiple sub-fields on the same match combine as a
+ * logical OR (any one matching contributes the focus area's weight).
+ *
+ * @see FocusArea
+ */
+interface FocusAreaMatch {
+    /** Any of these labels present on the issue matches. */
+    readonly labels?: ReadonlyArray<string>;
+    /**
+     * Case-insensitive substrings matched against the issue title.
+     * A hit on any single keyword fires the match.
+     */
+    readonly titleKeywords?: ReadonlyArray<string>;
+    /**
+     * Case-insensitive substrings matched against the issue body.
+     * A hit on any single keyword fires the match.
+     */
+    readonly bodyKeywords?: ReadonlyArray<string>;
+}
+/**
+ * A single scored focus area — a named customer, segment,
+ * organization, software product, regulation, or person the project
+ * cares about right now. Matching issues receive this area's
+ * `weight` as a priority boost at triage time.
+ *
+ * @see FocusConfig
+ * @see ./bundles/focus.ts#renderFocusSection
+ */
+interface FocusArea {
+    /** Human-readable name for the focus area (e.g. "Acme Corp"). */
+    readonly name: string;
+    /**
+     * Consuming-repo-defined vocabulary describing what kind of entity
+     * this focus area represents (e.g. `"customer"`, `"segment"`,
+     * `"organization"`, `"software"`, `"regulation"`, `"person"`).
+     * The `AgentExpansionRules.allowedTypes` /
+     * `AgentExpansionRules.forbiddenTypes` lists gate what values
+     * agents are permitted to introduce.
+     */
+    readonly type: string;
+    /**
+     * Provenance. `"human"` entries are curated by a maintainer;
+     * `"agent"` entries were appended by an agent under the
+     * agent-expansion rules and must carry a `discoveredIn` reference.
+     */
+    readonly source: "human" | "agent";
+    /**
+     * Issue reference (e.g. `"#123"`) that introduced the focus area.
+     * Required when `source` is `"agent"` so the provenance of every
+     * agent-appended entry is auditable; optional for human entries.
+     */
+    readonly discoveredIn?: string;
+    /** Match predicate that decides which issues this area applies to. */
+    readonly match: FocusAreaMatch;
+    /**
+     * Positive integer weight contributed to the issue's focus score
+     * when the match fires. Consuming repos typically cap this with
+     * `AgentExpansionRules.maxWeight` (default 8 in openhi's reference
+     * implementation).
+     */
+    readonly weight: number;
+}
+/**
+ * Guard-rails on what agents are allowed to append to `focus.json`
+ * without human review. The agent-expansion contract is append-only:
+ * agents never modify or remove existing entries.
+ */
+interface AgentExpansionRules {
+    /**
+     * Hard cap on the `weight` an agent may set on a newly appended
+     * focus area. Human curators may use higher weights.
+     */
+    readonly maxWeight: number;
+    /**
+     * Whitelist of `FocusArea.type` values agents are permitted to
+     * introduce. Any type outside this list must be added by a human.
+     */
+    readonly allowedTypes: ReadonlyArray<string>;
+    /**
+     * Explicit blocklist of `FocusArea.type` values agents must never
+     * introduce, even if the list accidentally overlaps
+     * `allowedTypes`. `forbiddenTypes` wins on conflict.
+     */
+    readonly forbiddenTypes: ReadonlyArray<string>;
+    /**
+     * Optional cap on the number of entries in each keyword array
+     * (`match.labels`, `match.titleKeywords`, `match.bodyKeywords`)
+     * on an agent-appended focus area. Prevents runaway keyword
+     * expansion. Human entries are not subject to this cap.
+     */
+    readonly maxKeywords?: number;
+}
+/**
+ * Top-level configuration for the focus-scoring engine. The schema
+ * and agent-expansion rules live in the configulator bundle; the
+ * actual `focus.json` file is authored and curated in the consuming
+ * repo.
+ *
+ * When supplied via `AgentConfigOptions.focus`, the `base` bundle
+ * appends a "Focus scoring" subsection to the
+ * `issue-label-conventions` rule that teaches agents how to read
+ * `focus.json`, how focus weight interacts with the
+ * `priority:*` taxonomy, and what they may and may not append to
+ * the file.
+ *
+ * @see FocusArea
+ * @see AgentExpansionRules
+ * @see ./bundles/focus.ts#renderFocusSection
+ */
+interface FocusConfig {
+    /**
+     * Path to the focus file relative to the repo root.
+     * @default ".claude/focus.json"
+     */
+    readonly focusFilePath?: string;
+    /**
+     * Schema version the consuming repo's `focus.json` conforms to.
+     * Bump when the schema changes in a backwards-incompatible way.
+     * @default 1
+     */
+    readonly schemaVersion?: number;
+    /**
+     * Cumulative focus-score thresholds that map into the
+     * `priority:*` taxonomy. An issue whose total focus score
+     * (sum of matched focus-area weights) reaches `high` is boosted
+     * to `priority:high`; reaching `medium` keeps it at
+     * `priority:medium`. Scores below `medium` do not affect the
+     * inferred priority.
+     *
+     * @remarks `high` and `medium` must be integers. The JSON schema
+     * at `schemas/focus.schema.json` enforces this for `focus.json`.
+     */
+    readonly thresholds?: {
+        readonly high: number;
+        readonly medium: number;
+    };
+    /**
+     * Guard-rails that govern what agents may append to `focus.json`.
+     * When omitted, the rendered rule documents that agents must
+     * **not** append to `focus.json` without human review.
+     */
+    readonly agentExpansionRules?: AgentExpansionRules;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -1072,6 +1267,40 @@ interface AgentConfigOptions {
      * does not yet alter generated rules.
      */
     readonly paths?: AgentPathsConfig;
+    /**
+     * Project-specific priority-detection rules. Each rule declares a
+     * match predicate (labels, title regex, body regex, or explicit
+     * issue numbers) and a target `priority:*` tier.
+     *
+     * When non-empty, the `base` bundle renders a "Project-specific
+     * priority rules" subsection into the `issue-label-conventions`
+     * rule. Precedence is **first match wins**; the bundle's default
+     * inference heuristics act as the fallback when no rule matches.
+     *
+     * @see PriorityRule
+     * @see ./bundles/priority-rules.ts#renderPriorityRulesSection
+     */
+    readonly priorityRules?: ReadonlyArray<PriorityRule>;
+    /**
+     * Focus-scoring configuration. Declares the path to the consuming
+     * repo's `focus.json` file, score thresholds, and the
+     * agent-expansion rules that govern what agents may append to the
+     * file.
+     *
+     * When set, the `base` bundle appends a "Focus scoring"
+     * subsection to the `issue-label-conventions` rule that teaches
+     * agents (a) how to read `focus.json`, (b) how focus weight
+     * interacts with the `priority:*` taxonomy, and (c) the
+     * agent-driven expansion contract. The actual `focus.json` file
+     * is authored and curated in the consuming repo — configulator
+     * ships the schema and agent instructions only.
+     *
+     * @see FocusConfig
+     * @see FocusArea
+     * @see AgentExpansionRules
+     * @see ./bundles/focus.ts#renderFocusSection
+     */
+    readonly focus?: FocusConfig;
 }
 
 /**
@@ -1344,6 +1573,36 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * Render the markdown subsection appended to the
+ * `issue-label-conventions` rule when `AgentConfigOptions.focus` is
+ * supplied. Returns an empty string when `focus` is undefined so
+ * callers can unconditionally concatenate the result.
+ *
+ * The section documents three things for agents:
+ *
+ * 1. How to read `focus.json` at triage time
+ * 2. How focus weight interacts with the `priority:*` taxonomy
+ * 3. The agent-driven expansion contract (what agents may append)
+ *
+ * Configulator ships this rule content plus a JSON Schema that
+ * validates the `focus.json` file; the file itself is authored and
+ * curated in the consuming repo.
+ */
+declare function renderFocusSection(focus: FocusConfig | undefined): string;
+
+/**
+ * Render the markdown subsection appended to the
+ * `issue-label-conventions` rule when `AgentConfigOptions.priorityRules`
+ * is non-empty. Returns an empty string when the supplied array is
+ * empty so callers can unconditionally concatenate the result.
+ *
+ * Precedence is **first match wins** — rules render in the order
+ * supplied. The bundle's default inference heuristics act as the
+ * fallback when no rule matches.
+ */
+declare function renderPriorityRulesSection(rules: ReadonlyArray<PriorityRule>): string;
+
 /**
  * Requirements-analyst bundle — opt-in via `includeBundles: [\"requirements-analyst\"]`.
  *
@@ -4066,5 +4325,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AGENT_PATHS, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, STARLIGHT_ROLE, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
-export type { AgentConfigOptions, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, LayoutEnforcement, LayoutViolation, McpServerConfig, McpTransport, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AGENT_PATHS, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, STARLIGHT_ROLE, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, renderFocusSection, renderPriorityRulesSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
+export type { AgentConfigOptions, AgentExpansionRules, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, LayoutEnforcement, LayoutViolation, McpServerConfig, McpTransport, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };