@codedrifters/configulator 0.0.257 → 0.0.259

package/lib/index.d.mts

@@ -1278,6 +1278,144 @@ interface MeetingsConfig {
      */
     readonly agendaTemplateRoot?: string;
 }
+/*******************************************************************************
+ *
+ * Agent Features Config
+ *
+ ******************************************************************************/
+/**
+ * Per-tier lists of domain-specific source examples injected into the
+ * base bundle's "Source Quality & Verification" rule under each of the
+ * T1 / T2 / T3 / T4 headings.
+ *
+ * Every field is optional. When a field is set, the `base` bundle
+ * renders a bullet list of the supplied examples beneath the
+ * corresponding tier heading; when a field is unset, the tier heading
+ * renders with its generic examples only.
+ *
+ * The examples are emitted verbatim — supply fully-formed descriptive
+ * strings ("FHIR R4 capability statements", "SEC EDGAR filings").
+ *
+ * @see AgentFeaturesConfig
+ * @see ./bundles/features.ts#renderSourceTierExamples
+ */
+interface SourceTierExamples {
+    /**
+     * Primary living sources — T1. Examples that update when reality
+     * changes (official product docs, company about/leadership pages,
+     * live government registries).
+     */
+    readonly t1?: ReadonlyArray<string>;
+    /**
+     * Primary snapshot sources — T2. Examples that capture a moment in
+     * time from the authoritative party (press releases, earnings
+     * transcripts, regulatory filings, conference presentations).
+     */
+    readonly t2?: ReadonlyArray<string>;
+    /**
+     * Secondary sources — T3. Examples that interpret primary material
+     * (news articles, trade press, analyst reports, industry databases).
+     */
+    readonly t3?: ReadonlyArray<string>;
+    /**
+     * Self-reported or marketing sources — T4. Examples that require
+     * corroboration before any factual claim rides on them (vendor
+     * comparison pages, testimonials, social posts, job listings,
+     * Wikipedia).
+     */
+    readonly t4?: ReadonlyArray<string>;
+}
+/**
+ * A single consumer-supplied doc-section template injected into a
+ * bundle's rule content at rule-generation time.
+ *
+ * The configulator framework is deliberately generic here — it
+ * matches by `bundleName` and appends `body` verbatim under a new
+ * `## <sectionTitle>` heading after the first rule in the target
+ * bundle whose content contains `## <afterSection>`. Named feature
+ * toggles (stealth-mode, consortium-model, etc.) belong in downstream
+ * consumer repos that compose the primitive this interface exposes.
+ *
+ * Placeholder substitution (`{{foo}}`) is **not** performed at
+ * rule-generation time — the `body` string is emitted verbatim.
+ * Any templating is the agent's responsibility at document-authoring
+ * time, not configulator's.
+ *
+ * @see AgentFeaturesConfig
+ * @see ./bundles/features.ts#renderCustomDocSection
+ */
+interface CustomDocSection {
+    /**
+     * Target bundle id. Must match an `AgentRuleBundle.name` that is
+     * active in the project. If no active bundle has this name, the
+     * section is silently dropped.
+     * @example 'company-profile', 'meeting-analysis', 'bcm-writer'
+     */
+    readonly bundleName: string;
+    /**
+     * Heading text (without any leading `#` characters) of the existing
+     * section this custom section is inserted after. The framework
+     * searches every rule in the target bundle for a heading line at
+     * any level (`#` through `######`) whose text equals `afterSection`;
+     * the first rule that contains such a heading is the insertion site.
+     * Matching any level lets consumers hook into single-`#` bundle-rule
+     * titles (e.g. `# Company Profile Workflow`) as well as nested `##` /
+     * `###` subsections. If no rule contains a matching heading, the
+     * section is silently dropped.
+     *
+     * Multiple entries targeting the same heading render in supplied
+     * order — the first entry lands directly beneath the target heading
+     * block, the second below it, and so on.
+     * @example 'Company Profile Workflow', 'Company Type Taxonomy', 'Output Boundaries'
+     */
+    readonly afterSection: string;
+    /**
+     * Heading text for the injected section, rendered as
+     * `## <sectionTitle>`.
+     * @example 'Consortium Membership', 'Vortex Relevance'
+     */
+    readonly sectionTitle: string;
+    /**
+     * Markdown body emitted verbatim beneath the `## <sectionTitle>`
+     * heading. Trailing newlines are trimmed before rendering.
+     */
+    readonly body: string;
+}
+/**
+ * Framework injection points for source-tier customization and
+ * custom doc sections. Supplied via `AgentConfigOptions.features`.
+ *
+ * - `sourceTierExamples` — per-tier domain-specific examples that get
+ *   listed under each tier in the base bundle's "Source Quality &
+ *   Verification" rule.
+ * - `customDocSections` — per-bundle section templates that render
+ *   verbatim after an existing section heading in the target bundle's
+ *   rule content.
+ *
+ * Named feature toggles (`consortium-model`, `stealth-mode`, etc.)
+ * are deliberately **not** part of this config surface. They belong
+ * in downstream consumer repos built on top of the generic
+ * `customDocSections` primitive.
+ *
+ * @see SourceTierExamples
+ * @see CustomDocSection
+ * @see ./bundles/features.ts
+ */
+interface AgentFeaturesConfig {
+    /**
+     * Per-tier lists of domain-specific source examples injected under
+     * T1 / T2 / T3 / T4 in the base bundle's "Source Quality &
+     * Verification" rule.
+     */
+    readonly sourceTierExamples?: SourceTierExamples;
+    /**
+     * Custom doc-section templates to inject into active bundles at
+     * rule-generation time. Each entry names the target bundle, the
+     * section heading to insert after, the injected section's title,
+     * and the body to emit verbatim.
+     */
+    readonly customDocSections?: ReadonlyArray<CustomDocSection>;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -1430,6 +1568,27 @@ interface AgentConfigOptions {
      * @see ./bundles/meeting-types.ts#renderMeetingTypesSection
      */
     readonly meetings?: MeetingsConfig;
+    /**
+     * Framework injection points for source-tier customization and
+     * custom doc sections.
+     *
+     * - `sourceTierExamples` — domain-specific examples injected under
+     *   T1 / T2 / T3 / T4 in the base bundle's "Source Quality &
+     *   Verification" rule.
+     * - `customDocSections` — consumer-supplied section templates that
+     *   render verbatim after an existing section heading in a target
+     *   bundle's rule content.
+     *
+     * Named feature toggles (`consortium-model`, `stealth-mode`, etc.)
+     * are intentionally out of scope here — build those on top of
+     * `customDocSections` inside the consuming repo's projen config.
+     *
+     * @see AgentFeaturesConfig
+     * @see SourceTierExamples
+     * @see CustomDocSection
+     * @see ./bundles/features.ts
+     */
+    readonly features?: AgentFeaturesConfig;
 }
 
 /**
@@ -1459,6 +1618,14 @@ declare class AgentConfig extends Component {
      * Find the AgentConfig component on a project.
      */
     static of(project: Project$1): AgentConfig | undefined;
+    /**
+     * Returns `true` when at least one tier array on the supplied
+     * `SourceTierExamples` is non-empty, signalling that the consuming
+     * repo has opted into rendering the base bundle's
+     * `source-quality-verification` rule. Returns `false` for
+     * `undefined`, `{}`, or a fully-empty `{ t1: [], t2: [], t3: [], t4: [] }`.
+     */
+    private static hasActiveTierExamples;
     /**
      * Merges default Claude permissions with bundle and user-supplied settings.
      *
@@ -1483,8 +1650,11 @@ declare class AgentConfig extends Component {
     /**
      * Return a bundle's rules with `filePatterns` narrowed to the projects
      * that actually matched the bundle's detection predicate (when the bundle
-     * provides `findApplicableProjects`). Rules with `ALWAYS` scope and rules
-     * on bundles that don't implement the hook are returned unchanged.
+     * provides `findApplicableProjects`) and any project-specified
+     * `features.customDocSections` entries injected into the matching rule
+     * content. Rules with `ALWAYS` scope and rules on bundles that don't
+     * implement the hook are returned with only the custom-section
+     * transformation (if any) applied.
      */
     private bundleRulesFor;
     private resolveSkills;
@@ -1554,9 +1724,10 @@ declare const bcmWriterBundle: AgentRuleBundle;
  * `people-profile` (via `people:research`) and `software-profile` (via
  * `software:research`).
  *
- * Ships a sub-agent (`company-profile-analyst`), a user-invocable skill
- * (`/profile-company`), and `type:company-profile` plus `company:*`
- * phase labels.
+ * Ships a sub-agent (`company-profile-analyst`), four user-invocable
+ * skills (`/profile-company`, `/match-company`, `/refresh-company`,
+ * `/analyze-segment`), and `type:company-profile` plus `company:*`
+ * phase labels for the six phases.
  */
 declare const companyProfileBundle: AgentRuleBundle;
 
@@ -1702,6 +1873,51 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * Inject domain-specific source-tier examples into the content of the
+ * base bundle's "Source Quality & Verification" rule.
+ *
+ * For every tier whose examples array is non-empty, a
+ * `**Project-specific examples:**` line followed by a bullet list of
+ * the supplied strings is appended immediately beneath the tier's
+ * `### T<n> — ...` heading paragraph block. Tiers whose examples array
+ * is missing or empty are left untouched.
+ *
+ * Returns the original `content` verbatim when the supplied config is
+ * undefined or has no non-empty tier arrays, so callers can
+ * unconditionally pipe content through this function.
+ */
+declare function renderSourceTierExamples(content: string, examples: SourceTierExamples | undefined): string;
+/**
+ * Apply every {@link CustomDocSection} that targets `bundle.name` to
+ * the bundle's rules, returning a new bundle whose matched rules have
+ * the section bodies appended after the configured `afterSection`
+ * heading. Entries that reference a bundle name other than
+ * `bundle.name`, or whose `afterSection` cannot be located in any
+ * rule in the bundle, are silently dropped.
+ *
+ * Entries that target the same `afterSection` heading render in
+ * supplied order — the first supplied entry appears immediately
+ * beneath the target heading block, the second below that, and so on.
+ * This is achieved by advancing the insertion anchor to each
+ * just-injected section's `## <sectionTitle>` heading; the next
+ * same-target entry then lands at the end of that newly-opened
+ * section, which places it immediately after the previous entry
+ * regardless of the original heading's level.
+ *
+ * Returns `bundle` unchanged when `sections` is empty or no entries
+ * match, so callers can unconditionally pipe bundles through this
+ * function without penalty.
+ */
+declare function renderCustomDocSections(bundle: AgentRuleBundle, sections: ReadonlyArray<CustomDocSection>): AgentRuleBundle;
+/**
+ * Render a {@link CustomDocSection} into the markdown block that
+ * `renderCustomDocSections` splices after the target heading block.
+ * Exposed for tests that exercise the renderer directly without
+ * touching a full bundle.
+ */
+declare function renderCustomDocSectionBlock(section: CustomDocSection): string;
+
 /**
  * Render the markdown subsection appended to the
  * `issue-label-conventions` rule when `AgentConfigOptions.focus` is
@@ -4477,4 +4693,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 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 MeetingArea, type MeetingScope, type MeetingType, type MeetingsConfig, 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, renderMeetingTypesSection, renderPriorityRulesSection, 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 AgentFeaturesConfig, 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, type CustomDocSection, 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 MeetingArea, type MeetingScope, type MeetingType, type MeetingsConfig, 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 SourceTierExamples, 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, renderCustomDocSectionBlock, renderCustomDocSections, renderFocusSection, renderMeetingTypesSection, renderPriorityRulesSection, renderSourceTierExamples, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };

package/lib/index.d.ts

@@ -1327,6 +1327,144 @@ interface MeetingsConfig {
      */
     readonly agendaTemplateRoot?: string;
 }
