@codedrifters/configulator 0.0.276 → 0.0.278

package/lib/index.d.mts

@@ -6940,6 +6940,196 @@ declare function emptyCategoryBuckets(): {
     }>;
 };
 
+/**
+ * One public export parsed out of an `.api.md` rollup. The signature
+ * is the verbatim declaration text from the rollup (TypeScript
+ * declaration form), with internal whitespace normalized to single
+ * spaces so cosmetic re-formatting between runs does not surface as
+ * a `changed` finding.
+ */
+interface ApiSurfaceEntry {
+    /**
+     * Public name of the export (function name, class name, etc.).
+     */
+    readonly name: string;
+    /**
+     * Verbatim declaration line from the rollup with whitespace
+     * collapsed. Used as the equality comparison for `added` /
+     * `removed` / `changed` classification.
+     */
+    readonly signature: string;
+}
+/**
+ * Result of diffing a baseline rollup against a current rollup. Each
+ * field carries the API entries that fall into that change bucket.
+ * Used by {@link createApiDiffCheck} to emit one finding per entry,
+ * but exported separately so callers that want to render or
+ * post-process the diff outside the audit-report shape can.
+ */
+interface ApiDiffResult {
+    /** Exports present in the current rollup but not the baseline. */
+    readonly added: ReadonlyArray<ApiSurfaceEntry>;
+    /** Exports present in the baseline but not the current rollup. */
+    readonly removed: ReadonlyArray<ApiSurfaceEntry>;
+    /**
+     * Exports present in both rollups but whose declaration text
+     * differs (signature change, type-parameter change, etc.). The
+     * carried entry is the **current** rollup's view of the symbol so
+     * downstream consumers can show the new signature.
+     */
+    readonly changed: ReadonlyArray<ApiSurfaceEntry>;
+}
+/**
+ * Options accepted by {@link createApiDiffCheck}. The runner
+ * consumes already-fetched rollup contents — the orchestrator is
+ * responsible for running the `extract-api.sh` helper against the
+ * current ref and against the configured baseline ref before
+ * dispatching to the runner. Passing the rollups in as strings keeps
+ * tests cheap (inline fixtures) and lets the same runner shape
+ * cover the audit-mode case where the baseline is an empty rollup
+ * (every export shows up as `added`).
+ */
+interface ApiDiffCheckOptions {
+    /**
+     * Verbatim contents of the `.api.md` rollup the orchestrator
+     * extracted against the **baseline** ref (typically `origin/main`
+     * for `pr` mode or empty for `audit` mode). May be the empty
+     * string when no baseline is available — every current export
+     * then surfaces as `added`.
+     */
+    readonly baselineRollup: string;
+    /**
+     * Verbatim contents of the `.api.md` rollup the orchestrator
+     * extracted against the **current** ref (the working tree the
+     * scan is running over).
+     */
+    readonly currentRollup: string;
+    /**
+     * Path attached to every finding's `location.file`. Conventionally
+     * the path to the `.api.md` file relative to the repo root (e.g.
+     * `packages/@codedrifters/configulator/.api-extractor/configulator.api.md`)
+     * so consumers can jump from a finding back to the source rollup.
+     * Defaults to the empty string, meaning the finding has no
+     * concrete file anchor.
+     *
+     * @default ""
+     */
+    readonly rollupPath?: string;
+    /**
+     * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
+     * to `"apiDiff"` so logs match the audit-report category key.
+     *
+     * @default "apiDiff"
+     */
+    readonly name?: string;
+}
+/**
+ * Parse a `.api.md` rollup into the set of public-API entries it
+ * declares. The parser is intentionally line-oriented and tolerant
+ * of api-extractor's exact formatting:
+ *
+ * 1. Find the first fenced `ts` code block (api-extractor wraps the
+ *    rollup in one). Lines outside the block are ignored.
+ * 2. Walk the block linewise. Every line that begins with `export`
+ *    is the start of a declaration; subsequent lines that do not
+ *    begin with `export`, `//`, `}`, or `import` are appended until
+ *    a terminator (`;`, top-level `}`) closes the declaration.
+ * 3. Extract the public name from the start of the declaration —
+ *    the first identifier after `export {function|class|interface|...}`
+ *    (or the first name in an `export { A, B }` clause).
+ * 4. Normalize whitespace inside the captured signature to a single
+ *    space so re-flowing the rollup does not produce spurious
+ *    `changed` findings.
+ *
+ * Lines containing only `// @public`, `// @beta`, etc. are stripped
+ * — they are release-tag annotations the extractor emits, and they
+ * change independently of the signature itself.
+ */
+declare function parseApiRollup(rollup: string): ReadonlyArray<ApiSurfaceEntry>;
+/**
+ * Diff a baseline rollup against a current rollup and bucket every
+ * public export into `added`, `removed`, or `changed`. Exported so
+ * callers can compute the diff without going through the runner
+ * shape.
+ */
+declare function diffApiRollups(baselineRollup: string, currentRollup: string): ApiDiffResult;
+/**
+ * Build an {@link AuditCheckRunner} that emits API-diff findings by
+ * comparing a baseline rollup to a current rollup. Severity mapping
+ * (per the parent epic's drift-handling matrix):
+ *
+ * - **added** — `mechanical`. A new public export is purely
+ *   additive; Phase 2 can stub TSDoc and add reference-doc rows
+ *   without human input.
+ * - **removed** — `advisory`. A removed public export likely needs
+ *   a deprecation note in prose; Phase 2 cannot mechanically rewrite
+ *   conceptual prose.
+ * - **changed** — `advisory`. A signature change may invalidate
+ *   inline-code references in docs and warrants human review of any
+ *   surrounding prose.
+ */
+declare function createApiDiffCheck(options: ApiDiffCheckOptions): AuditCheckRunner;
+
+/**
+ * Options accepted by {@link createReferenceMismatchCheck}.
+ *
+ * The runner consumes already-computed reference records produced by
+ * `extractDocReferences()`. The factory deliberately does not invoke
+ * the extractor — that keeps the runner cheap to test with inline
+ * fixtures and lets the orchestrator extract references once and
+ * feed multiple checks from the same input.
+ */
+interface ReferenceMismatchCheckOptions {
+    /**
+     * The reference records to translate into findings. Each record
+     * carries the `isKnown` flag the extractor computed against the
+     * supplied known-symbols set; the runner produces a finding for
+     * every record where `isKnown` is `false`.
+     */
+    readonly records: ReadonlyArray<DocReferenceRecord>;
+    /**
+     * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
+     * to `"referenceMismatches"` so logs match the audit-report
+     * category key.
+     *
+     * @default "referenceMismatches"
+     */
+    readonly name?: string;
+    /**
+     * Optional set of symbols whose signature changed between the
+     * baseline and the current revision. References to one of these
+     * symbols produce a `signature-changed` finding rather than the
+     * default `unknown-symbol` finding (the symbol resolves but its
+     * type signature differs from the cached snapshot, per the
+     * audit-report schema). Empty / omitted means no signature-change
+     * findings are produced.
+     */
+    readonly signatureChangedSymbols?: ReadonlyArray<string>;
+}
+/**
+ * Map a single {@link DocReferenceRecord} to zero or one audit
+ * findings. Exported so callers can reuse the record-to-finding
+ * mapping without going through a runner.
+ *
+ * Severity mapping:
+ *
+ * - `unknown-symbol` (record carries `isKnown: false`) — `advisory`.
+ *   The doc mentions a symbol that does not appear in the supplied
+ *   known-symbols set; a human reviewer should rename the mention or
+ *   remove it. The matching `signature-changed` case only fires when
+ *   the caller passes the symbol via `signatureChangedSymbols`.
+ * - Records with `isKnown: true` and no signature change produce no
+ *   findings.
+ */
+declare function referenceRecordToFinding(record: DocReferenceRecord, signatureChangedSymbols: ReadonlySet<string>): ReferenceMismatchFinding | undefined;
+/**
+ * Build an {@link AuditCheckRunner} that emits doc-reference
+ * mismatch findings from a precomputed list of
+ * {@link DocReferenceRecord}. The runner is synchronous and
+ * idempotent — calling `run()` twice produces identical findings.
+ */
+declare function createReferenceMismatchCheck(options: ReferenceMismatchCheckOptions): AuditCheckRunner;
+
 /**
  * One row in the TSDoc-coverage report — describes a single public
  * symbol exported (transitively) from the package's entry point and
@@ -7059,6 +7249,59 @@ interface AnalyzeTsDocCoverageOptions {
  */
 declare function analyzeTsDocCoverage(options: AnalyzeTsDocCoverageOptions | string): Array<TsDocCoverageRecord>;
 
