@codedrifters/configulator 0.0.274 → 0.0.275

package/lib/index.d.mts

@@ -6701,6 +6701,556 @@ declare const DEFAULT_SAMPLE_COMPILER_OPTIONS: ts.CompilerOptions;
  */
 declare function compileFencedSamples(options?: CompileFencedSamplesOptions): Array<SampleCompilationFailure>;
 
+/**
+ * Schema definitions for the docs-sync scan-phase audit report.
+ *
+ * The report is the durable output of Phase 1 (Scan) of the docs-sync
+ * pipeline (parent epic #448). Phase 1 walks the repo, runs every
+ * registered drift check, and persists a single combined report to
+ * `.claude/state/docs-sync/<N>-audit.json` (where `<N>` is the
+ * tracking-issue number). Phase 2 (Fix) reads the persisted report
+ * and applies mechanical fixes — the two phases never share an
+ * in-memory handle, so the JSON shape on disk is the contract
+ * between them.
+ *
+ * #518 ships the **schema and the orchestrator skeleton only**. The
+ * actual drift checks (API/TSDoc/reference, link, fenced-sample) are
+ * wired in by children #519 and #520 by passing additional
+ * `AuditCheckRunner` instances to {@link runScan}. An empty
+ * runner list is the supported scaffold-time configuration and
+ * produces a schema-compliant report with empty findings in every
+ * category.
+ *
+ * The schema is intentionally **keyed by drift-check category** at
+ * the top level (`apiDiff`, `tsdocCoverage`, `referenceMismatches`,
+ * `linkFailures`, `sampleFailures`) so consumers can render or
+ * filter by category without re-grouping a flat list. Each
+ * category-keyed array carries category-specific finding shapes,
+ * and a flat `findings` array re-aggregates the same records with
+ * `category` and `severity` fields attached so the report doubles
+ * as a backlog source for downstream tooling.
+ */
+/**
+ * Drift-check categories the docs-sync scan phase can produce
+ * findings in. Exhaustive — adding a new category here is a schema
+ * change that requires bumping {@link DOCS_SYNC_AUDIT_SCHEMA_VERSION}
+ * and updating every consumer that switches on the literal.
+ */
+declare const AuditCategory: {
+    /**
+     * Findings produced by the public-API diff check that surfaces
+     * added, renamed, or removed exports between the current branch
+     * and the recorded baseline. Wired in by child issue #519.
+     */
+    readonly ApiDiff: "apiDiff";
+    /**
+     * Findings produced by the TSDoc-coverage check that flags public
+     * exports without a one-sentence summary. Wired in by child issue
+     * #519.
+     */
+    readonly TsdocCoverage: "tsdocCoverage";
+    /**
+     * Findings produced by the doc-reference cross-index check that
+     * flags inline-code symbol mentions whose target is missing or
+     * has changed. Wired in by child issue #519.
+     */
+    readonly ReferenceMismatches: "referenceMismatches";
+    /**
+     * Findings produced by the link-integrity check (internal via
+     * `astro check`, external via `lychee`). Wired in by child issue
+     * #520.
+     */
+    readonly LinkFailures: "linkFailures";
+    /**
+     * Findings produced by the fenced-sample compilation check that
+     * flags ` ```ts ` / ` ```typescript ` / ` ```tsx ` blocks in the
+     * docs that fail `tsc`. Wired in by child issue #520.
+     */
+    readonly SampleFailures: "sampleFailures";
+};
+/**
+ * String-literal type matching the values of {@link AuditCategory}.
+ */
+type AuditCategory = (typeof AuditCategory)[keyof typeof AuditCategory];
+/**
+ * Severity ladder applied to every finding before persistence. The
+ * ladder mirrors the parent epic's behavior-on-drift contract —
+ * mechanical fixes auto-apply, advisory findings post a non-blocking
+ * note, blocking findings hand off to `pr-reviewer` via
+ * `review:human-required`.
+ */
+declare const AuditSeverity: {
+    /**
+     * The finding has a deterministic mechanical fix that the Phase 2
+     * (Fix) agent will auto-apply (TSDoc stubs, dead-link updates,
+     * registry sync, etc.).
+     */
+    readonly Mechanical: "mechanical";
+    /**
+     * The finding deserves human attention but does not block the PR.
+     * Surfaced as a non-blocking note on the sticky `## Docs sync`
+     * comment.
+     */
+    readonly Advisory: "advisory";
+    /**
+     * The finding blocks the PR. Per the parent epic this is reserved
+     * for the two narrow cases of confirmed broken external links and
+     * fenced TS samples that fail to compile.
+     */
+    readonly Blocking: "blocking";
+};
+/**
+ * String-literal type matching the values of {@link AuditSeverity}.
+ */
+type AuditSeverity = (typeof AuditSeverity)[keyof typeof AuditSeverity];
+/**
+ * Invocation mode of the scan phase. Determines how downstream
+ * tooling treats the report — `pr` reports run against a single
+ * branch and feed `pr-reviewer`; `audit` reports walk the whole
+ * repo and feed the prioritized `docs:write` backlog.
+ */
+declare const AuditMode: {
+    readonly Pr: "pr";
+    readonly Audit: "audit";
+};
+/**
+ * String-literal type matching the values of {@link AuditMode}.
+ */
+type AuditMode = (typeof AuditMode)[keyof typeof AuditMode];
+/**
+ * File-and-line location attached to most finding shapes. The
+ * `file` field is always a path relative to the repo root so reports
+ * are portable across machines; absolute paths must be normalized
+ * before they reach the report.
+ */
+interface AuditLocation {
+    /**
+     * Path relative to {@link AuditReport.repoRoot}. Empty string is
+     * permitted for findings that have no associated file (e.g. an
+     * `apiDiff` removed-export finding that lost its source location).
+     */
+    readonly file: string;
+    /**
+     * 1-indexed line number when known. `0` means "line is not known"
+     * — downstream consumers must treat `0` as missing rather than as
+     * the literal first line.
+     */
+    readonly line: number;
+}
+/**
+ * Common fields every finding shape carries. The category-specific
+ * record types below extend this interface with additional fields.
+ */
+interface AuditFindingBase {
+    /**
+     * Drift-check category that produced the finding. Mirrors the key
+     * on the {@link AuditReport} that the finding is filed under.
+     */
+    readonly category: AuditCategory;
+    /**
+     * Severity classification per the {@link AuditSeverity} ladder.
+     */
+    readonly severity: AuditSeverity;
+    /**
+     * Source location the finding is anchored at. Empty location is
+     * tolerated for findings with no concrete anchor.
+     */
+    readonly location: AuditLocation;
+    /**
+     * Stable subject identifier. For symbol findings this is the
+     * exported symbol name; for link findings the URL; for sample
+     * findings the docPath plus fence index. Used by Phase 2 to
+     * deduplicate findings across runs.
+     */
+    readonly subject: string;
+    /**
+     * One-sentence human-readable description of the finding.
+     * Phase 2 surfaces this directly in the sticky PR comment, so
+     * keep it short and self-contained — no markdown links to
+     * external context, and never includes generated prose over the
+     * 100-word stub budget.
+     */
+    readonly details: string;
+    /**
+     * Optional hint for the Phase 2 fix agent. When present and the
+     * severity is `mechanical`, Phase 2 may use this string to
+     * compute the auto-applied edit. Free-form; downstream consumers
+     * should treat unknown hints as no-op.
+     */
+    readonly fixHint?: string;
+}
+/**
+ * Finding produced by the public-API diff check. Wired in by #519.
+ */
+interface ApiDiffFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.ApiDiff;
+    /**
+     * Kind of API change observed. The literal `added` covers a new
+     * export; `removed` covers a deletion; `changed` covers a
+     * signature change that does not rename or remove the symbol.
+     */
+    readonly change: "added" | "removed" | "changed";
+    /**
+     * Public name of the symbol whose surface changed.
+     */
+    readonly symbol: string;
+}
+/**
+ * Finding produced by the TSDoc-coverage check. Wired in by #519.
+ */
+interface TsdocCoverageFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.TsdocCoverage;
+    /**
+     * Public name of the symbol that is missing or has thin TSDoc.
+     */
+    readonly symbol: string;
+    /**
+     * Coverage shortfall the finding reports. `missing-summary`
+     * means no TSDoc at all; `thin-summary` means the summary exists
+     * but is shorter than the configured threshold; `missing-params`
+     * / `missing-returns` mean the signature has parameters or a
+     * return value with no matching block tag.
+     */
+    readonly shortfall: "missing-summary" | "thin-summary" | "missing-params" | "missing-returns";
+}
+/**
+ * Finding produced by the doc-reference cross-index check. Wired in
+ * by #519.
+ */
+interface ReferenceMismatchFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.ReferenceMismatches;
+    /**
+     * Inline-code symbol referenced in the markdown source.
+     */
+    readonly symbol: string;
+    /**
+     * Why the reference is flagged. `unknown-symbol` means the
+     * symbol does not appear in the supplied known-symbols set;
+     * `signature-changed` means the symbol still resolves but its
+     * type signature differs from the cached snapshot.
+     */
+    readonly mismatch: "unknown-symbol" | "signature-changed";
+}
+/**
+ * Finding produced by the link-integrity check. Wired in by #520.
+ */
+interface LinkFailureFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.LinkFailures;
+    /**
+     * URL or relative path that failed integrity checks.
+     */
+    readonly url: string;
+    /**
+     * Whether the link is internal (resolved by `astro check`) or
+     * external (resolved by `lychee`).
+     */
+    readonly kind: "internal" | "external";
+    /**
+     * Short tool-supplied diagnostic explaining the failure.
+     */
+    readonly reason: string;
+}
+/**
+ * Finding produced by the fenced-sample compilation check. Wired in
+ * by #520.
+ */
+interface SampleFailureFinding extends AuditFindingBase {
+    readonly category: typeof AuditCategory.SampleFailures;
+    /**
+     * 0-indexed position of the fenced block within the markdown file.
+     */
+    readonly fenceIndex: number;
+    /**
+     * Language tag the sample carried (e.g. `ts`, `typescript`,
+     * `tsx`, `typescriptreact`).
+     */
+    readonly lang: string;
+    /**
+     * Compiler diagnostics produced by `tsc` against the sample.
+     */
+    readonly diagnostics: ReadonlyArray<string>;
+}
+/**
+ * Discriminated union of every category-specific finding shape.
+ */
+type AuditFinding = ApiDiffFinding | TsdocCoverageFinding | ReferenceMismatchFinding | LinkFailureFinding | SampleFailureFinding;
+/**
+ * Schema version embedded on every persisted audit report. Bump on
+ * any breaking change to the report shape so downstream consumers
+ * can refuse incompatible files rather than mis-parsing them.
+ *
+ * Versioning is **integer-monotonic**: the producer of a v2 report
+ * is responsible for keeping the v1 fields parseable when
+ * possible, but a v1 reader must reject a v2 report it does not
+ * understand.
+ */
+declare const DOCS_SYNC_AUDIT_SCHEMA_VERSION = 1;
+/**
+ * Top-level audit-report shape persisted to
+ * `.claude/state/docs-sync/<N>-audit.json`. The category-keyed
+ * arrays are the durable surface; the flat `findings` array is a
+ * convenience aggregation of the same records.
+ */
+interface AuditReport {
+    /**
+     * Schema version embedded on every persisted report. Always
+     * equal to {@link DOCS_SYNC_AUDIT_SCHEMA_VERSION} at write time.
+     */
+    readonly schemaVersion: number;
+    /**
+     * Tracking-issue number the scan ran for. Determines the
+     * filename when persisted (`<issueNumber>-audit.json`).
+     */
+    readonly issueNumber: number;
+    /**
+     * Invocation mode — `pr` for diff-scoped runs invoked through
+     * `/docs-sync-pr`, `audit` for full-repo runs invoked through
+     * `/docs-sync-audit`.
+     */
+    readonly mode: AuditMode;
+    /**
+     * ISO 8601 UTC timestamp the scan completed at. Always written
+     * with `Z` suffix; consumers parse with `Date(...)`.
+     */
+    readonly generatedAt: string;
+    /**
+     * Absolute path to the repository root the scan ran against.
+     * Persisted so a downstream consumer reading the report on a
+     * different checkout can rewrite paths relative to its own
+     * root.
+     */
+    readonly repoRoot: string;
+    /**
+     * Optional free-form scope label attached at the issue level
+     * (e.g. `pr:feat/518-foo`, `audit:packages/configulator`).
+     * Empty string when no scope was supplied.
+     */
+    readonly scope: string;
+    /**
+     * Findings grouped by drift-check category. Every category key
+     * is always present and always an array — empty arrays are
+     * persisted explicitly so consumers never have to test for
+     * presence.
+     */
+    readonly categories: {
+        readonly apiDiff: ReadonlyArray<ApiDiffFinding>;
+        readonly tsdocCoverage: ReadonlyArray<TsdocCoverageFinding>;
+        readonly referenceMismatches: ReadonlyArray<ReferenceMismatchFinding>;
+        readonly linkFailures: ReadonlyArray<LinkFailureFinding>;
+        readonly sampleFailures: ReadonlyArray<SampleFailureFinding>;
+    };
+    /**
+     * Flat re-aggregation of every category-keyed finding into a
+     * single deterministically-ordered array. Sorted by `severity`
+     * (`blocking` first, then `advisory`, then `mechanical`), then
+     * `category` (alphabetical), then `location.file`,
+     * `location.line`, `subject`. Provided so consumers that don't
+     * need the category grouping can iterate one array and see the
+     * merge-blocking findings at the top.
+     */
+    readonly findings: ReadonlyArray<AuditFinding>;
+}
+/**
+ * JSON-Schema-shaped descriptor for {@link AuditReport}. Returned by
+ * {@link auditReportJsonSchema} so downstream tooling (e.g. ajv)
+ * can validate persisted reports without re-importing the TS
+ * types. The shape is hand-authored and deliberately permissive on
+ * forward-compatible additions (extra category keys are forbidden;
+ * extra finding fields are permitted).
+ *
+ * Returned as a plain JSON-shaped record — callers that want to
+ * feed it into ajv or another validator pass it through directly.
+ */
+declare function auditReportJsonSchema(): Record<string, unknown>;
+
+/**
+ * Default subdirectory beneath the repo root where audit reports are
+ * persisted. Mirrors the path declared on issue #518's acceptance
+ * criteria: `.claude/state/docs-sync/<N>-audit.json`.
+ */
+declare const DEFAULT_AUDIT_REPORT_DIR = ".claude/state/docs-sync";
+/**
+ * Stable iteration order for category keys. Matches the order they
+ * appear in the persisted report and the order they ran during the
+ * scan (API surface diff first, then TSDoc, then references, then
+ * the docs-only checks). The order is part of the contract — a
+ * consumer that walks `Object.keys(report.categories)` sees this
+ * order on every read.
+ */
+declare const AUDIT_CATEGORY_ORDER: ReadonlyArray<AuditCategory>;
+/**
+ * One drift-check runner. The scan orchestrator invokes each
+ * runner in registration order, collects the findings, and merges
+ * them into the persisted report. Runners are intentionally
+ * synchronous to keep the scaffold simple — children #519 and
+ * #520 may introduce async runners by adding a parallel
+ * `AsyncAuditCheckRunner` shape if needed.
+ *
+ * Runners are pure functions: given the same context they should
+ * produce the same finding list. The scan orchestrator does not
+ * sandbox them — a runner that mutates the filesystem or shells
+ * out is on its own honor.
+ */
+interface AuditCheckRunner {
+    /**
+     * Stable name used in diagnostics and logs. Conventionally
+     * matches the category the runner produces findings in (e.g.
+     * `apiDiff`, `tsdocCoverage`).
+     */
+    readonly name: string;
+    /**
+     * Compute the findings for this check. Runners must return
+     * already-validated finding records — the orchestrator does not
+     * post-process category, severity, or location.
+     */
+    run(context: AuditCheckRunnerContext): ReadonlyArray<AuditFinding>;
+}
+/**
+ * Context passed to every check runner. Carries the same fields
+ * the orchestrator needs to populate the report header so runners
+ * can consult them when computing their findings (e.g. resolve
+ * relative paths against `repoRoot`).
+ */
+interface AuditCheckRunnerContext {
+    readonly repoRoot: string;
+    readonly mode: AuditMode;
+    readonly scope: string;
+    readonly issueNumber: number;
+}
+/**
+ * Options accepted by {@link runScan}.
+ */
+interface RunScanOptions {
+    /**
+     * Absolute path to the repository root the scan runs against.
+     * The audit report's `repoRoot` field is set to this value
+     * verbatim — pass an absolute path so consumers reading the
+     * report on a different checkout can rewrite paths reliably.
+     */
+    readonly repoRoot: string;
+    /**
+     * Tracking-issue number the scan ran for. Determines the
+     * persisted filename (`<issueNumber>-audit.json`).
+     */
+    readonly issueNumber: number;
+    /**
+     * Invocation mode — `pr` for diff-scoped runs, `audit` for
+     * full-repo runs.
+     */
+    readonly mode: AuditMode;
+    /**
+     * Optional free-form scope label. Persisted on the report and
+     * forwarded to every runner. Defaults to the empty string.
+     */
+    readonly scope?: string;
+    /**
+     * Drift-check runners to invoke in order. Empty by default —
+     * #518 ships the orchestrator skeleton without any wired
+     * checks; #519 and #520 plug them in.
+     */
+    readonly checks?: ReadonlyArray<AuditCheckRunner>;
+    /**
+     * Override the timestamp embedded on the report. Used in tests
+     * to make output deterministic. Defaults to `new Date()` at
+     * scan start.
+     */
+    readonly now?: Date;
+    /**
+     * When `true`, persist the report to disk under
+     * `<repoRoot>/<reportDir>/<issueNumber>-audit.json`. When
+     * `false` (the default), the report is returned in memory only.
+     *
+     * @default false
+     */
+    readonly persist?: boolean;
+    /**
+     * Override the directory the report is written to (relative to
+     * {@link RunScanOptions.repoRoot}). Defaults to
+     * {@link DEFAULT_AUDIT_REPORT_DIR}.
+     *
+     * @default ".claude/state/docs-sync"
+     */
+    readonly reportDir?: string;
+}
+/**
+ * Result returned by {@link runScan}. Always carries the report;
+ * `reportPath` is non-empty only when persistence was requested.
+ */
+interface RunScanResult {
+    /**
+     * The report produced by the scan. Schema-compliant whether or
+     * not any checks ran — empty `categories` arrays are persisted
+     * explicitly.
+     */
+    readonly report: AuditReport;
+    /**
+     * Absolute path the report was persisted to. Empty string when
+     * `persist` was `false`.
+     */
+    readonly reportPath: string;
+}
+/**
+ * Run the docs-sync scan phase. Invokes every registered check
+ * runner in order, merges the findings into a single
+ * schema-compliant {@link AuditReport}, and optionally persists
+ * the report to `<repoRoot>/<reportDir>/<issueNumber>-audit.json`.
+ *
+ * #518 ships this function with an **empty default check list**:
+ * invoking `runScan({ repoRoot, issueNumber, mode: "pr" })`
+ * produces a report whose `findings` and per-category arrays are
+ * all empty. Children #519 and #520 register the real checks by
+ * passing them via the `checks` option.
+ */
+declare function runScan(options: RunScanOptions): RunScanResult;
+/**
+ * Compute the final {@link AuditReport} from a flat list of
+ * findings. Group by category, sort each bucket deterministically,
+ * and produce the flat `findings` aggregation in the documented
+ * order. Exported so #519 / #520 can build reports incrementally
+ * without re-running the whole scan.
+ */
+declare function buildReport(args: {
+    readonly issueNumber: number;
+    readonly mode: AuditMode;
+    readonly scope: string;
+    readonly repoRoot: string;
+    readonly generatedAt: Date;
+    readonly findings: ReadonlyArray<AuditFinding>;
+}): AuditReport;
+/**
+ * Persist an {@link AuditReport} to disk. The directory is created
+ * recursively when missing; the file is written atomically via a
+ * temp-file + rename so a partial write never produces a corrupt
+ * report.
+ */
+declare function persistAuditReport(args: {
+    readonly report: AuditReport;
+    readonly repoRoot: string;
+    readonly reportDir?: string;
+}): string;
+/**
+ * Build an empty {@link AuditReport.categories} record with every
+ * key explicitly set to an empty array. Exported so callers that
+ * stub the report shape in tests don't have to repeat the keys.
+ */
+declare function emptyCategoryBuckets(): {
+    apiDiff: Array<AuditFinding & {
+        category: typeof AuditCategory.ApiDiff;
+    }>;
+    tsdocCoverage: Array<AuditFinding & {
+        category: typeof AuditCategory.TsdocCoverage;
+    }>;
+    referenceMismatches: Array<AuditFinding & {
+        category: typeof AuditCategory.ReferenceMismatches;
+    }>;
+    linkFailures: Array<AuditFinding & {
+        category: typeof AuditCategory.LinkFailures;
+    }>;
+    sampleFailures: Array<AuditFinding & {
+        category: typeof AuditCategory.SampleFailures;
+    }>;
+};
+
 /**
  * One row in the TSDoc-coverage report — describes a single public
  * symbol exported (transitively) from the package's entry point and
@@ -8719,4 +9269,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AgentConfig, type AgentConfigOptions, type AgentExpansionRules, type AgentFeaturesConfig, type AgentModel, type AgentPathsConfig, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type AgentTier, type AgentTierConfig, type AgentTierEntry, type AnalyzeTsDocCoverageOptions, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CompileFencedSamplesOptions, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER, DEFAULT_WORKFLOW_DIAGRAMS_ENABLED, DEFAULT_WORKFLOW_DIAGRAMS_PATH, DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PreflightMergeMethod, type PreflightPrConfig, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueTemplates, type ResolvedPreflightPr, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedUnblockDependents, type ResolvedWorkflowDiagrams, type RunRatioConfig, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, type SampleCompilationFailure, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, type WorkflowDiagramsConfig, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, renderWorkflowDiagramsBundleHook, renderWorkflowDiagramsCheckerScript, renderWorkflowDiagramsRuleContent, renderWorkflowDiagramsStarterPage, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, resolveWorkflowDiagrams, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, validateWorkflowDiagramsConfig, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, type AgentConfigOptions, type AgentExpansionRules, type AgentFeaturesConfig, type AgentModel, type AgentPathsConfig, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type AgentTier, type AgentTierConfig, type AgentTierEntry, type AnalyzeTsDocCoverageOptions, type ApiDiffFinding, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, AuditCategory, type AuditCheckRunner, type AuditCheckRunnerContext, type AuditFinding, type AuditFindingBase, type AuditLocation, AuditMode, type AuditReport, AuditSeverity, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CompileFencedSamplesOptions, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER, DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER, DEFAULT_WORKFLOW_DIAGRAMS_ENABLED, DEFAULT_WORKFLOW_DIAGRAMS_PATH, DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE, DOCS_SYNC_AUDIT_SCHEMA_VERSION, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, type LinkFailureFinding, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PreflightMergeMethod, type PreflightPrConfig, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type ReferenceMismatchFinding, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueTemplates, type ResolvedPreflightPr, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedUnblockDependents, type ResolvedWorkflowDiagrams, type RunRatioConfig, type RunScanOptions, type RunScanResult, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, type SampleCompilationFailure, type SampleFailureFinding, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, type TsdocCoverageFinding, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, type WorkflowDiagramsConfig, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, customerProfileBundle, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPreflightPrSection, renderPreflightPrShellHelpers, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderUnblockDependentsScript, renderUnblockDependentsSection, renderWorkflowDiagramsBundleHook, renderWorkflowDiagramsCheckerScript, renderWorkflowDiagramsRuleContent, renderWorkflowDiagramsStarterPage, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolvePreflightPr, resolveProgressFiles, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTypeScriptProjectOutdir, resolveUnblockDependents, resolveWorkflowDiagrams, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, validateWorkflowDiagramsConfig, vitestBundle };