+/*******************************************************************************
+ *
+ * Agent Features Config
+ *
+ ******************************************************************************/
+/**
+ * Per-tier lists of domain-specific source examples injected into the
+ * base bundle's "Source Quality & Verification" rule under each of the
+ * T1 / T2 / T3 / T4 headings.
+ *
+ * Every field is optional. When a field is set, the `base` bundle
+ * renders a bullet list of the supplied examples beneath the
+ * corresponding tier heading; when a field is unset, the tier heading
+ * renders with its generic examples only.
+ *
+ * The examples are emitted verbatim — supply fully-formed descriptive
+ * strings ("FHIR R4 capability statements", "SEC EDGAR filings").
+ *
+ * @see AgentFeaturesConfig
+ * @see ./bundles/features.ts#renderSourceTierExamples
+ */
+interface SourceTierExamples {
+    /**
+     * Primary living sources — T1. Examples that update when reality
+     * changes (official product docs, company about/leadership pages,
+     * live government registries).
+     */
+    readonly t1?: ReadonlyArray<string>;
+    /**
+     * Primary snapshot sources — T2. Examples that capture a moment in
+     * time from the authoritative party (press releases, earnings
+     * transcripts, regulatory filings, conference presentations).
+     */
+    readonly t2?: ReadonlyArray<string>;
+    /**
+     * Secondary sources — T3. Examples that interpret primary material
+     * (news articles, trade press, analyst reports, industry databases).
+     */
+    readonly t3?: ReadonlyArray<string>;
+    /**
+     * Self-reported or marketing sources — T4. Examples that require
+     * corroboration before any factual claim rides on them (vendor
+     * comparison pages, testimonials, social posts, job listings,
+     * Wikipedia).
+     */
+    readonly t4?: ReadonlyArray<string>;
+}
+/**
+ * A single consumer-supplied doc-section template injected into a
+ * bundle's rule content at rule-generation time.
+ *
+ * The configulator framework is deliberately generic here — it
+ * matches by `bundleName` and appends `body` verbatim under a new
+ * `## <sectionTitle>` heading after the first rule in the target
+ * bundle whose content contains `## <afterSection>`. Named feature
+ * toggles (stealth-mode, consortium-model, etc.) belong in downstream
+ * consumer repos that compose the primitive this interface exposes.
+ *
+ * Placeholder substitution (`{{foo}}`) is **not** performed at
+ * rule-generation time — the `body` string is emitted verbatim.
+ * Any templating is the agent's responsibility at document-authoring
+ * time, not configulator's.
+ *
+ * @see AgentFeaturesConfig
+ * @see ./bundles/features.ts#renderCustomDocSection
+ */
+interface CustomDocSection {
+    /**
+     * Target bundle id. Must match an `AgentRuleBundle.name` that is
+     * active in the project. If no active bundle has this name, the
+     * section is silently dropped.
+     * @example 'company-profile', 'meeting-analysis', 'bcm-writer'
+     */
+    readonly bundleName: string;
+    /**
+     * Heading text (without any leading `#` characters) of the existing
+     * section this custom section is inserted after. The framework
+     * searches every rule in the target bundle for a heading line at
+     * any level (`#` through `######`) whose text equals `afterSection`;
+     * the first rule that contains such a heading is the insertion site.
+     * Matching any level lets consumers hook into single-`#` bundle-rule
+     * titles (e.g. `# Company Profile Workflow`) as well as nested `##` /
+     * `###` subsections. If no rule contains a matching heading, the
+     * section is silently dropped.
+     *
+     * Multiple entries targeting the same heading render in supplied
+     * order — the first entry lands directly beneath the target heading
+     * block, the second below it, and so on.
+     * @example 'Company Profile Workflow', 'Company Type Taxonomy', 'Output Boundaries'
+     */
+    readonly afterSection: string;
+    /**
+     * Heading text for the injected section, rendered as
+     * `## <sectionTitle>`.
+     * @example 'Consortium Membership', 'Vortex Relevance'
+     */
+    readonly sectionTitle: string;
+    /**
+     * Markdown body emitted verbatim beneath the `## <sectionTitle>`
+     * heading. Trailing newlines are trimmed before rendering.
+     */
+    readonly body: string;
+}
+/**
+ * Framework injection points for source-tier customization and
+ * custom doc sections. Supplied via `AgentConfigOptions.features`.
+ *
+ * - `sourceTierExamples` — per-tier domain-specific examples that get
+ *   listed under each tier in the base bundle's "Source Quality &
+ *   Verification" rule.
+ * - `customDocSections` — per-bundle section templates that render
+ *   verbatim after an existing section heading in the target bundle's
+ *   rule content.
+ *
+ * Named feature toggles (`consortium-model`, `stealth-mode`, etc.)
+ * are deliberately **not** part of this config surface. They belong
+ * in downstream consumer repos built on top of the generic
+ * `customDocSections` primitive.
+ *
+ * @see SourceTierExamples
+ * @see CustomDocSection
+ * @see ./bundles/features.ts
+ */
+interface AgentFeaturesConfig {
+    /**
+     * Per-tier lists of domain-specific source examples injected under
+     * T1 / T2 / T3 / T4 in the base bundle's "Source Quality &
+     * Verification" rule.
+     */
+    readonly sourceTierExamples?: SourceTierExamples;
+    /**
+     * Custom doc-section templates to inject into active bundles at
+     * rule-generation time. Each entry names the target bundle, the
+     * section heading to insert after, the injected section's title,
+     * and the body to emit verbatim.
+     */
+    readonly customDocSections?: ReadonlyArray<CustomDocSection>;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -1479,6 +1617,27 @@ interface AgentConfigOptions {
      * @see ./bundles/meeting-types.ts#renderMeetingTypesSection
      */
     readonly meetings?: MeetingsConfig;
+    /**
+     * Framework injection points for source-tier customization and
+     * custom doc sections.
+     *
+     * - `sourceTierExamples` — domain-specific examples injected under
+     *   T1 / T2 / T3 / T4 in the base bundle's "Source Quality &
+     *   Verification" rule.
+     * - `customDocSections` — consumer-supplied section templates that
+     *   render verbatim after an existing section heading in a target
+     *   bundle's rule content.
+     *
+     * Named feature toggles (`consortium-model`, `stealth-mode`, etc.)
+     * are intentionally out of scope here — build those on top of
+     * `customDocSections` inside the consuming repo's projen config.
+     *
+     * @see AgentFeaturesConfig
+     * @see SourceTierExamples
+     * @see CustomDocSection
+     * @see ./bundles/features.ts
+     */
+    readonly features?: AgentFeaturesConfig;
 }
 
 /**
@@ -1508,6 +1667,14 @@ declare class AgentConfig extends Component {
      * Find the AgentConfig component on a project.
      */
     static of(project: Project): AgentConfig | undefined;
+    /**
+     * Returns `true` when at least one tier array on the supplied
+     * `SourceTierExamples` is non-empty, signalling that the consuming
+     * repo has opted into rendering the base bundle's
+     * `source-quality-verification` rule. Returns `false` for
+     * `undefined`, `{}`, or a fully-empty `{ t1: [], t2: [], t3: [], t4: [] }`.
+     */
+    private static hasActiveTierExamples;
     /**
      * Merges default Claude permissions with bundle and user-supplied settings.
      *
@@ -1532,8 +1699,11 @@ declare class AgentConfig extends Component {
     /**
      * Return a bundle's rules with `filePatterns` narrowed to the projects
      * that actually matched the bundle's detection predicate (when the bundle
-     * provides `findApplicableProjects`). Rules with `ALWAYS` scope and rules
-     * on bundles that don't implement the hook are returned unchanged.
+     * provides `findApplicableProjects`) and any project-specified
+     * `features.customDocSections` entries injected into the matching rule
+     * content. Rules with `ALWAYS` scope and rules on bundles that don't
+     * implement the hook are returned with only the custom-section
+     * transformation (if any) applied.
      */
     private bundleRulesFor;
     private resolveSkills;
@@ -1603,9 +1773,10 @@ declare const bcmWriterBundle: AgentRuleBundle;
  * `people-profile` (via `people:research`) and `software-profile` (via
  * `software:research`).
  *
- * Ships a sub-agent (`company-profile-analyst`), a user-invocable skill
- * (`/profile-company`), and `type:company-profile` plus `company:*`
- * phase labels.
+ * Ships a sub-agent (`company-profile-analyst`), four user-invocable
+ * skills (`/profile-company`, `/match-company`, `/refresh-company`,
+ * `/analyze-segment`), and `type:company-profile` plus `company:*`
+ * phase labels for the six phases.
  */
 declare const companyProfileBundle: AgentRuleBundle;
 
@@ -1751,6 +1922,51 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * Inject domain-specific source-tier examples into the content of the
+ * base bundle's "Source Quality & Verification" rule.
+ *
+ * For every tier whose examples array is non-empty, a
+ * `**Project-specific examples:**` line followed by a bullet list of
+ * the supplied strings is appended immediately beneath the tier's
+ * `### T<n> — ...` heading paragraph block. Tiers whose examples array
+ * is missing or empty are left untouched.
+ *
+ * Returns the original `content` verbatim when the supplied config is
+ * undefined or has no non-empty tier arrays, so callers can
+ * unconditionally pipe content through this function.
+ */
+declare function renderSourceTierExamples(content: string, examples: SourceTierExamples | undefined): string;
+/**
+ * Apply every {@link CustomDocSection} that targets `bundle.name` to
+ * the bundle's rules, returning a new bundle whose matched rules have
+ * the section bodies appended after the configured `afterSection`
+ * heading. Entries that reference a bundle name other than
+ * `bundle.name`, or whose `afterSection` cannot be located in any
+ * rule in the bundle, are silently dropped.
+ *
+ * Entries that target the same `afterSection` heading render in
+ * supplied order — the first supplied entry appears immediately
+ * beneath the target heading block, the second below that, and so on.
+ * This is achieved by advancing the insertion anchor to each
+ * just-injected section's `## <sectionTitle>` heading; the next
+ * same-target entry then lands at the end of that newly-opened
+ * section, which places it immediately after the previous entry
+ * regardless of the original heading's level.
+ *
+ * Returns `bundle` unchanged when `sections` is empty or no entries
+ * match, so callers can unconditionally pipe bundles through this
+ * function without penalty.
+ */
+declare function renderCustomDocSections(bundle: AgentRuleBundle, sections: ReadonlyArray<CustomDocSection>): AgentRuleBundle;
+/**
+ * Render a {@link CustomDocSection} into the markdown block that
+ * `renderCustomDocSections` splices after the target heading block.
+ * Exposed for tests that exercise the renderer directly without
+ * touching a full bundle.
+ */
+declare function renderCustomDocSectionBlock(section: CustomDocSection): string;
+
 /**
  * Render the markdown subsection appended to the
  * `issue-label-conventions` rule when `AgentConfigOptions.focus` is
@@ -4526,5 +4742,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, renderFocusSection, renderMeetingTypesSection, 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, MeetingArea, MeetingScope, MeetingType, MeetingsConfig, 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 };
+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, renderCustomDocSectionBlock, renderCustomDocSections, renderFocusSection, renderMeetingTypesSection, renderPriorityRulesSection, renderSourceTierExamples, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
+export type { AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, 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, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, LayoutEnforcement, LayoutViolation, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedProjectMetadata, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };