@codedrifters/configulator 0.0.274 → 0.0.276

package/lib/index.d.ts

@@ -513,6 +513,13 @@ declare const DEFAULT_STATUS_LABELS: ReadonlyArray<LabelDefinition>;
 declare const DEFAULT_PRIORITY_LABELS: ReadonlyArray<LabelDefinition>;
 /** Default type labels — one per conventional commit type. */
 declare const DEFAULT_TYPE_LABELS: ReadonlyArray<LabelDefinition>;
+/**
+ * Hard limit GitHub's Labels API enforces on the `description` field.
+ * EndBug/label-sync rejects (and the API returns an opaque error for)
+ * any label whose description exceeds this length, which silently
+ * breaks the sync workflow downstream.
+ */
+declare const MAX_LABEL_DESCRIPTION_LENGTH = 100;
 /**
  * Adds a labels config file and a GitHub Actions workflow that syncs
  * labels to the repository using EndBug/label-sync.
@@ -2275,117 +2282,6 @@ interface SkillEvalsConfig {
      */
     readonly emitRunner?: boolean;
 }
-/*******************************************************************************
- *
- * Workflow Diagrams Config
- *
- ******************************************************************************/
-/**
- * Workflow-diagrams convention consumed by the `base` bundle and
- * every phased-agent bundle. Documents the single hand-authored
- * Mermaid-based diagrams page that visualises every agent's phase
- * graph and every cross-agent handoff, and enforces the
- * **diagram-touched-when-bundle-touched** rule: a change set that
- * modifies a bundle's phase graph must also update the matching
- * section in the diagrams page.
- *
- * The convention is deliberately content-free — configulator cannot
- * ship meaningful diagrams because each consuming repo enables a
- * different subset of bundles and customises agent labels, paths,
- * and taxonomies via the Group A injection points. Instead the
- * bundle renders the rule (what to author, when to update it) and
- * optionally emits a starter page + a checker script.
- *
- * Every field is optional. When the whole config is absent the
- * convention ships **enabled** with the documented default diagrams
- * path (`docs/src/content/docs/agents/workflows.md`), the default
- * bundle-path patterns, the hard-requirement phrasing, the starter
- * page opt-in, and the checker script opt-in.
- *
- * Malformed configs — empty / whitespace-only or absolute
- * `diagramsPath`, empty `bundlePathPatterns`, empty /
- * whitespace-only pattern entry — fail the build at synth time via
- * `validateWorkflowDiagramsConfig`.
- *
- * @see ./bundles/workflow-diagrams.ts#resolveWorkflowDiagrams
- * @see ./bundles/workflow-diagrams.ts#validateWorkflowDiagramsConfig
- * @see ./bundles/workflow-diagrams.ts#renderWorkflowDiagramsRuleContent
- */
-interface WorkflowDiagramsConfig {
-    /**
-     * Master switch for the workflow-diagrams convention. When `false`,
-     * the base bundle renders a short stub stating the project does not
-     * enforce the convention; phased-agent bundles skip the
-     * per-workflow "Workflow Diagram" injection and the optional helper
-     * script / starter page are not emitted even if their `emit*`
-     * flags are true.
-     *
-     * Defaults to `true` — the convention is on by default.
-     */
-    readonly enabled?: boolean;
-    /**
-     * Repo-relative path to the single workflow-diagrams page. The
-     * rendered rule cites this path as the on-disk home of every
-     * Mermaid diagram; the checker script uses it as the sentinel path
-     * that must appear in a change set when any bundle file is
-     * touched.
-     *
-     * Must be a non-empty relative path (no leading `/`).
-     *
-     * Defaults to `docs/src/content/docs/agents/workflows.md`, which
-     * matches the monorepo-wide singleton `/docs` Starlight site every
-     * configulator-managed repo ships.
-     */
-    readonly diagramsPath?: string;
-    /**
-     * Path patterns (bash-style globs) that identify "bundle files" —
-     * the source files whose edits require the workflow-diagrams page
-     * to be touched in the same change set. Rendered verbatim into
-     * the rule body as a bullet list and emitted into the checker
-     * script when `emitChecker: true`.
-     *
-     * Must be a non-empty array of non-empty strings.
-     *
-     * Defaults to the configulator-wide set covering in-tree bundle
-     * source files, `.claude/agents/**.md` agent prompts, and
-     * `.claude/skills/**.md` skill prompts.
-     */
-    readonly bundlePathPatterns?: ReadonlyArray<string>;
-    /**
-     * Whether the convention emits a minimal starter diagrams page to
-     * disk at `<diagramsPath>`. The starter carries the expected
-     * structure (master diagram placeholder, one example agent section,
-     * legend) so consumers adopting the convention on a green-field
-     * repo have a working template to extend.
-     *
-     * Disabled by default because the page is hand-authored — an
-     * emitted stub would conflict with existing content on repos
-     * adopting the convention late.
-     */
-    readonly emitStarterDiagram?: boolean;
-    /**
-     * Whether the convention emits the
-     * `.claude/procedures/check-workflow-diagrams.sh` helper to disk.
-     * The script walks a newline-separated list of changed files (from
-     * stdin or positional arguments) and fails non-zero when any file
-     * matches a bundle-path pattern but `<diagramsPath>` is not also
-     * in the list.
-     *
-     * Disabled by default — the helper is opt-in for repos that want a
-     * hard CI gate or pre-commit hook. Consumers that prefer to
-     * enforce the rule via review discipline alone can leave it off.
-     */
-    readonly emitChecker?: boolean;
-    /**
-     * Whether the rendered rule body phrases the diagram update as a
-     * **hard requirement** (`MUST`) or a **strong recommendation**
-     * (`SHOULD`). Defaults to `true` — the hard-requirement phrasing
-     * matches the "enforced via CI" posture the convention is
-     * designed for. Consumers that treat diagrams as aspirational can
-     * soften the phrasing by setting this to `false`.
-     */
-    readonly requireDiagramUpdate?: boolean;
-}
 /*******************************************************************************
  *
  * Issue Templates Config
@@ -3077,40 +2973,6 @@ interface AgentConfigOptions {
      * @see ./bundles/skill-evals.ts#renderSkillEvalsRuleContent
      */
     readonly skillEvals?: SkillEvalsConfig;
