@codedrifters/configulator 0.0.274 → 0.0.276

package/lib/index.d.mts

@@ -464,6 +464,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.
@@ -2226,117 +2233,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
@@ -3028,40 +2924,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.
@@ -5148,179 +5010,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.
@@ -6701,6 +6390,556 @@ declare const DEFAULT_SAMPLE_COMPILER_OPTIONS: ts.CompilerOptions;
  */
 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
@@ -8719,4 +8958,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 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_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, 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, 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 SampleCompilationFailure, 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, 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, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, 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, 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, DOCS_SYNC_AUDIT_SCHEMA_VERSION, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, type LinkFailureFinding, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PreflightMergeMethod, type PreflightPrConfig, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type ReferenceMismatchFinding, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueTemplates, type ResolvedPreflightPr, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedUnblockDependents, type RunRatioConfig, type RunScanOptions, type RunScanResult, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, type SampleCompilationFailure, type SampleFailureFinding, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, type TsdocCoverageFinding, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, vitestBundle };