@codedrifters/configulator 0.0.274 → 0.0.275

package/lib/index.d.ts

@@ -6750,6 +6750,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 +9318,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, DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER, DEFAULT_WORKFLOW_DIAGRAMS_ENABLED, DEFAULT_WORKFLOW_DIAGRAMS_PATH, DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SampleLang, StarlightProject, TestRunner, TsDocCoverageKind, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, renderWorkflowDiagramsBundleHook, renderWorkflowDiagramsCheckerScript, renderWorkflowDiagramsRuleContent, renderWorkflowDiagramsStarterPage, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, resolveWorkflowDiagrams, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, validateWorkflowDiagramsConfig, vitestBundle };
+export type { AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffFinding, ApiExtractorOptions, ApiExtractorReportOptions, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PreflightMergeMethod, PreflightPrConfig, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueTemplates, ResolvedPreflightPr, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedUnblockDependents, ResolvedWorkflowDiagrams, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TsDocCoverageRecord, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, VersionKey, VitestConfigOptions, VitestOptions, WorkflowDiagramsConfig };