@codedrifters/configulator 0.0.253 → 0.0.255

package/lib/index.d.mts

@@ -846,6 +846,130 @@ interface ClaudeSettingsConfig {
      */
     readonly respectGitignore?: boolean;
 }
+/*******************************************************************************
+ *
+ * Agent Paths Config
+ *
+ ******************************************************************************/
+/**
+ * Consumer-facing overrides for the output-path roots used by agent
+ * bundles. Every field is optional; unset fields cascade from their
+ * parent root (resolved by `resolveAgentPaths()` in
+ * `./bundles/paths.ts`).
+ *
+ * Bundles read these values indirectly through `DEFAULT_AGENT_PATHS`
+ * (module-eval-time defaults) today. Per-project propagation through
+ * `AgentConfig.resolveRules` lands in a follow-up change.
+ */
+interface AgentPathsConfig {
+    /**
+     * Root folder for the monorepo-wide Starlight docs site content.
+     * @default "docs/src/content/docs"
+     */
+    readonly docsRoot?: string;
+    /**
+     * Root folder for all research outputs (scopes, slices,
+     * deliverables) produced by the `research-analyst` pipeline.
+     * @default "docs/research"
+     */
+    readonly researchRoot?: string;
+    /**
+     * Root folder for profile documents (people, companies, software,
+     * industries).
+     * @default "<docsRoot>/profiles"
+     */
+    readonly profilesRoot?: string;
+    /**
+     * Root folder for meeting notes and transcripts produced by the
+     * `meeting-analyst` pipeline.
+     * @default "<docsRoot>/meetings"
+     */
+    readonly meetingsRoot?: string;
+    /**
+     * Root folder for final requirement documents produced by the
+     * `requirements-writer` agent.
+     * @default "<docsRoot>/requirements"
+     */
+    readonly requirementsRoot?: string;
+    /**
+     * Root folder where the `requirements-analyst` writes requirement
+     * proposals before they are promoted into the final requirements
+     * tree.
+     * @default "<researchRoot>/requirements"
+     */
+    readonly researchRequirementsRoot?: string;
+    /**
+     * Root folder for BCM (Business Capability Model) capability-model
+     * documents produced by the `bcm-writer` agent.
+     * @default "<docsRoot>/concepts"
+     */
+    readonly bcmRoot?: string;
+    /**
+     * Root folder for people profiles.
+     * @default "<profilesRoot>/people"
+     */
+    readonly peopleRoot?: string;
+    /**
+     * Root folder for company profiles.
+     * @default "<profilesRoot>/companies"
+     */
+    readonly companiesRoot?: string;
+    /**
+     * Root folder for software profiles.
+     * @default "<profilesRoot>/software"
+     */
+    readonly softwareRoot?: string;
+    /**
+     * Root folder for industry profiles.
+     * @default "<profilesRoot>/industries"
+     */
+    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;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -932,6 +1056,32 @@ interface AgentConfigOptions {
      * file visibility control.
      */
     readonly cursorSettings?: CursorSettingsConfig;
+    /**
+     * Overrides for the output-path roots used by agent bundles
+     * (requirements, BCM, profiles, meetings, research). Unset fields
+     * fall back to the defaults captured in
+     * `bundles/paths.ts#DEFAULT_AGENT_PATHS`.
+     *
+     * This option is the first of the Group A framework injection
+     * points from epic #414. Per-project propagation of these values
+     * into bundle rule content lands in a follow-up — setting it today
+     * 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>;
 }
 
 /**
@@ -1119,6 +1269,56 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
  ******************************************************************************/
 declare const orchestratorBundle: AgentRuleBundle;
 
+/**
+ * Fully-resolved agent output-path roots. Every property is required.
+ *
+ * This is the shape that bundle code consumes at module-eval time via
+ * `DEFAULT_AGENT_PATHS`, and the shape that `resolveAgentPaths()`
+ * returns when consumers supply a partial `AgentPathsConfig` override.
+ */
+interface ResolvedAgentPaths {
+    readonly docsRoot: string;
+    readonly researchRoot: string;
+    readonly profilesRoot: string;
+    readonly meetingsRoot: string;
+    readonly requirementsRoot: string;
+    readonly researchRequirementsRoot: string;
+    readonly bcmRoot: string;
+    readonly peopleRoot: string;
+    readonly companiesRoot: string;
+    readonly softwareRoot: string;
+    readonly industriesRoot: string;
+}
+/**
+ * Canonical default values for every agent path. These mirror the
+ * hardcoded paths that bundles used before `AgentPathsConfig` existed,
+ * so `DEFAULT_AGENT_PATHS.*` can be substituted into bundle rule
+ * content at module-eval time without changing the generated
+ * `.claude/rules/*.md` snapshot.
+ *
+ * Consumers override the defaults by passing an `AgentPathsConfig`
+ * through `AgentConfigOptions.paths` and resolving it with
+ * `resolveAgentPaths()`. Per-project propagation into bundle rule
+ * content is a follow-up — this export is the first step: interface +
+ * resolver land in this PR; the `AgentConfig.resolveRules` wiring lands
+ * next.
+ */
+declare const DEFAULT_AGENT_PATHS: ResolvedAgentPaths;
+/**
+ * Resolve a partial `AgentPathsConfig` into a fully-populated
+ * `ResolvedAgentPaths`. Unset fields cascade from their parent root:
+ *
+ * - `profilesRoot`, `meetingsRoot`, `requirementsRoot`, and `bcmRoot`
+ *   derive from `docsRoot` when not explicitly set.
+ * - `researchRequirementsRoot` derives from `researchRoot` when not
+ *   explicitly set.
+ * - `peopleRoot`, `companiesRoot`, `softwareRoot`, and `industriesRoot`
+ *   derive from the resolved `profilesRoot` when not explicitly set,
+ *   so that overriding `docsRoot` alone (or overriding `profilesRoot`
+ *   alone) propagates correctly through every dependent root.
+ */
+declare function resolveAgentPaths(paths?: AgentPathsConfig): ResolvedAgentPaths;
+
 /**
  * People-profile bundle — enabled by default.
  *
@@ -1154,6 +1354,18 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * 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\"]`.
  *
@@ -3876,4 +4088,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 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_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 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, 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 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, 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, renderPriorityRulesSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };

package/lib/index.d.ts

@@ -895,6 +895,130 @@ interface ClaudeSettingsConfig {
      */
     readonly respectGitignore?: boolean;
 }
+/*******************************************************************************
+ *
+ * Agent Paths Config
+ *
+ ******************************************************************************/
+/**
+ * Consumer-facing overrides for the output-path roots used by agent
+ * bundles. Every field is optional; unset fields cascade from their
+ * parent root (resolved by `resolveAgentPaths()` in
+ * `./bundles/paths.ts`).
+ *
+ * Bundles read these values indirectly through `DEFAULT_AGENT_PATHS`
+ * (module-eval-time defaults) today. Per-project propagation through
+ * `AgentConfig.resolveRules` lands in a follow-up change.
+ */
+interface AgentPathsConfig {
+    /**
+     * Root folder for the monorepo-wide Starlight docs site content.
+     * @default "docs/src/content/docs"
+     */
+    readonly docsRoot?: string;
+    /**
+     * Root folder for all research outputs (scopes, slices,
+     * deliverables) produced by the `research-analyst` pipeline.
+     * @default "docs/research"
+     */
+    readonly researchRoot?: string;
+    /**
+     * Root folder for profile documents (people, companies, software,
+     * industries).
+     * @default "<docsRoot>/profiles"
+     */
+    readonly profilesRoot?: string;
+    /**
+     * Root folder for meeting notes and transcripts produced by the
+     * `meeting-analyst` pipeline.
+     * @default "<docsRoot>/meetings"
+     */
+    readonly meetingsRoot?: string;
+    /**
+     * Root folder for final requirement documents produced by the
+     * `requirements-writer` agent.
+     * @default "<docsRoot>/requirements"
+     */
+    readonly requirementsRoot?: string;
+    /**
+     * Root folder where the `requirements-analyst` writes requirement
+     * proposals before they are promoted into the final requirements
+     * tree.
+     * @default "<researchRoot>/requirements"
+     */
+    readonly researchRequirementsRoot?: string;
+    /**
+     * Root folder for BCM (Business Capability Model) capability-model
+     * documents produced by the `bcm-writer` agent.
+     * @default "<docsRoot>/concepts"
+     */
+    readonly bcmRoot?: string;
+    /**
+     * Root folder for people profiles.
+     * @default "<profilesRoot>/people"
+     */
+    readonly peopleRoot?: string;
+    /**
+     * Root folder for company profiles.
+     * @default "<profilesRoot>/companies"
+     */
+    readonly companiesRoot?: string;
+    /**
+     * Root folder for software profiles.
+     * @default "<profilesRoot>/software"
+     */
+    readonly softwareRoot?: string;
+    /**
+     * Root folder for industry profiles.
+     * @default "<profilesRoot>/industries"
+     */
+    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;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -981,6 +1105,32 @@ interface AgentConfigOptions {
      * file visibility control.
      */
     readonly cursorSettings?: CursorSettingsConfig;
+    /**
+     * Overrides for the output-path roots used by agent bundles
+     * (requirements, BCM, profiles, meetings, research). Unset fields
+     * fall back to the defaults captured in
+     * `bundles/paths.ts#DEFAULT_AGENT_PATHS`.
+     *
+     * This option is the first of the Group A framework injection
+     * points from epic #414. Per-project propagation of these values
+     * into bundle rule content lands in a follow-up — setting it today
+     * 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>;
 }
 
 /**
@@ -1168,6 +1318,56 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
  ******************************************************************************/
 declare const orchestratorBundle: AgentRuleBundle;
 
+/**
+ * Fully-resolved agent output-path roots. Every property is required.
+ *
+ * This is the shape that bundle code consumes at module-eval time via
+ * `DEFAULT_AGENT_PATHS`, and the shape that `resolveAgentPaths()`
+ * returns when consumers supply a partial `AgentPathsConfig` override.
+ */
+interface ResolvedAgentPaths {
+    readonly docsRoot: string;
+    readonly researchRoot: string;
+    readonly profilesRoot: string;
+    readonly meetingsRoot: string;
+    readonly requirementsRoot: string;
+    readonly researchRequirementsRoot: string;
+    readonly bcmRoot: string;
+    readonly peopleRoot: string;
+    readonly companiesRoot: string;
+    readonly softwareRoot: string;
+    readonly industriesRoot: string;
+}
+/**
+ * Canonical default values for every agent path. These mirror the
+ * hardcoded paths that bundles used before `AgentPathsConfig` existed,
+ * so `DEFAULT_AGENT_PATHS.*` can be substituted into bundle rule
+ * content at module-eval time without changing the generated
+ * `.claude/rules/*.md` snapshot.
+ *
+ * Consumers override the defaults by passing an `AgentPathsConfig`
+ * through `AgentConfigOptions.paths` and resolving it with
+ * `resolveAgentPaths()`. Per-project propagation into bundle rule
+ * content is a follow-up — this export is the first step: interface +
+ * resolver land in this PR; the `AgentConfig.resolveRules` wiring lands
+ * next.
+ */
+declare const DEFAULT_AGENT_PATHS: ResolvedAgentPaths;
+/**
+ * Resolve a partial `AgentPathsConfig` into a fully-populated
+ * `ResolvedAgentPaths`. Unset fields cascade from their parent root:
+ *
+ * - `profilesRoot`, `meetingsRoot`, `requirementsRoot`, and `bcmRoot`
+ *   derive from `docsRoot` when not explicitly set.
+ * - `researchRequirementsRoot` derives from `researchRoot` when not
+ *   explicitly set.
+ * - `peopleRoot`, `companiesRoot`, `softwareRoot`, and `industriesRoot`
+ *   derive from the resolved `profilesRoot` when not explicitly set,
+ *   so that overriding `docsRoot` alone (or overriding `profilesRoot`
+ *   alone) propagates correctly through every dependent root.
+ */
+declare function resolveAgentPaths(paths?: AgentPathsConfig): ResolvedAgentPaths;
+
 /**
  * People-profile bundle — enabled by default.
  *
@@ -1203,6 +1403,18 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * 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\"]`.
  *
@@ -3925,5 +4137,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_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, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
-export type { AgentConfigOptions, AgentModel, 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, 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, renderPriorityRulesSection, 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, PriorityRule, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };