@codedrifters/configulator 0.0.275 → 0.0.277

package/lib/index.d.ts

@@ -513,6 +513,13 @@ declare const DEFAULT_STATUS_LABELS: ReadonlyArray<LabelDefinition>;
 declare const DEFAULT_PRIORITY_LABELS: ReadonlyArray<LabelDefinition>;
 /** Default type labels — one per conventional commit type. */
 declare const DEFAULT_TYPE_LABELS: ReadonlyArray<LabelDefinition>;
+/**
+ * Hard limit GitHub's Labels API enforces on the `description` field.
+ * EndBug/label-sync rejects (and the API returns an opaque error for)
+ * any label whose description exceeds this length, which silently
+ * breaks the sync workflow downstream.
+ */
+declare const MAX_LABEL_DESCRIPTION_LENGTH = 100;
 /**
  * Adds a labels config file and a GitHub Actions workflow that syncs
  * labels to the repository using EndBug/label-sync.
@@ -2275,117 +2282,6 @@ interface SkillEvalsConfig {
      */
     readonly emitRunner?: boolean;
 }
-/*******************************************************************************
- *
- * Workflow Diagrams Config
- *
- ******************************************************************************/
-/**
- * Workflow-diagrams convention consumed by the `base` bundle and
- * every phased-agent bundle. Documents the single hand-authored
- * Mermaid-based diagrams page that visualises every agent's phase
- * graph and every cross-agent handoff, and enforces the
- * **diagram-touched-when-bundle-touched** rule: a change set that
- * modifies a bundle's phase graph must also update the matching
- * section in the diagrams page.
- *
- * The convention is deliberately content-free — configulator cannot
- * ship meaningful diagrams because each consuming repo enables a
- * different subset of bundles and customises agent labels, paths,
- * and taxonomies via the Group A injection points. Instead the
- * bundle renders the rule (what to author, when to update it) and
- * optionally emits a starter page + a checker script.
- *
- * Every field is optional. When the whole config is absent the
- * convention ships **enabled** with the documented default diagrams
- * path (`docs/src/content/docs/agents/workflows.md`), the default
- * bundle-path patterns, the hard-requirement phrasing, the starter
- * page opt-in, and the checker script opt-in.
- *
- * Malformed configs — empty / whitespace-only or absolute
- * `diagramsPath`, empty `bundlePathPatterns`, empty /
- * whitespace-only pattern entry — fail the build at synth time via
- * `validateWorkflowDiagramsConfig`.
- *
- * @see ./bundles/workflow-diagrams.ts#resolveWorkflowDiagrams
- * @see ./bundles/workflow-diagrams.ts#validateWorkflowDiagramsConfig
- * @see ./bundles/workflow-diagrams.ts#renderWorkflowDiagramsRuleContent
- */
-interface WorkflowDiagramsConfig {
-    /**
-     * Master switch for the workflow-diagrams convention. When `false`,
-     * the base bundle renders a short stub stating the project does not
-     * enforce the convention; phased-agent bundles skip the
-     * per-workflow "Workflow Diagram" injection and the optional helper
-     * script / starter page are not emitted even if their `emit*`
-     * flags are true.
-     *
-     * Defaults to `true` — the convention is on by default.
-     */
-    readonly enabled?: boolean;
-    /**
-     * Repo-relative path to the single workflow-diagrams page. The
-     * rendered rule cites this path as the on-disk home of every
-     * Mermaid diagram; the checker script uses it as the sentinel path
-     * that must appear in a change set when any bundle file is
-     * touched.
-     *
-     * Must be a non-empty relative path (no leading `/`).
-     *
-     * Defaults to `docs/src/content/docs/agents/workflows.md`, which
-     * matches the monorepo-wide singleton `/docs` Starlight site every
-     * configulator-managed repo ships.
-     */
-    readonly diagramsPath?: string;
-    /**
-     * Path patterns (bash-style globs) that identify "bundle files" —
-     * the source files whose edits require the workflow-diagrams page
-     * to be touched in the same change set. Rendered verbatim into
-     * the rule body as a bullet list and emitted into the checker
-     * script when `emitChecker: true`.
-     *
-     * Must be a non-empty array of non-empty strings.
-     *
-     * Defaults to the configulator-wide set covering in-tree bundle
-     * source files, `.claude/agents/**.md` agent prompts, and
-     * `.claude/skills/**.md` skill prompts.
-     */
-    readonly bundlePathPatterns?: ReadonlyArray<string>;
-    /**
-     * Whether the convention emits a minimal starter diagrams page to
-     * disk at `<diagramsPath>`. The starter carries the expected
-     * structure (master diagram placeholder, one example agent section,
-     * legend) so consumers adopting the convention on a green-field
-     * repo have a working template to extend.
-     *
-     * Disabled by default because the page is hand-authored — an
-     * emitted stub would conflict with existing content on repos
-     * adopting the convention late.
-     */
-    readonly emitStarterDiagram?: boolean;
-    /**
-     * Whether the convention emits the
-     * `.claude/procedures/check-workflow-diagrams.sh` helper to disk.
-     * The script walks a newline-separated list of changed files (from
-     * stdin or positional arguments) and fails non-zero when any file
-     * matches a bundle-path pattern but `<diagramsPath>` is not also
-     * in the list.
-     *
-     * Disabled by default — the helper is opt-in for repos that want a
-     * hard CI gate or pre-commit hook. Consumers that prefer to
-     * enforce the rule via review discipline alone can leave it off.
-     */
-    readonly emitChecker?: boolean;
-    /**
-     * Whether the rendered rule body phrases the diagram update as a
-     * **hard requirement** (`MUST`) or a **strong recommendation**
-     * (`SHOULD`). Defaults to `true` — the hard-requirement phrasing
-     * matches the "enforced via CI" posture the convention is
-     * designed for. Consumers that treat diagrams as aspirational can
-     * soften the phrasing by setting this to `false`.
-     */
-    readonly requireDiagramUpdate?: boolean;
-}
 /*******************************************************************************
  *
  * Issue Templates Config
@@ -3077,40 +2973,6 @@ interface AgentConfigOptions {
      * @see ./bundles/skill-evals.ts#renderSkillEvalsRuleContent
      */
     readonly skillEvals?: SkillEvalsConfig;
-    /**
-     * Workflow-diagrams convention consumed by the `base` bundle and
-     * every phased-agent bundle. Documents the single hand-authored
-     * Mermaid-based diagrams page that visualises every agent's phase
-     * graph and every cross-agent handoff, and enforces the
-     * diagram-touched-when-bundle-touched rule: a change set that
-     * modifies a bundle's phase graph must also update the matching
-     * section in the diagrams page.
-     *
-     * When the whole config is omitted, the convention ships
-     * **enabled** with the default diagrams path
-     * (`docs/src/content/docs/agents/workflows.md`), the default
-     * bundle-path patterns, the hard-requirement phrasing, and both
-     * the starter page and the checker script opt-in.
-     *
-     * Supply `enabled: false` to disable the convention entirely,
-     * `diagramsPath` to move the page, `bundlePathPatterns` to
-     * replace the default pattern list, `emitStarterDiagram: true`
-     * to seed a minimal starter page on disk, `emitChecker: true` to
-     * ship the `.claude/procedures/check-workflow-diagrams.sh`
-     * helper, or `requireDiagramUpdate: false` to soften the rule
-     * phrasing from MUST to SHOULD.
-     *
-     * Malformed configs — empty / whitespace-only or absolute
-     * `diagramsPath`, empty `bundlePathPatterns`, empty /
-     * whitespace-only pattern entry — fail the build at synth time
-     * via `validateWorkflowDiagramsConfig`.
-     *
-     * @see WorkflowDiagramsConfig
-     * @see ./bundles/workflow-diagrams.ts#resolveWorkflowDiagrams
-     * @see ./bundles/workflow-diagrams.ts#validateWorkflowDiagramsConfig
-     * @see ./bundles/workflow-diagrams.ts#renderWorkflowDiagramsRuleContent
-     */
-    readonly workflowDiagrams?: WorkflowDiagramsConfig;
     /**
      * Issue-templates convention consumed by the `base` bundle and
      * every phased-agent bundle that files downstream issues.
@@ -5197,179 +5059,6 @@ declare function renderSkillEvalsBundleHook(se: ResolvedSkillEvals, skillLabel:
  */
 declare function renderSkillEvalsRunnerScript(se: ResolvedSkillEvals): string;
 
