@codedrifters/configulator 0.0.273 → 0.0.275

package/lib/index.d.mts

@@ -3,6 +3,7 @@ import { Project, Component as Component$1, Task } from 'projen/lib';
 import { NodeProject } from 'projen/lib/javascript';
 import { AwsCdkTypeScriptApp } from 'projen/lib/awscdk';
 import { AwsStageType, DeploymentTargetRoleType, AwsEnvironmentType, AWS_STAGE_TYPE } from '@codedrifters/utils';
+import * as ts from 'typescript';
 import * as spec from '@jsii/spec';
 import { TypeScriptProject as TypeScriptProject$1, TypeScriptAppProject, TypeScriptProjectOptions as TypeScriptProjectOptions$1 } from 'projen/lib/typescript';
 import { ValueOf } from 'type-fest';
@@ -3469,6 +3470,37 @@ declare function renderCheckLinksProcedure(): string;
  * findings.
  */
 declare const checkLinksProcedure: AgentProcedure;
+/**
+ * Render the shell body of the
+ * `.claude/procedures/check-doc-samples.sh` helper. Exported so the
+ * docs-sync bundle can register it as an `AgentProcedure` and the
+ * bundles test suite can assert on the script's contents.
+ *
+ * The helper wraps the `compileFencedSamples` API exported from
+ * `@codedrifters/configulator` (under `src/docs-sync/sample-compilation/`)
+ * and emits a single JSON-array stream of failure records on stdout.
+ * Detection is **data**, not failure: the helper exits `0` when the
+ * compilation phase ran successfully, regardless of how many samples
+ * failed to compile. Non-zero exits are reserved for tool-level
+ * failures (missing binary, IO error, internal exception).
+ *
+ * Exit codes: `0` success, `1` usage error or unreadable docs root,
+ * `2` a required binary is missing (`node` / `pnpm`), `3` the
+ * compilation phase threw an unhandled exception.
+ */
+declare function renderCheckDocSamplesProcedure(): string;
+/**
+ * `AgentProcedure` definition for
+ * `.claude/procedures/check-doc-samples.sh`. Registered on the
+ * docs-sync bundle so it ships when the bundle is force-included —
+ * matches the packaging of `extractApiProcedure` and
+ * `checkLinksProcedure` above. Provides the fenced-sample
+ * compilation input the docs-sync scan phase (#520) consumes
+ * alongside link integrity, API-extractor, TSDoc-coverage, and
+ * doc-reference findings. Per the parent epic, fenced TS samples
+ * that fail to compile are one of the two hard-block cases.
+ */
+declare const checkDocSamplesProcedure: AgentProcedure;
 /**
  * Docs-sync bundle — scaffolding release.
  *
@@ -6456,6 +6488,769 @@ interface ExtractDocReferencesOptions {
  */
 declare function extractDocReferences(options?: ExtractDocReferencesOptions): Array<DocReferenceRecord>;
 
+/**
+ * One row in the fenced-sample extraction report — describes a single
+ * fenced TypeScript code block found in a markdown page.
+ */
+interface FencedSampleRecord {
+    /**
+     * Path to the markdown file the sample was extracted from. Resolved
+     * relative to the configured `docsRoot` so reports are stable
+     * across machines (no absolute prefixes leak through).
+     */
+    readonly docPath: string;
+    /**
+     * 1-indexed line number of the opening fence (the line that begins
+     * with the three backticks), as reported by the markdown parser.
+     */
+    readonly line: number;
+    /**
+     * 0-indexed position of this fenced block among all fenced TS-shaped
+     * blocks in the same markdown file. Useful when a single page has
+     * multiple samples and the consumer needs to disambiguate findings.
+     */
+    readonly fenceIndex: number;
+    /**
+     * Language tag as written on the opening fence (e.g. `ts`,
+     * `typescript`, `tsx`, `typescriptreact`). Always lower-cased.
+     */
+    readonly lang: SampleLang;
+    /**
+     * Raw source of the code block, exactly as written between the
+     * fences. Trailing newlines are preserved so the compiler sees the
+     * same input the human author intended.
+     */
+    readonly code: string;
+    /**
+     * `true` when the sample was tagged as opt-out (via fence meta or
+     * an in-source pragma) and the compilation phase should skip it.
+     * Skipped samples are still surfaced in the extraction report so
+     * downstream consumers can audit them; the {@link compileFencedSamples}
+     * helper filters them out before invoking `tsc`.
+     */
+    readonly skipped: boolean;
+    /**
+     * Short description of why a sample was skipped. Empty string when
+     * `skipped` is `false`.
+     */
+    readonly skipReason: string;
+}
+/**
+ * Recognized fenced-block language tags that the extractor treats as
+ * compilable TypeScript samples.
+ */
+declare const SampleLang: {
+    readonly Ts: "ts";
+    readonly Typescript: "typescript";
+    readonly Tsx: "tsx";
+    readonly Typescriptreact: "typescriptreact";
+};
+/**
+ * String-literal type matching the values of {@link SampleLang}.
+ */
+type SampleLang = (typeof SampleLang)[keyof typeof SampleLang];
+/**
+ * Options accepted by {@link extractFencedSamples}.
+ */
+interface ExtractFencedSamplesOptions {
+    /**
+     * Absolute or repo-relative path to the docs root that should be
+     * walked for `*.md` files. Defaults to `docs/src/content/docs/`
+     * relative to the current working directory when omitted.
+     *
+     * @default "docs/src/content/docs"
+     */
+    readonly docsRoot?: string;
+    /**
+     * When `true`, fenced blocks tagged `tsx` or `typescriptreact` are
+     * included in the report. Defaults to `true` because the docs-sync
+     * scan phase is JSX-aware; flip to `false` to scope a run to plain
+     * TypeScript only.
+     *
+     * @default true
+     */
+    readonly includeTsx?: boolean;
+}
+/**
+ * Walks every `*.md` file under the configured docs root and returns
+ * one record per fenced TypeScript code block.
+ *
+ * The walker is AST-based — markdown is parsed with
+ * `mdast-util-from-markdown` and only `code` (fenced + indented)
+ * nodes are inspected. The `lang` attribute on the AST node is
+ * matched against {@link SampleLang}; fences tagged `ts`,
+ * `typescript`, `tsx`, or `typescriptreact` produce records.
+ * Anything else (`bash`, `json`, untagged, etc.) is skipped.
+ *
+ * Skip detection. A sample is recorded with `skipped: true` when
+ * either of these conditions holds:
+ *
+ * - The fence's `meta` string contains the word `skip` or `no-check`
+ *   (case-insensitive) — i.e. either token follows the language tag
+ *   on the opening fence line.
+ * - The sample's first non-blank line is the comment `// @no-check`
+ *   (case-insensitive on the directive name; the leading `//` is
+ *   required).
+ *
+ * @param options - Extraction options. All fields are optional; pass
+ *                  an empty object to use defaults.
+ */
+declare function extractFencedSamples(options?: ExtractFencedSamplesOptions): Array<FencedSampleRecord>;
+
+/**
+ * One row in the sample-compilation report — describes a single
+ * compilation failure. Compiles that succeeded are intentionally
+ * absent: the docs-sync scan phase consumes failures only and treats
+ * an empty array as "every sample compiled cleanly".
+ */
+interface SampleCompilationFailure {
+    /**
+     * Path to the markdown file the sample was extracted from. Resolved
+     * relative to the configured `docsRoot` so reports are stable
+     * across machines.
+     */
+    readonly docPath: string;
+    /**
+     * 1-indexed line number of the opening fence in the source markdown
+     * file (the line that begins with the three backticks).
+     */
+    readonly line: number;
+    /**
+     * 0-indexed position of this fenced block among all fenced TS-shaped
+     * blocks in the same markdown file.
+     */
+    readonly fenceIndex: number;
+    /**
+     * Language tag the sample carried — one of `ts`, `typescript`,
+     * `tsx`, or `typescriptreact`.
+     */
+    readonly lang: SampleLang;
+    /**
+     * Flat array of compiler diagnostics, one entry per `tsc` finding.
+     * Each entry is the message text plus any code prefix the compiler
+     * surfaced — formatted to be self-contained so the consuming scan
+     * report can render the failure without re-running the compiler.
+     */
+    readonly diagnostics: Array<string>;
+}
+/**
+ * Options accepted by {@link compileFencedSamples}.
+ */
+interface CompileFencedSamplesOptions extends ExtractFencedSamplesOptions {
+    /**
+     * Override the {@link ts.CompilerOptions} the helper uses when
+     * compiling each sample. Merged on top of the helper's defaults
+     * (see {@link DEFAULT_SAMPLE_COMPILER_OPTIONS}). Override sparingly:
+     * the defaults are tuned to be permissive on prose samples (no
+     * unused-locals/unused-parameters errors, JSX preserved for tsx,
+     * lib targets DOM/ES2022). Setting an option to `undefined` here
+     * removes the helper's default for that key.
+     */
+    readonly compilerOptions?: ts.CompilerOptions;
+    /**
+     * When `true`, diagnostics carrying TS error code `2307`
+     * ("Cannot find module …") are demoted from failures to silent
+     * skips for repo-relative module specifiers (paths starting with
+     * `./`, `../`, or `/`). Bare specifiers like `react` or
+     * `@scope/pkg` are still treated as failures because they
+     * indicate genuinely missing imports rather than docs-relative
+     * sample drift.
+     *
+     * @default true
+     */
+    readonly tolerateRepoRelativeMissingModule?: boolean;
+}
+/**
+ * Default compiler options applied to every fenced sample. Tuned to
+ * be permissive on prose samples while still surfacing real
+ * compilation errors:
+ *
+ * - `target` / `module` mirror modern Node + ES module conventions.
+ * - `lib` carries `DOM` so samples that mention `console`,
+ *   `document`, or `window` compile cleanly.
+ * - `strict` stays on so the helper still catches type errors.
+ * - `noUnusedLocals` / `noUnusedParameters` stay **off** because
+ *   prose samples often declare a name purely to demonstrate a
+ *   shape; flagging that as a failure would block useful docs.
+ * - `skipLibCheck` is on so a missing `.d.ts` in a transitive
+ *   dependency does not poison the suite.
+ * - `jsx` preserves the JSX so `tsx` fenced blocks compile.
+ * - `noEmit` is the whole point — we only need diagnostics.
+ */
+declare const DEFAULT_SAMPLE_COMPILER_OPTIONS: ts.CompilerOptions;
+/**
+ * Walks every `*.md` file under the configured docs root, extracts
+ * fenced TypeScript samples, and runs the TypeScript compiler against
+ * each non-skipped sample. Returns one record per failing sample —
+ * passing samples are intentionally absent from the result.
+ *
+ * Each sample is compiled in its own in-memory program so unrelated
+ * blocks never share scope. Skipped samples (fence meta `skip` /
+ * `no-check`, or first line `// @no-check`) are passed through
+ * unchecked.
+ *
+ * The helper does not invoke `tsc` as a subprocess — it uses the TS
+ * compiler API directly with the host's `typescript` peer dependency.
+ * That means a single test or scan run produces a single TypeScript
+ * Program per sample, which is fast enough for the scan-phase budget
+ * but does mean callers must not pass it the full repo's `docs/`
+ * tree at unit-test time. Tests stay on small inline tmpdir fixtures.
+ *
+ * @param options - Compilation options. All fields are optional;
+ *                  pass an empty object to use defaults.
+ */
+declare function compileFencedSamples(options?: CompileFencedSamplesOptions): Array<SampleCompilationFailure>;
+
+/**
+ * Schema definitions for the docs-sync scan-phase audit report.
+ *
+ * The report is the durable output of Phase 1 (Scan) of the docs-sync
+ * pipeline (parent epic #448). Phase 1 walks the repo, runs every
+ * registered drift check, and persists a single combined report to
+ * `.claude/state/docs-sync/<N>-audit.json` (where `<N>` is the
+ * tracking-issue number). Phase 2 (Fix) reads the persisted report
+ * and applies mechanical fixes — the two phases never share an
+ * in-memory handle, so the JSON shape on disk is the contract
+ * between them.
+ *
+ * #518 ships the **schema and the orchestrator skeleton only**. The
+ * actual drift checks (API/TSDoc/reference, link, fenced-sample) are
+ * wired in by children #519 and #520 by passing additional
+ * `AuditCheckRunner` instances to {@link runScan}. An empty
+ * runner list is the supported scaffold-time configuration and
+ * produces a schema-compliant report with empty findings in every
+ * category.
+ *
+ * The schema is intentionally **keyed by drift-check category** at
+ * the top level (`apiDiff`, `tsdocCoverage`, `referenceMismatches`,
+ * `linkFailures`, `sampleFailures`) so consumers can render or
+ * filter by category without re-grouping a flat list. Each
+ * category-keyed array carries category-specific finding shapes,
+ * and a flat `findings` array re-aggregates the same records with
+ * `category` and `severity` fields attached so the report doubles
+ * as a backlog source for downstream tooling.
+ */
+/**
+ * Drift-check categories the docs-sync scan phase can produce
+ * findings in. Exhaustive — adding a new category here is a schema
+ * change that requires bumping {@link DOCS_SYNC_AUDIT_SCHEMA_VERSION}
+ * and updating every consumer that switches on the literal.
+ */
+declare const AuditCategory: {
+    /**
+     * Findings produced by the public-API diff check that surfaces
+     * added, renamed, or removed exports between the current branch
+     * and the recorded baseline. Wired in by child issue #519.
+     */
+    readonly ApiDiff: "apiDiff";
+    /**
+     * Findings produced by the TSDoc-coverage check that flags public
+     * exports without a one-sentence summary. Wired in by child issue
+     * #519.
+     */
+    readonly TsdocCoverage: "tsdocCoverage";
+    /**
+     * Findings produced by the doc-reference cross-index check that
+     * flags inline-code symbol mentions whose target is missing or
+     * has changed. Wired in by child issue #519.
+     */
+    readonly ReferenceMismatches: "referenceMismatches";
+    /**
+     * Findings produced by the link-integrity check (internal via
+     * `astro check`, external via `lychee`). Wired in by child issue
+     * #520.
+     */
+    readonly LinkFailures: "linkFailures";
+    /**
+     * Findings produced by the fenced-sample compilation check that
+     * flags ` ```ts ` / ` ```typescript ` / ` ```tsx ` blocks in the
+     * docs that fail `tsc`. Wired in by child issue #520.
+     */
+    readonly SampleFailures: "sampleFailures";
+};
+/**
+ * String-literal type matching the values of {@link AuditCategory}.
+ */
+type AuditCategory = (typeof AuditCategory)[keyof typeof AuditCategory];
+/**
+ * Severity ladder applied to every finding before persistence. The
+ * ladder mirrors the parent epic's behavior-on-drift contract —
+ * mechanical fixes auto-apply, advisory findings post a non-blocking
+ * note, blocking findings hand off to `pr-reviewer` via
+ * `review:human-required`.
+ */
+declare const AuditSeverity: {
+    /**
+     * The finding has a deterministic mechanical fix that the Phase 2
+     * (Fix) agent will auto-apply (TSDoc stubs, dead-link updates,
+     * registry sync, etc.).
+     */
+    readonly Mechanical: "mechanical";
+    /**
+     * The finding deserves human attention but does not block the PR.
+     * Surfaced as a non-blocking note on the sticky `## Docs sync`
+     * comment.
+     */
+    readonly Advisory: "advisory";
+    /**
+     * The finding blocks the PR. Per the parent epic this is reserved
+     * for the two narrow cases of confirmed broken external links and
+     * fenced TS samples that fail to compile.
+     */
+    readonly Blocking: "blocking";
+};
+/**
+ * String-literal type matching the values of {@link AuditSeverity}.
+ */
+type AuditSeverity = (typeof AuditSeverity)[keyof typeof AuditSeverity];
+/**
+ * Invocation mode of the scan phase. Determines how downstream
+ * tooling treats the report — `pr` reports run against a single
+ * branch and feed `pr-reviewer`; `audit` reports walk the whole
+ * repo and feed the prioritized `docs:write` backlog.
+ */
+declare const AuditMode: {
+    readonly Pr: "pr";
+    readonly Audit: "audit";
+};
+/**
+ * String-literal type matching the values of {@link AuditMode}.
+ */
+type AuditMode = (typeof AuditMode)[keyof typeof AuditMode];
+/**
+ * File-and-line location attached to most finding shapes. The
+ * `file` field is always a path relative to the repo root so reports
+ * are portable across machines; absolute paths must be normalized
+ * before they reach the report.
+ */
+interface AuditLocation {
+    /**
+     * Path relative to {@link AuditReport.repoRoot}. Empty string is
+     * permitted for findings that have no associated file (e.g. an
+     * `apiDiff` removed-export finding that lost its source location).
+     */
+    readonly file: string;
+    /**
+     * 1-indexed line number when known. `0` means "line is not known"
+     * — downstream consumers must treat `0` as missing rather than as
+     * the literal first line.
+     */
+    readonly line: number;
+}
+/**
+ * Common fields every finding shape carries. The category-specific
+ * record types below extend this interface with additional fields.
+ */
+interface AuditFindingBase {
+    /**
+     * Drift-check category that produced the finding. Mirrors the key
+     * on the {@link AuditReport} that the finding is filed under.
+     */
+    readonly category: AuditCategory;
+    /**
+     * Severity classification per the {@link AuditSeverity} ladder.
+     */
+    readonly severity: AuditSeverity;
+    /**
+     * Source location the finding is anchored at. Empty location is
+     * tolerated for findings with no concrete anchor.
+     */
+    readonly location: AuditLocation;
+    /**
+     * Stable subject identifier. For symbol findings this is the
+     * exported symbol name; for link findings the URL; for sample
+     * findings the docPath plus fence index. Used by Phase 2 to
+     * deduplicate findings across runs.
+     */
+    readonly subject: string;
+    /**
+     * One-sentence human-readable description of the finding.
+     * Phase 2 surfaces this directly in the sticky PR comment, so
+     * keep it short and self-contained — no markdown links to
+     * external context, and never includes generated prose over the
+     * 100-word stub budget.
+     */
+    readonly details: string;
+    /**
+     * Optional hint for the Phase 2 fix agent. When present and the
+     * severity is `mechanical`, Phase 2 may use this string to
+     * compute the auto-applied edit. Free-form; downstream consumers
+     * should treat unknown hints as no-op.
+     */
+    readonly fixHint?: string;
+}
+/**
+ * Finding produced by the public-API diff check. Wired in by #519.
+ */
+interface ApiDiffFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.ApiDiff;
+    /**
+     * Kind of API change observed. The literal `added` covers a new
+     * export; `removed` covers a deletion; `changed` covers a
+     * signature change that does not rename or remove the symbol.
+     */
+    readonly change: "added" | "removed" | "changed";
+    /**
+     * Public name of the symbol whose surface changed.
+     */
+    readonly symbol: string;
+}
+/**
+ * Finding produced by the TSDoc-coverage check. Wired in by #519.
+ */
+interface TsdocCoverageFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.TsdocCoverage;
+    /**
+     * Public name of the symbol that is missing or has thin TSDoc.
+     */
+    readonly symbol: string;
+    /**
+     * Coverage shortfall the finding reports. `missing-summary`
+     * means no TSDoc at all; `thin-summary` means the summary exists
+     * but is shorter than the configured threshold; `missing-params`
+     * / `missing-returns` mean the signature has parameters or a
+     * return value with no matching block tag.
+     */
+    readonly shortfall: "missing-summary" | "thin-summary" | "missing-params" | "missing-returns";
+}
+/**
+ * Finding produced by the doc-reference cross-index check. Wired in
+ * by #519.
+ */
+interface ReferenceMismatchFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.ReferenceMismatches;
+    /**
+     * Inline-code symbol referenced in the markdown source.
+     */
+    readonly symbol: string;
+    /**
+     * Why the reference is flagged. `unknown-symbol` means the
+     * symbol does not appear in the supplied known-symbols set;
+     * `signature-changed` means the symbol still resolves but its
+     * type signature differs from the cached snapshot.
+     */
+    readonly mismatch: "unknown-symbol" | "signature-changed";
+}
+/**
+ * Finding produced by the link-integrity check. Wired in by #520.
+ */
+interface LinkFailureFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.LinkFailures;
+    /**
+     * URL or relative path that failed integrity checks.
+     */
+    readonly url: string;
+    /**
+     * Whether the link is internal (resolved by `astro check`) or
+     * external (resolved by `lychee`).
+     */
+    readonly kind: "internal" | "external";
+    /**
+     * Short tool-supplied diagnostic explaining the failure.
+     */
+    readonly reason: string;
+}
+/**
+ * Finding produced by the fenced-sample compilation check. Wired in
+ * by #520.
+ */
+interface SampleFailureFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.SampleFailures;
+    /**
+     * 0-indexed position of the fenced block within the markdown file.
+     */
+    readonly fenceIndex: number;
+    /**
+     * Language tag the sample carried (e.g. `ts`, `typescript`,
+     * `tsx`, `typescriptreact`).
+     */
+    readonly lang: string;
+    /**
+     * Compiler diagnostics produced by `tsc` against the sample.
+     */
+    readonly diagnostics: ReadonlyArray<string>;
+}
+/**
+ * Discriminated union of every category-specific finding shape.
+ */
+type AuditFinding = ApiDiffFinding | TsdocCoverageFinding | ReferenceMismatchFinding | LinkFailureFinding | SampleFailureFinding;
+/**
+ * Schema version embedded on every persisted audit report. Bump on
+ * any breaking change to the report shape so downstream consumers
+ * can refuse incompatible files rather than mis-parsing them.
+ *
+ * Versioning is **integer-monotonic**: the producer of a v2 report
+ * is responsible for keeping the v1 fields parseable when
+ * possible, but a v1 reader must reject a v2 report it does not
+ * understand.
+ */
+declare const DOCS_SYNC_AUDIT_SCHEMA_VERSION = 1;
+/**
+ * Top-level audit-report shape persisted to
+ * `.claude/state/docs-sync/<N>-audit.json`. The category-keyed
+ * arrays are the durable surface; the flat `findings` array is a
+ * convenience aggregation of the same records.
+ */
+interface AuditReport {
+    /**
+     * Schema version embedded on every persisted report. Always
+     * equal to {@link DOCS_SYNC_AUDIT_SCHEMA_VERSION} at write time.
+     */
+    readonly schemaVersion: number;
+    /**
+     * Tracking-issue number the scan ran for. Determines the
+     * filename when persisted (`<issueNumber>-audit.json`).
+     */
+    readonly issueNumber: number;
+    /**
+     * Invocation mode — `pr` for diff-scoped runs invoked through
+     * `/docs-sync-pr`, `audit` for full-repo runs invoked through
+     * `/docs-sync-audit`.
+     */
+    readonly mode: AuditMode;
+    /**
+     * ISO 8601 UTC timestamp the scan completed at. Always written
+     * with `Z` suffix; consumers parse with `Date(...)`.
+     */
+    readonly generatedAt: string;
+    /**
+     * Absolute path to the repository root the scan ran against.
+     * Persisted so a downstream consumer reading the report on a
+     * different checkout can rewrite paths relative to its own
+     * root.
+     */
+    readonly repoRoot: string;
+    /**
+     * Optional free-form scope label attached at the issue level
+     * (e.g. `pr:feat/518-foo`, `audit:packages/configulator`).
+     * Empty string when no scope was supplied.
+     */
+    readonly scope: string;
+    /**
+     * Findings grouped by drift-check category. Every category key
+     * is always present and always an array — empty arrays are
+     * persisted explicitly so consumers never have to test for
+     * presence.
+     */
+    readonly categories: {
+        readonly apiDiff: ReadonlyArray<ApiDiffFinding>;
+        readonly tsdocCoverage: ReadonlyArray<TsdocCoverageFinding>;
+        readonly referenceMismatches: ReadonlyArray<ReferenceMismatchFinding>;
+        readonly linkFailures: ReadonlyArray<LinkFailureFinding>;
+        readonly sampleFailures: ReadonlyArray<SampleFailureFinding>;
+    };
+    /**
+     * Flat re-aggregation of every category-keyed finding into a
+     * single deterministically-ordered array. Sorted by `severity`
+     * (`blocking` first, then `advisory`, then `mechanical`), then
+     * `category` (alphabetical), then `location.file`,
+     * `location.line`, `subject`. Provided so consumers that don't
+     * need the category grouping can iterate one array and see the
+     * merge-blocking findings at the top.
+     */
+    readonly findings: ReadonlyArray<AuditFinding>;
+}
+/**
+ * JSON-Schema-shaped descriptor for {@link AuditReport}. Returned by
+ * {@link auditReportJsonSchema} so downstream tooling (e.g. ajv)
+ * can validate persisted reports without re-importing the TS
+ * types. The shape is hand-authored and deliberately permissive on
+ * forward-compatible additions (extra category keys are forbidden;
+ * extra finding fields are permitted).
+ *
+ * Returned as a plain JSON-shaped record — callers that want to
+ * feed it into ajv or another validator pass it through directly.
+ */
+declare function auditReportJsonSchema(): Record<string, unknown>;
+
+/**
+ * Default subdirectory beneath the repo root where audit reports are
+ * persisted. Mirrors the path declared on issue #518's acceptance
+ * criteria: `.claude/state/docs-sync/<N>-audit.json`.
+ */
+declare const DEFAULT_AUDIT_REPORT_DIR = ".claude/state/docs-sync";
+/**
+ * Stable iteration order for category keys. Matches the order they
+ * appear in the persisted report and the order they ran during the
+ * scan (API surface diff first, then TSDoc, then references, then
+ * the docs-only checks). The order is part of the contract — a
+ * consumer that walks `Object.keys(report.categories)` sees this
+ * order on every read.
+ */
+declare const AUDIT_CATEGORY_ORDER: ReadonlyArray<AuditCategory>;
+/**
+ * One drift-check runner. The scan orchestrator invokes each
+ * runner in registration order, collects the findings, and merges
+ * them into the persisted report. Runners are intentionally
+ * synchronous to keep the scaffold simple — children #519 and
+ * #520 may introduce async runners by adding a parallel
+ * `AsyncAuditCheckRunner` shape if needed.
+ *
+ * Runners are pure functions: given the same context they should
+ * produce the same finding list. The scan orchestrator does not
+ * sandbox them — a runner that mutates the filesystem or shells
+ * out is on its own honor.
+ */
+interface AuditCheckRunner {
+    /**
+     * Stable name used in diagnostics and logs. Conventionally
+     * matches the category the runner produces findings in (e.g.
+     * `apiDiff`, `tsdocCoverage`).
+     */
+    readonly name: string;
+    /**
+     * Compute the findings for this check. Runners must return
+     * already-validated finding records — the orchestrator does not
+     * post-process category, severity, or location.
+     */
+    run(context: AuditCheckRunnerContext): ReadonlyArray<AuditFinding>;
+}
+/**
+ * Context passed to every check runner. Carries the same fields
+ * the orchestrator needs to populate the report header so runners
+ * can consult them when computing their findings (e.g. resolve
+ * relative paths against `repoRoot`).
+ */
+interface AuditCheckRunnerContext {
+    readonly repoRoot: string;
+    readonly mode: AuditMode;
+    readonly scope: string;
+    readonly issueNumber: number;
+}
+/**
+ * Options accepted by {@link runScan}.
+ */
+interface RunScanOptions {
+    /**
+     * Absolute path to the repository root the scan runs against.
+     * The audit report's `repoRoot` field is set to this value
+     * verbatim — pass an absolute path so consumers reading the
+     * report on a different checkout can rewrite paths reliably.
+     */
+    readonly repoRoot: string;
+    /**
+     * Tracking-issue number the scan ran for. Determines the
+     * persisted filename (`<issueNumber>-audit.json`).
+     */
+    readonly issueNumber: number;
+    /**
+     * Invocation mode — `pr` for diff-scoped runs, `audit` for
+     * full-repo runs.
+     */
+    readonly mode: AuditMode;
+    /**
+     * Optional free-form scope label. Persisted on the report and
+     * forwarded to every runner. Defaults to the empty string.
+     */
+    readonly scope?: string;
+    /**
+     * Drift-check runners to invoke in order. Empty by default —
+     * #518 ships the orchestrator skeleton without any wired
+     * checks; #519 and #520 plug them in.
+     */
+    readonly checks?: ReadonlyArray<AuditCheckRunner>;
+    /**
+     * Override the timestamp embedded on the report. Used in tests
+     * to make output deterministic. Defaults to `new Date()` at
+     * scan start.
+     */
+    readonly now?: Date;
+    /**
+     * When `true`, persist the report to disk under
+     * `<repoRoot>/<reportDir>/<issueNumber>-audit.json`. When
+     * `false` (the default), the report is returned in memory only.
+     *
+     * @default false
+     */
+    readonly persist?: boolean;
+    /**
+     * Override the directory the report is written to (relative to
+     * {@link RunScanOptions.repoRoot}). Defaults to
+     * {@link DEFAULT_AUDIT_REPORT_DIR}.
+     *
+     * @default ".claude/state/docs-sync"
+     */
+    readonly reportDir?: string;
+}
+/**
+ * Result returned by {@link runScan}. Always carries the report;
+ * `reportPath` is non-empty only when persistence was requested.
+ */
+interface RunScanResult {
+    /**
+     * The report produced by the scan. Schema-compliant whether or
+     * not any checks ran — empty `categories` arrays are persisted
+     * explicitly.
+     */
+    readonly report: AuditReport;
+    /**
+     * Absolute path the report was persisted to. Empty string when
+     * `persist` was `false`.
+     */
+    readonly reportPath: string;
+}
+/**
+ * Run the docs-sync scan phase. Invokes every registered check
+ * runner in order, merges the findings into a single
+ * schema-compliant {@link AuditReport}, and optionally persists
+ * the report to `<repoRoot>/<reportDir>/<issueNumber>-audit.json`.
+ *
+ * #518 ships this function with an **empty default check list**:
+ * invoking `runScan({ repoRoot, issueNumber, mode: "pr" })`
+ * produces a report whose `findings` and per-category arrays are
+ * all empty. Children #519 and #520 register the real checks by
+ * passing them via the `checks` option.
+ */
+declare function runScan(options: RunScanOptions): RunScanResult;
+/**
+ * Compute the final {@link AuditReport} from a flat list of
+ * findings. Group by category, sort each bucket deterministically,
+ * and produce the flat `findings` aggregation in the documented
+ * order. Exported so #519 / #520 can build reports incrementally
+ * without re-running the whole scan.
+ */
+declare function buildReport(args: {
+    readonly issueNumber: number;
+    readonly mode: AuditMode;
+    readonly scope: string;
+    readonly repoRoot: string;
+    readonly generatedAt: Date;
+    readonly findings: ReadonlyArray<AuditFinding>;
+}): AuditReport;
+/**
+ * Persist an {@link AuditReport} to disk. The directory is created
+ * recursively when missing; the file is written atomically via a
+ * temp-file + rename so a partial write never produces a corrupt
+ * report.
+ */
+declare function persistAuditReport(args: {
+    readonly report: AuditReport;
+    readonly repoRoot: string;
+    readonly reportDir?: string;
+}): string;
+/**
+ * Build an empty {@link AuditReport.categories} record with every
+ * key explicitly set to an empty array. Exported so callers that
+ * stub the report shape in tests don't have to repeat the keys.
+ */
+declare function emptyCategoryBuckets(): {
+    apiDiff: Array<AuditFinding & {
+        category: typeof AuditCategory.ApiDiff;
+    }>;
+    tsdocCoverage: Array<AuditFinding & {
+        category: typeof AuditCategory.TsdocCoverage;
+    }>;
+    referenceMismatches: Array<AuditFinding & {
+        category: typeof AuditCategory.ReferenceMismatches;
+    }>;
+    linkFailures: Array<AuditFinding & {
+        category: typeof AuditCategory.LinkFailures;
+    }>;
+    sampleFailures: Array<AuditFinding & {
+        category: typeof AuditCategory.SampleFailures;
+    }>;
+};
+
 /**
  * One row in the TSDoc-coverage report — describes a single public
  * symbol exported (transitively) from the package's entry point and
@@ -8474,4 +9269,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, 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, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, DEFAULT_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_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_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, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type ExtractDocReferencesOptions, 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, 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 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 ResolvedWorkflowDiagrams, type RunRatioConfig, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, 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, 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, type WorkflowDiagramsConfig, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, customerProfileBundle, docsSyncBundle, extractApiProcedure, extractDocReferences, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, 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, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, validateWorkflowDiagramsConfig, 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 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, 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, 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, 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 ResolvedWorkflowDiagrams, 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, type WorkflowDiagramsConfig, 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 };