+/**
+ * Options accepted by {@link createTsdocCoverageCheck}.
+ *
+ * The runner consumes already-computed coverage records produced by
+ * `analyzeTsDocCoverage()`. The factory deliberately does not invoke
+ * the analyzer itself — that keeps the runner cheap to test (pass an
+ * inline records array) and keeps the orchestrator free to compute
+ * coverage once and feed multiple checks from the same input.
+ */
+interface TsdocCoverageCheckOptions {
+    /**
+     * The coverage records to translate into findings. Typically the
+     * concatenated output of `analyzeTsDocCoverage()` for every public
+     * package the orchestrator is scanning. The factory may be called
+     * with an empty array when no public exports were inspected — the
+     * resulting runner produces no findings.
+     */
+    readonly records: ReadonlyArray<TsDocCoverageRecord>;
+    /**
+     * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
+     * to `"tsdocCoverage"` so logs match the audit-report category key.
+     *
+     * @default "tsdocCoverage"
+     */
+    readonly name?: string;
+}
+/**
+ * Map a single {@link TsDocCoverageRecord} to zero, one, or more
+ * audit findings. Exported so callers can reuse the
+ * record-to-finding mapping without going through a runner (e.g. the
+ * audit-mode walker in #526 may compose findings differently).
+ *
+ * Severity mapping (per the parent epic's drift-handling matrix):
+ *
+ * - `missing-summary` — `mechanical` (Phase 2 can auto-stub).
+ * - `thin-summary` — `advisory` (a human should rewrite).
+ * - `missing-params` / `missing-returns` — `advisory` (the symbol
+ *   does carry a summary; the missing block tag is signal but does
+ *   not block).
+ *
+ * A record with `hasSummary && !hasThinSummary` and no missing block
+ * tags produces no findings — fully-documented exports are reported
+ * by their absence in the result.
+ */
+declare function tsdocRecordToFindings(record: TsDocCoverageRecord, context: AuditCheckRunnerContext): Array<TsdocCoverageFinding>;
+/**
+ * Build an {@link AuditCheckRunner} that emits TSDoc-coverage
+ * findings from a precomputed list of {@link TsDocCoverageRecord}.
+ * The runner is synchronous and idempotent; calling `run()` twice
+ * produces identical findings.
+ */
+declare function createTsdocCoverageCheck(options: TsdocCoverageCheckOptions): AuditCheckRunner;
+
 /**
  * Returns the latest full-release version of an npm package that has been
  * published for at least `minimumReleaseAgeMinutes` minutes. Prefers the
@@ -8958,4 +9201,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, 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 AgentTier, type AgentTierConfig, type AgentTierEntry, type AnalyzeTsDocCoverageOptions, type ApiDiffFinding, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, AuditCategory, type AuditCheckRunner, type AuditCheckRunnerContext, type AuditFinding, type AuditFindingBase, type AuditLocation, AuditMode, type AuditReport, AuditSeverity, 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 CompileFencedSamplesOptions, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, type LinkFailureFinding, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PreflightMergeMethod, type PreflightPrConfig, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type ReferenceMismatchFinding, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueTemplates, type ResolvedPreflightPr, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedUnblockDependents, type RunRatioConfig, type RunScanOptions, type RunScanResult, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, type SampleCompilationFailure, type SampleFailureFinding, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, type TsdocCoverageFinding, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, 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 AgentTier, type AgentTierConfig, type AgentTierEntry, type AnalyzeTsDocCoverageOptions, type ApiDiffCheckOptions, type ApiDiffFinding, type ApiDiffResult, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApiSurfaceEntry, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, AuditCategory, type AuditCheckRunner, type AuditCheckRunnerContext, type AuditFinding, type AuditFindingBase, type AuditLocation, AuditMode, type AuditReport, AuditSeverity, 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 CompileFencedSamplesOptions, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, type LinkFailureFinding, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PreflightMergeMethod, type PreflightPrConfig, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type ReferenceMismatchCheckOptions, type ReferenceMismatchFinding, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueTemplates, type ResolvedPreflightPr, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedUnblockDependents, type RunRatioConfig, type RunScanOptions, type RunScanResult, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, type SampleCompilationFailure, type SampleFailureFinding, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, type TsdocCoverageCheckOptions, type TsdocCoverageFinding, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, createApiDiffCheck, createReferenceMismatchCheck, createTsdocCoverageCheck, customerProfileBundle, diffApiRollups, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, parseApiRollup, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, referenceRecordToFinding, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, tsdocRecordToFindings, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, vitestBundle };

package/lib/index.d.ts

@@ -6989,6 +6989,196 @@ declare function emptyCategoryBuckets(): {
     }>;
 };
 
+/**
+ * One public export parsed out of an `.api.md` rollup. The signature
+ * is the verbatim declaration text from the rollup (TypeScript
+ * declaration form), with internal whitespace normalized to single
+ * spaces so cosmetic re-formatting between runs does not surface as
+ * a `changed` finding.
+ */
+interface ApiSurfaceEntry {
+    /**
+     * Public name of the export (function name, class name, etc.).
+     */
+    readonly name: string;
+    /**
+     * Verbatim declaration line from the rollup with whitespace
+     * collapsed. Used as the equality comparison for `added` /
+     * `removed` / `changed` classification.
+     */
+    readonly signature: string;
+}
+/**
+ * Result of diffing a baseline rollup against a current rollup. Each
+ * field carries the API entries that fall into that change bucket.
+ * Used by {@link createApiDiffCheck} to emit one finding per entry,
+ * but exported separately so callers that want to render or
+ * post-process the diff outside the audit-report shape can.
+ */
+interface ApiDiffResult {
+    /** Exports present in the current rollup but not the baseline. */
+    readonly added: ReadonlyArray<ApiSurfaceEntry>;
+    /** Exports present in the baseline but not the current rollup. */
+    readonly removed: ReadonlyArray<ApiSurfaceEntry>;
+    /**
+     * Exports present in both rollups but whose declaration text
+     * differs (signature change, type-parameter change, etc.). The
+     * carried entry is the **current** rollup's view of the symbol so
+     * downstream consumers can show the new signature.
+     */
+    readonly changed: ReadonlyArray<ApiSurfaceEntry>;
+}
+/**
+ * Options accepted by {@link createApiDiffCheck}. The runner
+ * consumes already-fetched rollup contents — the orchestrator is
+ * responsible for running the `extract-api.sh` helper against the
+ * current ref and against the configured baseline ref before
+ * dispatching to the runner. Passing the rollups in as strings keeps
+ * tests cheap (inline fixtures) and lets the same runner shape
+ * cover the audit-mode case where the baseline is an empty rollup
+ * (every export shows up as `added`).
+ */
+interface ApiDiffCheckOptions {
+    /**
+     * Verbatim contents of the `.api.md` rollup the orchestrator
+     * extracted against the **baseline** ref (typically `origin/main`
+     * for `pr` mode or empty for `audit` mode). May be the empty
+     * string when no baseline is available — every current export
+     * then surfaces as `added`.
+     */
+    readonly baselineRollup: string;
+    /**
+     * Verbatim contents of the `.api.md` rollup the orchestrator
+     * extracted against the **current** ref (the working tree the
+     * scan is running over).
+     */
+    readonly currentRollup: string;
+    /**
+     * Path attached to every finding's `location.file`. Conventionally
+     * the path to the `.api.md` file relative to the repo root (e.g.
+     * `packages/@codedrifters/configulator/.api-extractor/configulator.api.md`)
+     * so consumers can jump from a finding back to the source rollup.
+     * Defaults to the empty string, meaning the finding has no
+     * concrete file anchor.
+     *
+     * @default ""
+     */
+    readonly rollupPath?: string;
+    /**
+     * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
+     * to `"apiDiff"` so logs match the audit-report category key.
+     *
+     * @default "apiDiff"
+     */
+    readonly name?: string;
+}
+/**
+ * Parse a `.api.md` rollup into the set of public-API entries it
+ * declares. The parser is intentionally line-oriented and tolerant
+ * of api-extractor's exact formatting:
+ *
+ * 1. Find the first fenced `ts` code block (api-extractor wraps the
+ *    rollup in one). Lines outside the block are ignored.
+ * 2. Walk the block linewise. Every line that begins with `export`
+ *    is the start of a declaration; subsequent lines that do not
+ *    begin with `export`, `//`, `}`, or `import` are appended until
+ *    a terminator (`;`, top-level `}`) closes the declaration.
+ * 3. Extract the public name from the start of the declaration —
+ *    the first identifier after `export {function|class|interface|...}`
+ *    (or the first name in an `export { A, B }` clause).
+ * 4. Normalize whitespace inside the captured signature to a single
+ *    space so re-flowing the rollup does not produce spurious
+ *    `changed` findings.
+ *
+ * Lines containing only `// @public`, `// @beta`, etc. are stripped
+ * — they are release-tag annotations the extractor emits, and they
+ * change independently of the signature itself.
+ */
+declare function parseApiRollup(rollup: string): ReadonlyArray<ApiSurfaceEntry>;
+/**
+ * Diff a baseline rollup against a current rollup and bucket every
+ * public export into `added`, `removed`, or `changed`. Exported so
+ * callers can compute the diff without going through the runner
+ * shape.
+ */
+declare function diffApiRollups(baselineRollup: string, currentRollup: string): ApiDiffResult;
+/**
+ * Build an {@link AuditCheckRunner} that emits API-diff findings by
+ * comparing a baseline rollup to a current rollup. Severity mapping
+ * (per the parent epic's drift-handling matrix):
+ *
+ * - **added** — `mechanical`. A new public export is purely
+ *   additive; Phase 2 can stub TSDoc and add reference-doc rows
+ *   without human input.
+ * - **removed** — `advisory`. A removed public export likely needs
+ *   a deprecation note in prose; Phase 2 cannot mechanically rewrite
+ *   conceptual prose.
+ * - **changed** — `advisory`. A signature change may invalidate
+ *   inline-code references in docs and warrants human review of any
+ *   surrounding prose.
+ */
+declare function createApiDiffCheck(options: ApiDiffCheckOptions): AuditCheckRunner;
+
+/**
+ * Options accepted by {@link createReferenceMismatchCheck}.
+ *
+ * The runner consumes already-computed reference records produced by
+ * `extractDocReferences()`. The factory deliberately does not invoke
+ * the extractor — that keeps the runner cheap to test with inline
+ * fixtures and lets the orchestrator extract references once and
+ * feed multiple checks from the same input.
+ */
+interface ReferenceMismatchCheckOptions {
+    /**
+     * The reference records to translate into findings. Each record
+     * carries the `isKnown` flag the extractor computed against the
+     * supplied known-symbols set; the runner produces a finding for
+     * every record where `isKnown` is `false`.
+     */
+    readonly records: ReadonlyArray<DocReferenceRecord>;
+    /**
+     * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
+     * to `"referenceMismatches"` so logs match the audit-report
+     * category key.
+     *
+     * @default "referenceMismatches"
+     */
+    readonly name?: string;
+    /**
+     * Optional set of symbols whose signature changed between the
+     * baseline and the current revision. References to one of these
+     * symbols produce a `signature-changed` finding rather than the
+     * default `unknown-symbol` finding (the symbol resolves but its
+     * type signature differs from the cached snapshot, per the
+     * audit-report schema). Empty / omitted means no signature-change
+     * findings are produced.
+     */
+    readonly signatureChangedSymbols?: ReadonlyArray<string>;
+}
+/**
+ * Map a single {@link DocReferenceRecord} to zero or one audit
+ * findings. Exported so callers can reuse the record-to-finding
+ * mapping without going through a runner.
+ *
+ * Severity mapping:
+ *
+ * - `unknown-symbol` (record carries `isKnown: false`) — `advisory`.
+ *   The doc mentions a symbol that does not appear in the supplied
+ *   known-symbols set; a human reviewer should rename the mention or
+ *   remove it. The matching `signature-changed` case only fires when
+ *   the caller passes the symbol via `signatureChangedSymbols`.
+ * - Records with `isKnown: true` and no signature change produce no
+ *   findings.
+ */
+declare function referenceRecordToFinding(record: DocReferenceRecord, signatureChangedSymbols: ReadonlySet<string>): ReferenceMismatchFinding | undefined;
+/**
+ * Build an {@link AuditCheckRunner} that emits doc-reference
+ * mismatch findings from a precomputed list of
+ * {@link DocReferenceRecord}. The runner is synchronous and
+ * idempotent — calling `run()` twice produces identical findings.
+ */
+declare function createReferenceMismatchCheck(options: ReferenceMismatchCheckOptions): AuditCheckRunner;
+
 /**
  * One row in the TSDoc-coverage report — describes a single public
  * symbol exported (transitively) from the package's entry point and
@@ -7108,6 +7298,59 @@ interface AnalyzeTsDocCoverageOptions {
  */
 declare function analyzeTsDocCoverage(options: AnalyzeTsDocCoverageOptions | string): Array<TsDocCoverageRecord>;
 