-/**
- * Default master switch for the workflow-diagrams convention. When no
- * config is supplied the convention ships **enabled** so every
- * configulator-consuming repo carries the "diagram-touched-when-bundle-
- * touched" rule in its rendered `CLAUDE.md`.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_ENABLED = true;
-/**
- * Default repo-relative path for the workflow-diagrams page. Matches
- * the singleton `/docs` site layout the monorepo contract assumes: a
- * single Starlight docs site at `/docs` with sub-project agent pages
- * under `docs/src/content/docs/agents/`.
- *
- * The file is never generated by configulator (the convention is
- * explicit: diagrams are hand-authored for readability). Consumers
- * opt into the starter stub via `emitStarterDiagram: true`.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_PATH = "docs/src/content/docs/agents/workflows.md";
-/**
- * Default list of glob patterns that identify "bundle files" — the
- * source files whose edits require the workflow-diagrams page to be
- * touched in the same change set.
- *
- * The defaults cover the two canonical locations bundle-like content
- * lives in a configulator-consuming repo:
- *
- * - `packages/@codedrifters/configulator/src/agent/bundles/**.ts` —
- *   the bundle authoring sites inside configulator itself.
- * - `.claude/agents/**.md` / `.claude/skills/**` — agent and skill
- *   prompts in consuming repos that don't re-export configulator
- *   bundles.
- *
- * Consumers can replace the list outright via `bundlePathPatterns`
- * when their agent sources live elsewhere (e.g. a monorepo that keeps
- * agents under `tools/agents/`).
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS: ReadonlyArray<string>;
-/**
- * Default for whether the convention emits a starter workflow-diagrams
- * page to disk at `<diagramsPath>`. Disabled by default because the
- * page is hand-authored — an emitted stub would conflict with
- * existing content on repos adopting the convention late.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER = false;
-/**
- * Default for whether the convention emits the
- * `.claude/procedures/check-workflow-diagrams.sh` checker script. The
- * script walks the staged / changed-file set and fails when a bundle
- * file is touched without the diagrams page being touched too.
- *
- * Disabled by default because many consumers prefer to enforce the
- * rule via review discipline and the rendered documentation alone;
- * the script is opt-in for repos that want a hard CI gate or
- * pre-commit hook.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER = false;
-/**
- * Default for whether the rendered rule body asserts the diagram
- * update as a **hard requirement** vs. a **strong recommendation**.
- * Defaults to `true` — the whole point of the convention is that
- * diagrams stay in sync, so the hard-requirement phrasing is the
- * correct default. Consumers that treat diagrams as aspirational can
- * soften the phrasing by setting this to `false`.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE = true;
-/**
- * Fully-resolved workflow-diagrams settings. Every field is defaulted
- * so downstream renderers can reason about a single canonical shape.
- */
-interface ResolvedWorkflowDiagrams {
-    readonly enabled: boolean;
-    readonly diagramsPath: string;
-    readonly bundlePathPatterns: ReadonlyArray<string>;
-    readonly emitStarterDiagram: boolean;
-    readonly emitChecker: boolean;
-    readonly requireDiagramUpdate: boolean;
-}
-/**
- * Resolve a (possibly absent) `WorkflowDiagramsConfig` into a
- * canonical `ResolvedWorkflowDiagrams` with every field filled in.
- * Unset fields cascade from their documented defaults.
- *
- * Malformed configs — empty / whitespace-only or absolute
- * `diagramsPath`, empty `bundlePathPatterns`, empty /
- * whitespace-only path entry — throw a descriptive `Error`.
- */
-declare function resolveWorkflowDiagrams(config?: WorkflowDiagramsConfig): ResolvedWorkflowDiagrams;
-/**
- * Synth-time validation hook. Throws a descriptive `Error` when the
- * supplied `WorkflowDiagramsConfig` is malformed. Called by
- * `AgentConfig.preSynthesize` before any rendering so a misconfigured
- * convention fails the build instead of silently shipping broken
- * workflow-diagrams guidance. Returns the resolved config unchanged
- * so callers can write
- * `const wd = validateWorkflowDiagramsConfig(config)` in one line.
- *
- * Malformed cases rejected here:
- *
- * - `diagramsPath` empty, whitespace-only, or absolute.
- * - `bundlePathPatterns` not an array, empty, or contains an empty /
- *   whitespace-only entry.
- */
-declare function validateWorkflowDiagramsConfig(config?: WorkflowDiagramsConfig): ResolvedWorkflowDiagrams;
-/**
- * Render the full body for the `workflow-diagrams-convention` rule
- * shipped by the `base` bundle. The rule documents:
- *
- * - Why the convention exists (diagram / prose drift).
- * - The on-disk contract — a single Mermaid-based page at
- *   `<diagramsPath>` with one diagram per agent + a master
- *   cross-agent diagram.
- * - The **diagram-touched-when-bundle-touched** rule, phrased as a
- *   hard requirement or a strong recommendation per
- *   `requireDiagramUpdate`.
- * - The set of paths the rule applies to.
- * - The optional checker script (cross-referenced only when emitted).
- *
- * When the convention is disabled, the rule renders a short stub.
- */
-declare function renderWorkflowDiagramsRuleContent(wd: ResolvedWorkflowDiagrams): string;
-/**
- * Render the short workflow-diagrams hook section injected into a
- * phased-agent bundle's workflow rule. The section cites the full
- * contract documented in the base bundle's
- * `workflow-diagrams-convention` rule so individual bundles stay DRY.
- *
- * When the convention is disabled, the function returns an empty
- * string so callers can no-op their append path.
- */
-declare function renderWorkflowDiagramsBundleHook(wd: ResolvedWorkflowDiagrams, bundleLabel: string): string;
-/**
- * Render a minimal starter workflow-diagrams page — a top-level
- * heading, the master-diagram placeholder, and a single example
- * agent section. Exported so `AgentConfig` can emit it to disk when
- * the consumer opts in via `emitStarterDiagram: true`.
- *
- * The starter is deliberately sparse: it documents the expected
- * structure without committing the consumer to a particular agent
- * list. Repos that already maintain a hand-authored diagrams page
- * should leave `emitStarterDiagram` off — the emission would
- * overwrite their content.
- */
-declare function renderWorkflowDiagramsStarterPage(_wd: ResolvedWorkflowDiagrams): string;
-/**
- * Render the `.claude/procedures/check-workflow-diagrams.sh` helper
- * script. Exported so `AgentConfig` can register it as an
- * `AgentProcedure` when the consumer opts in via `emitChecker: true`.
- *
- * The script accepts the list of changed files as either:
- *
- * 1. Positional arguments (one file per arg).
- * 2. Newline-separated entries on stdin (when no args supplied) —
- *    pipe `git diff --name-only` directly into it.
- *
- * It fails non-zero when any changed file matches a bundle-path
- * pattern and the configured diagrams path is not also in the list.
- * It exits `0` when no bundle files were touched or when the
- * diagrams page was touched alongside them.
- */
-declare function renderWorkflowDiagramsCheckerScript(wd: ResolvedWorkflowDiagrams): string;
-
 /**
  * Build the requirements-analyst bundle with the supplied resolved
  * paths.
@@ -7300,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
@@ -7419,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
@@ -9318,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, DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER, DEFAULT_WORKFLOW_DIAGRAMS_ENABLED, DEFAULT_WORKFLOW_DIAGRAMS_PATH, DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, 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, renderWorkflowDiagramsBundleHook, renderWorkflowDiagramsCheckerScript, renderWorkflowDiagramsRuleContent, renderWorkflowDiagramsStarterPage, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, resolveWorkflowDiagrams, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, validateWorkflowDiagramsConfig, 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, ResolvedWorkflowDiagrams, 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, WorkflowDiagramsConfig };
+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 };