-    /**
-     * Workflow-diagrams convention consumed by the `base` bundle and
-     * every phased-agent bundle. Documents the single hand-authored
-     * Mermaid-based diagrams page that visualises every agent's phase
-     * graph and every cross-agent handoff, and enforces the
-     * diagram-touched-when-bundle-touched rule: a change set that
-     * modifies a bundle's phase graph must also update the matching
-     * section in the diagrams page.
-     *
-     * When the whole config is omitted, the convention ships
-     * **enabled** with the default diagrams path
-     * (`docs/src/content/docs/agents/workflows.md`), the default
-     * bundle-path patterns, the hard-requirement phrasing, and both
-     * the starter page and the checker script opt-in.
-     *
-     * Supply `enabled: false` to disable the convention entirely,
-     * `diagramsPath` to move the page, `bundlePathPatterns` to
-     * replace the default pattern list, `emitStarterDiagram: true`
-     * to seed a minimal starter page on disk, `emitChecker: true` to
-     * ship the `.claude/procedures/check-workflow-diagrams.sh`
-     * helper, or `requireDiagramUpdate: false` to soften the rule
-     * phrasing from MUST to SHOULD.
-     *
-     * Malformed configs — empty / whitespace-only or absolute
-     * `diagramsPath`, empty `bundlePathPatterns`, empty /
-     * whitespace-only pattern entry — fail the build at synth time
-     * via `validateWorkflowDiagramsConfig`.
-     *
-     * @see WorkflowDiagramsConfig
-     * @see ./bundles/workflow-diagrams.ts#resolveWorkflowDiagrams
-     * @see ./bundles/workflow-diagrams.ts#validateWorkflowDiagramsConfig
-     * @see ./bundles/workflow-diagrams.ts#renderWorkflowDiagramsRuleContent
-     */
-    readonly workflowDiagrams?: WorkflowDiagramsConfig;
     /**
      * Issue-templates convention consumed by the `base` bundle and
      * every phased-agent bundle that files downstream issues.
@@ -5197,179 +5059,6 @@ declare function renderSkillEvalsBundleHook(se: ResolvedSkillEvals, skillLabel:
  */
 declare function renderSkillEvalsRunnerScript(se: ResolvedSkillEvals): string;
 