+/**
+ * Options accepted by {@link createTsdocCoverageCheck}.
+ *
+ * The runner consumes already-computed coverage records produced by
+ * `analyzeTsDocCoverage()`. The factory deliberately does not invoke
+ * the analyzer itself — that keeps the runner cheap to test (pass an
+ * inline records array) and keeps the orchestrator free to compute
+ * coverage once and feed multiple checks from the same input.
+ */
+interface TsdocCoverageCheckOptions {
+    /**
+     * The coverage records to translate into findings. Typically the
+     * concatenated output of `analyzeTsDocCoverage()` for every public
+     * package the orchestrator is scanning. The factory may be called
+     * with an empty array when no public exports were inspected — the
+     * resulting runner produces no findings.
+     */
+    readonly records: ReadonlyArray<TsDocCoverageRecord>;
+    /**
+     * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
+     * to `"tsdocCoverage"` so logs match the audit-report category key.
+     *
+     * @default "tsdocCoverage"
+     */
+    readonly name?: string;
+}
+/**
+ * Map a single {@link TsDocCoverageRecord} to zero, one, or more
+ * audit findings. Exported so callers can reuse the
+ * record-to-finding mapping without going through a runner (e.g. the
+ * audit-mode walker in #526 may compose findings differently).
+ *
+ * Severity mapping (per the parent epic's drift-handling matrix):
+ *
+ * - `missing-summary` — `mechanical` (Phase 2 can auto-stub).
+ * - `thin-summary` — `advisory` (a human should rewrite).
+ * - `missing-params` / `missing-returns` — `advisory` (the symbol
+ *   does carry a summary; the missing block tag is signal but does
+ *   not block).
+ *
+ * A record with `hasSummary && !hasThinSummary` and no missing block
+ * tags produces no findings — fully-documented exports are reported
+ * by their absence in the result.
+ */
+declare function tsdocRecordToFindings(record: TsDocCoverageRecord, context: AuditCheckRunnerContext): Array<TsdocCoverageFinding>;
+/**
+ * Build an {@link AuditCheckRunner} that emits TSDoc-coverage
+ * findings from a precomputed list of {@link TsDocCoverageRecord}.
+ * The runner is synchronous and idempotent; calling `run()` twice
+ * produces identical findings.
+ */
+declare function createTsdocCoverageCheck(options: TsdocCoverageCheckOptions): AuditCheckRunner;
+
 /**
  * Returns the latest full-release version of an npm package that has been
  * published for at least `minimumReleaseAgeMinutes` minutes. Prefers the
@@ -9007,5 +9250,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AuditCategory, AuditMode, AuditSeverity, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SampleLang, StarlightProject, TestRunner, TsDocCoverageKind, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, vitestBundle };
-export type { AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffFinding, ApiExtractorOptions, ApiExtractorReportOptions, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PreflightMergeMethod, PreflightPrConfig, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueTemplates, ResolvedPreflightPr, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedUnblockDependents, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TsDocCoverageRecord, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, VersionKey, VitestConfigOptions, VitestOptions };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AuditCategory, AuditMode, AuditSeverity, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SampleLang, StarlightProject, TestRunner, TsDocCoverageKind, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, createApiDiffCheck, createReferenceMismatchCheck, createTsdocCoverageCheck, customerProfileBundle, diffApiRollups, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, parseApiRollup, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, referenceRecordToFinding, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, tsdocRecordToFindings, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, vitestBundle };
+export type { AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffCheckOptions, ApiDiffFinding, ApiDiffResult, ApiExtractorOptions, ApiExtractorReportOptions, ApiSurfaceEntry, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PreflightMergeMethod, PreflightPrConfig, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReferenceMismatchCheckOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueTemplates, ResolvedPreflightPr, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedUnblockDependents, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TsDocCoverageRecord, TsdocCoverageCheckOptions, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, VersionKey, VitestConfigOptions, VitestOptions };