-/**
- * Default master switch for the workflow-diagrams convention. When no
- * config is supplied the convention ships **enabled** so every
- * configulator-consuming repo carries the "diagram-touched-when-bundle-
- * touched" rule in its rendered `CLAUDE.md`.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_ENABLED = true;
-/**
- * Default repo-relative path for the workflow-diagrams page. Matches
- * the singleton `/docs` site layout the monorepo contract assumes: a
- * single Starlight docs site at `/docs` with sub-project agent pages
- * under `docs/src/content/docs/agents/`.
- *
- * The file is never generated by configulator (the convention is
- * explicit: diagrams are hand-authored for readability). Consumers
- * opt into the starter stub via `emitStarterDiagram: true`.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_PATH = "docs/src/content/docs/agents/workflows.md";
-/**
- * Default list of glob patterns that identify "bundle files" — the
- * source files whose edits require the workflow-diagrams page to be
- * touched in the same change set.
- *
- * The defaults cover the two canonical locations bundle-like content
- * lives in a configulator-consuming repo:
- *
- * - `packages/@codedrifters/configulator/src/agent/bundles/**.ts` —
- *   the bundle authoring sites inside configulator itself.
- * - `.claude/agents/**.md` / `.claude/skills/**` — agent and skill
- *   prompts in consuming repos that don't re-export configulator
- *   bundles.
- *
- * Consumers can replace the list outright via `bundlePathPatterns`
- * when their agent sources live elsewhere (e.g. a monorepo that keeps
- * agents under `tools/agents/`).
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS: ReadonlyArray<string>;
-/**
- * Default for whether the convention emits a starter workflow-diagrams
- * page to disk at `<diagramsPath>`. Disabled by default because the
- * page is hand-authored — an emitted stub would conflict with
- * existing content on repos adopting the convention late.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER = false;
-/**
- * Default for whether the convention emits the
- * `.claude/procedures/check-workflow-diagrams.sh` checker script. The
- * script walks the staged / changed-file set and fails when a bundle
- * file is touched without the diagrams page being touched too.
- *
- * Disabled by default because many consumers prefer to enforce the
- * rule via review discipline and the rendered documentation alone;
- * the script is opt-in for repos that want a hard CI gate or
- * pre-commit hook.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER = false;
-/**
- * Default for whether the rendered rule body asserts the diagram
- * update as a **hard requirement** vs. a **strong recommendation**.
- * Defaults to `true` — the whole point of the convention is that
- * diagrams stay in sync, so the hard-requirement phrasing is the
- * correct default. Consumers that treat diagrams as aspirational can
- * soften the phrasing by setting this to `false`.
- *
- * @see WorkflowDiagramsConfig
- */
-declare const DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE = true;
-/**
- * Fully-resolved workflow-diagrams settings. Every field is defaulted
- * so downstream renderers can reason about a single canonical shape.
- */
-interface ResolvedWorkflowDiagrams {
-    readonly enabled: boolean;
-    readonly diagramsPath: string;
-    readonly bundlePathPatterns: ReadonlyArray<string>;
-    readonly emitStarterDiagram: boolean;
-    readonly emitChecker: boolean;
-    readonly requireDiagramUpdate: boolean;
-}
-/**
- * Resolve a (possibly absent) `WorkflowDiagramsConfig` into a
- * canonical `ResolvedWorkflowDiagrams` with every field filled in.
- * Unset fields cascade from their documented defaults.
- *
- * Malformed configs — empty / whitespace-only or absolute
- * `diagramsPath`, empty `bundlePathPatterns`, empty /
- * whitespace-only path entry — throw a descriptive `Error`.
- */
-declare function resolveWorkflowDiagrams(config?: WorkflowDiagramsConfig): ResolvedWorkflowDiagrams;
-/**
- * Synth-time validation hook. Throws a descriptive `Error` when the
- * supplied `WorkflowDiagramsConfig` is malformed. Called by
- * `AgentConfig.preSynthesize` before any rendering so a misconfigured
- * convention fails the build instead of silently shipping broken
- * workflow-diagrams guidance. Returns the resolved config unchanged
- * so callers can write
- * `const wd = validateWorkflowDiagramsConfig(config)` in one line.
- *
- * Malformed cases rejected here:
- *
- * - `diagramsPath` empty, whitespace-only, or absolute.
- * - `bundlePathPatterns` not an array, empty, or contains an empty /
- *   whitespace-only entry.
- */
-declare function validateWorkflowDiagramsConfig(config?: WorkflowDiagramsConfig): ResolvedWorkflowDiagrams;
-/**
- * Render the full body for the `workflow-diagrams-convention` rule
- * shipped by the `base` bundle. The rule documents:
- *
- * - Why the convention exists (diagram / prose drift).
- * - The on-disk contract — a single Mermaid-based page at
- *   `<diagramsPath>` with one diagram per agent + a master
- *   cross-agent diagram.
- * - The **diagram-touched-when-bundle-touched** rule, phrased as a
- *   hard requirement or a strong recommendation per
- *   `requireDiagramUpdate`.
- * - The set of paths the rule applies to.
- * - The optional checker script (cross-referenced only when emitted).
- *
- * When the convention is disabled, the rule renders a short stub.
- */
-declare function renderWorkflowDiagramsRuleContent(wd: ResolvedWorkflowDiagrams): string;
-/**
- * Render the short workflow-diagrams hook section injected into a
- * phased-agent bundle's workflow rule. The section cites the full
- * contract documented in the base bundle's
- * `workflow-diagrams-convention` rule so individual bundles stay DRY.
- *
- * When the convention is disabled, the function returns an empty
- * string so callers can no-op their append path.
- */
-declare function renderWorkflowDiagramsBundleHook(wd: ResolvedWorkflowDiagrams, bundleLabel: string): string;
-/**
- * Render a minimal starter workflow-diagrams page — a top-level
- * heading, the master-diagram placeholder, and a single example
- * agent section. Exported so `AgentConfig` can emit it to disk when
- * the consumer opts in via `emitStarterDiagram: true`.
- *
- * The starter is deliberately sparse: it documents the expected
- * structure without committing the consumer to a particular agent
- * list. Repos that already maintain a hand-authored diagrams page
- * should leave `emitStarterDiagram` off — the emission would
- * overwrite their content.
- */
-declare function renderWorkflowDiagramsStarterPage(_wd: ResolvedWorkflowDiagrams): string;
-/**
- * Render the `.claude/procedures/check-workflow-diagrams.sh` helper
- * script. Exported so `AgentConfig` can register it as an
- * `AgentProcedure` when the consumer opts in via `emitChecker: true`.
- *
- * The script accepts the list of changed files as either:
- *
- * 1. Positional arguments (one file per arg).
- * 2. Newline-separated entries on stdin (when no args supplied) —
- *    pipe `git diff --name-only` directly into it.
- *
- * It fails non-zero when any changed file matches a bundle-path
- * pattern and the configured diagrams path is not also in the list.
- * It exits `0` when no bundle files were touched or when the
- * diagrams page was touched alongside them.
- */
-declare function renderWorkflowDiagramsCheckerScript(wd: ResolvedWorkflowDiagrams): string;
-
 /**
  * Build the requirements-analyst bundle with the supplied resolved
  * paths.
@@ -6750,6 +6439,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
@@ -8768,5 +9007,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_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, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SampleLang, StarlightProject, TestRunner, TsDocCoverageKind, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, 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 type { AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiExtractorOptions, ApiExtractorReportOptions, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PreflightMergeMethod, PreflightPrConfig, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueTemplates, ResolvedPreflightPr, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedUnblockDependents, ResolvedWorkflowDiagrams, RunRatioConfig, SampleCompilationFailure, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TsDocCoverageRecord, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, VersionKey, VitestConfigOptions, VitestOptions, WorkflowDiagramsConfig };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AuditCategory, AuditMode, AuditSeverity, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SampleLang, StarlightProject, TestRunner, TsDocCoverageKind, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, vitestBundle };
+export type { AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffFinding, ApiExtractorOptions, ApiExtractorReportOptions, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PreflightMergeMethod, PreflightPrConfig, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueTemplates, ResolvedPreflightPr, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedUnblockDependents, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TsDocCoverageRecord, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, VersionKey, VitestConfigOptions, VitestOptions };