@codedrifters/configulator 0.0.275 → 0.0.277

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.d.mts CHANGED
@@ -464,6 +464,13 @@ declare const DEFAULT_STATUS_LABELS: ReadonlyArray<LabelDefinition>;
464
464
  declare const DEFAULT_PRIORITY_LABELS: ReadonlyArray<LabelDefinition>;
465
465
  /** Default type labels — one per conventional commit type. */
466
466
  declare const DEFAULT_TYPE_LABELS: ReadonlyArray<LabelDefinition>;
467
+ /**
468
+ * Hard limit GitHub's Labels API enforces on the `description` field.
469
+ * EndBug/label-sync rejects (and the API returns an opaque error for)
470
+ * any label whose description exceeds this length, which silently
471
+ * breaks the sync workflow downstream.
472
+ */
473
+ declare const MAX_LABEL_DESCRIPTION_LENGTH = 100;
467
474
  /**
468
475
  * Adds a labels config file and a GitHub Actions workflow that syncs
469
476
  * labels to the repository using EndBug/label-sync.
@@ -2226,117 +2233,6 @@ interface SkillEvalsConfig {
2226
2233
  */
2227
2234
  readonly emitRunner?: boolean;
2228
2235
  }
2229
- /*******************************************************************************
2230
- *
2231
- * Workflow Diagrams Config
2232
- *
2233
- ******************************************************************************/
2234
- /**
2235
- * Workflow-diagrams convention consumed by the `base` bundle and
2236
- * every phased-agent bundle. Documents the single hand-authored
2237
- * Mermaid-based diagrams page that visualises every agent's phase
2238
- * graph and every cross-agent handoff, and enforces the
2239
- * **diagram-touched-when-bundle-touched** rule: a change set that
2240
- * modifies a bundle's phase graph must also update the matching
2241
- * section in the diagrams page.
2242
- *
2243
- * The convention is deliberately content-free — configulator cannot
2244
- * ship meaningful diagrams because each consuming repo enables a
2245
- * different subset of bundles and customises agent labels, paths,
2246
- * and taxonomies via the Group A injection points. Instead the
2247
- * bundle renders the rule (what to author, when to update it) and
2248
- * optionally emits a starter page + a checker script.
2249
- *
2250
- * Every field is optional. When the whole config is absent the
2251
- * convention ships **enabled** with the documented default diagrams
2252
- * path (`docs/src/content/docs/agents/workflows.md`), the default
2253
- * bundle-path patterns, the hard-requirement phrasing, the starter
2254
- * page opt-in, and the checker script opt-in.
2255
- *
2256
- * Malformed configs — empty / whitespace-only or absolute
2257
- * `diagramsPath`, empty `bundlePathPatterns`, empty /
2258
- * whitespace-only pattern entry — fail the build at synth time via
2259
- * `validateWorkflowDiagramsConfig`.
2260
- *
2261
- * @see ./bundles/workflow-diagrams.ts#resolveWorkflowDiagrams
2262
- * @see ./bundles/workflow-diagrams.ts#validateWorkflowDiagramsConfig
2263
- * @see ./bundles/workflow-diagrams.ts#renderWorkflowDiagramsRuleContent
2264
- */
2265
- interface WorkflowDiagramsConfig {
2266
- /**
2267
- * Master switch for the workflow-diagrams convention. When `false`,
2268
- * the base bundle renders a short stub stating the project does not
2269
- * enforce the convention; phased-agent bundles skip the
2270
- * per-workflow "Workflow Diagram" injection and the optional helper
2271
- * script / starter page are not emitted even if their `emit*`
2272
- * flags are true.
2273
- *
2274
- * Defaults to `true` — the convention is on by default.
2275
- */
2276
- readonly enabled?: boolean;
2277
- /**
2278
- * Repo-relative path to the single workflow-diagrams page. The
2279
- * rendered rule cites this path as the on-disk home of every
2280
- * Mermaid diagram; the checker script uses it as the sentinel path
2281
- * that must appear in a change set when any bundle file is
2282
- * touched.
2283
- *
2284
- * Must be a non-empty relative path (no leading `/`).
2285
- *
2286
- * Defaults to `docs/src/content/docs/agents/workflows.md`, which
2287
- * matches the monorepo-wide singleton `/docs` Starlight site every
2288
- * configulator-managed repo ships.
2289
- */
2290
- readonly diagramsPath?: string;
2291
- /**
2292
- * Path patterns (bash-style globs) that identify "bundle files" —
2293
- * the source files whose edits require the workflow-diagrams page
2294
- * to be touched in the same change set. Rendered verbatim into
2295
- * the rule body as a bullet list and emitted into the checker
2296
- * script when `emitChecker: true`.
2297
- *
2298
- * Must be a non-empty array of non-empty strings.
2299
- *
2300
- * Defaults to the configulator-wide set covering in-tree bundle
2301
- * source files, `.claude/agents/**.md` agent prompts, and
2302
- * `.claude/skills/**.md` skill prompts.
2303
- */
2304
- readonly bundlePathPatterns?: ReadonlyArray<string>;
2305
- /**
2306
- * Whether the convention emits a minimal starter diagrams page to
2307
- * disk at `<diagramsPath>`. The starter carries the expected
2308
- * structure (master diagram placeholder, one example agent section,
2309
- * legend) so consumers adopting the convention on a green-field
2310
- * repo have a working template to extend.
2311
- *
2312
- * Disabled by default because the page is hand-authored — an
2313
- * emitted stub would conflict with existing content on repos
2314
- * adopting the convention late.
2315
- */
2316
- readonly emitStarterDiagram?: boolean;
2317
- /**
2318
- * Whether the convention emits the
2319
- * `.claude/procedures/check-workflow-diagrams.sh` helper to disk.
2320
- * The script walks a newline-separated list of changed files (from
2321
- * stdin or positional arguments) and fails non-zero when any file
2322
- * matches a bundle-path pattern but `<diagramsPath>` is not also
2323
- * in the list.
2324
- *
2325
- * Disabled by default — the helper is opt-in for repos that want a
2326
- * hard CI gate or pre-commit hook. Consumers that prefer to
2327
- * enforce the rule via review discipline alone can leave it off.
2328
- */
2329
- readonly emitChecker?: boolean;
2330
- /**
2331
- * Whether the rendered rule body phrases the diagram update as a
2332
- * **hard requirement** (`MUST`) or a **strong recommendation**
2333
- * (`SHOULD`). Defaults to `true` — the hard-requirement phrasing
2334
- * matches the "enforced via CI" posture the convention is
2335
- * designed for. Consumers that treat diagrams as aspirational can
2336
- * soften the phrasing by setting this to `false`.
2337
- */
2338
- readonly requireDiagramUpdate?: boolean;
2339
- }
2340
2236
  /*******************************************************************************
2341
2237
  *
2342
2238
  * Issue Templates Config
@@ -3028,40 +2924,6 @@ interface AgentConfigOptions {
3028
2924
  * @see ./bundles/skill-evals.ts#renderSkillEvalsRuleContent
3029
2925
  */
3030
2926
  readonly skillEvals?: SkillEvalsConfig;
3031
- /**
3032
- * Workflow-diagrams convention consumed by the `base` bundle and
3033
- * every phased-agent bundle. Documents the single hand-authored
3034
- * Mermaid-based diagrams page that visualises every agent's phase
3035
- * graph and every cross-agent handoff, and enforces the
3036
- * diagram-touched-when-bundle-touched rule: a change set that
3037
- * modifies a bundle's phase graph must also update the matching
3038
- * section in the diagrams page.
3039
- *
3040
- * When the whole config is omitted, the convention ships
3041
- * **enabled** with the default diagrams path
3042
- * (`docs/src/content/docs/agents/workflows.md`), the default
3043
- * bundle-path patterns, the hard-requirement phrasing, and both
3044
- * the starter page and the checker script opt-in.
3045
- *
3046
- * Supply `enabled: false` to disable the convention entirely,
3047
- * `diagramsPath` to move the page, `bundlePathPatterns` to
3048
- * replace the default pattern list, `emitStarterDiagram: true`
3049
- * to seed a minimal starter page on disk, `emitChecker: true` to
3050
- * ship the `.claude/procedures/check-workflow-diagrams.sh`
3051
- * helper, or `requireDiagramUpdate: false` to soften the rule
3052
- * phrasing from MUST to SHOULD.
3053
- *
3054
- * Malformed configs — empty / whitespace-only or absolute
3055
- * `diagramsPath`, empty `bundlePathPatterns`, empty /
3056
- * whitespace-only pattern entry — fail the build at synth time
3057
- * via `validateWorkflowDiagramsConfig`.
3058
- *
3059
- * @see WorkflowDiagramsConfig
3060
- * @see ./bundles/workflow-diagrams.ts#resolveWorkflowDiagrams
3061
- * @see ./bundles/workflow-diagrams.ts#validateWorkflowDiagramsConfig
3062
- * @see ./bundles/workflow-diagrams.ts#renderWorkflowDiagramsRuleContent
3063
- */
3064
- readonly workflowDiagrams?: WorkflowDiagramsConfig;
3065
2927
  /**
3066
2928
  * Issue-templates convention consumed by the `base` bundle and
3067
2929
  * every phased-agent bundle that files downstream issues.
@@ -5148,179 +5010,6 @@ declare function renderSkillEvalsBundleHook(se: ResolvedSkillEvals, skillLabel:
5148
5010
  */
5149
5011
  declare function renderSkillEvalsRunnerScript(se: ResolvedSkillEvals): string;
5150
5012
 
5151
- /**
5152
- * Default master switch for the workflow-diagrams convention. When no
5153
- * config is supplied the convention ships **enabled** so every
5154
- * configulator-consuming repo carries the "diagram-touched-when-bundle-
5155
- * touched" rule in its rendered `CLAUDE.md`.
5156
- *
5157
- * @see WorkflowDiagramsConfig
5158
- */
5159
- declare const DEFAULT_WORKFLOW_DIAGRAMS_ENABLED = true;
5160
- /**
5161
- * Default repo-relative path for the workflow-diagrams page. Matches
5162
- * the singleton `/docs` site layout the monorepo contract assumes: a
5163
- * single Starlight docs site at `/docs` with sub-project agent pages
5164
- * under `docs/src/content/docs/agents/`.
5165
- *
5166
- * The file is never generated by configulator (the convention is
5167
- * explicit: diagrams are hand-authored for readability). Consumers
5168
- * opt into the starter stub via `emitStarterDiagram: true`.
5169
- *
5170
- * @see WorkflowDiagramsConfig
5171
- */
5172
- declare const DEFAULT_WORKFLOW_DIAGRAMS_PATH = "docs/src/content/docs/agents/workflows.md";
5173
- /**
5174
- * Default list of glob patterns that identify "bundle files" — the
5175
- * source files whose edits require the workflow-diagrams page to be
5176
- * touched in the same change set.
5177
- *
5178
- * The defaults cover the two canonical locations bundle-like content
5179
- * lives in a configulator-consuming repo:
5180
- *
5181
- * - `packages/@codedrifters/configulator/src/agent/bundles/**.ts` —
5182
- * the bundle authoring sites inside configulator itself.
5183
- * - `.claude/agents/**.md` / `.claude/skills/**` — agent and skill
5184
- * prompts in consuming repos that don't re-export configulator
5185
- * bundles.
5186
- *
5187
- * Consumers can replace the list outright via `bundlePathPatterns`
5188
- * when their agent sources live elsewhere (e.g. a monorepo that keeps
5189
- * agents under `tools/agents/`).
5190
- *
5191
- * @see WorkflowDiagramsConfig
5192
- */
5193
- declare const DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS: ReadonlyArray<string>;
5194
- /**
5195
- * Default for whether the convention emits a starter workflow-diagrams
5196
- * page to disk at `<diagramsPath>`. Disabled by default because the
5197
- * page is hand-authored — an emitted stub would conflict with
5198
- * existing content on repos adopting the convention late.
5199
- *
5200
- * @see WorkflowDiagramsConfig
5201
- */
5202
- declare const DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER = false;
5203
- /**
5204
- * Default for whether the convention emits the
5205
- * `.claude/procedures/check-workflow-diagrams.sh` checker script. The
5206
- * script walks the staged / changed-file set and fails when a bundle
5207
- * file is touched without the diagrams page being touched too.
5208
- *
5209
- * Disabled by default because many consumers prefer to enforce the
5210
- * rule via review discipline and the rendered documentation alone;
5211
- * the script is opt-in for repos that want a hard CI gate or
5212
- * pre-commit hook.
5213
- *
5214
- * @see WorkflowDiagramsConfig
5215
- */
5216
- declare const DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER = false;
5217
- /**
5218
- * Default for whether the rendered rule body asserts the diagram
5219
- * update as a **hard requirement** vs. a **strong recommendation**.
5220
- * Defaults to `true` — the whole point of the convention is that
5221
- * diagrams stay in sync, so the hard-requirement phrasing is the
5222
- * correct default. Consumers that treat diagrams as aspirational can
5223
- * soften the phrasing by setting this to `false`.
5224
- *
5225
- * @see WorkflowDiagramsConfig
5226
- */
5227
- declare const DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE = true;
5228
- /**
5229
- * Fully-resolved workflow-diagrams settings. Every field is defaulted
5230
- * so downstream renderers can reason about a single canonical shape.
5231
- */
5232
- interface ResolvedWorkflowDiagrams {
5233
- readonly enabled: boolean;
5234
- readonly diagramsPath: string;
5235
- readonly bundlePathPatterns: ReadonlyArray<string>;
5236
- readonly emitStarterDiagram: boolean;
5237
- readonly emitChecker: boolean;
5238
- readonly requireDiagramUpdate: boolean;
5239
- }
5240
- /**
5241
- * Resolve a (possibly absent) `WorkflowDiagramsConfig` into a
5242
- * canonical `ResolvedWorkflowDiagrams` with every field filled in.
5243
- * Unset fields cascade from their documented defaults.
5244
- *
5245
- * Malformed configs — empty / whitespace-only or absolute
5246
- * `diagramsPath`, empty `bundlePathPatterns`, empty /
5247
- * whitespace-only path entry — throw a descriptive `Error`.
5248
- */
5249
- declare function resolveWorkflowDiagrams(config?: WorkflowDiagramsConfig): ResolvedWorkflowDiagrams;
5250
- /**
5251
- * Synth-time validation hook. Throws a descriptive `Error` when the
5252
- * supplied `WorkflowDiagramsConfig` is malformed. Called by
5253
- * `AgentConfig.preSynthesize` before any rendering so a misconfigured
5254
- * convention fails the build instead of silently shipping broken
5255
- * workflow-diagrams guidance. Returns the resolved config unchanged
5256
- * so callers can write
5257
- * `const wd = validateWorkflowDiagramsConfig(config)` in one line.
5258
- *
5259
- * Malformed cases rejected here:
5260
- *
5261
- * - `diagramsPath` empty, whitespace-only, or absolute.
5262
- * - `bundlePathPatterns` not an array, empty, or contains an empty /
5263
- * whitespace-only entry.
5264
- */
5265
- declare function validateWorkflowDiagramsConfig(config?: WorkflowDiagramsConfig): ResolvedWorkflowDiagrams;
5266
- /**
5267
- * Render the full body for the `workflow-diagrams-convention` rule
5268
- * shipped by the `base` bundle. The rule documents:
5269
- *
5270
- * - Why the convention exists (diagram / prose drift).
5271
- * - The on-disk contract — a single Mermaid-based page at
5272
- * `<diagramsPath>` with one diagram per agent + a master
5273
- * cross-agent diagram.
5274
- * - The **diagram-touched-when-bundle-touched** rule, phrased as a
5275
- * hard requirement or a strong recommendation per
5276
- * `requireDiagramUpdate`.
5277
- * - The set of paths the rule applies to.
5278
- * - The optional checker script (cross-referenced only when emitted).
5279
- *
5280
- * When the convention is disabled, the rule renders a short stub.
5281
- */
5282
- declare function renderWorkflowDiagramsRuleContent(wd: ResolvedWorkflowDiagrams): string;
5283
- /**
5284
- * Render the short workflow-diagrams hook section injected into a
5285
- * phased-agent bundle's workflow rule. The section cites the full
5286
- * contract documented in the base bundle's
5287
- * `workflow-diagrams-convention` rule so individual bundles stay DRY.
5288
- *
5289
- * When the convention is disabled, the function returns an empty
5290
- * string so callers can no-op their append path.
5291
- */
5292
- declare function renderWorkflowDiagramsBundleHook(wd: ResolvedWorkflowDiagrams, bundleLabel: string): string;
5293
- /**
5294
- * Render a minimal starter workflow-diagrams page — a top-level
5295
- * heading, the master-diagram placeholder, and a single example
5296
- * agent section. Exported so `AgentConfig` can emit it to disk when
5297
- * the consumer opts in via `emitStarterDiagram: true`.
5298
- *
5299
- * The starter is deliberately sparse: it documents the expected
5300
- * structure without committing the consumer to a particular agent
5301
- * list. Repos that already maintain a hand-authored diagrams page
5302
- * should leave `emitStarterDiagram` off — the emission would
5303
- * overwrite their content.
5304
- */
5305
- declare function renderWorkflowDiagramsStarterPage(_wd: ResolvedWorkflowDiagrams): string;
5306
- /**
5307
- * Render the `.claude/procedures/check-workflow-diagrams.sh` helper
5308
- * script. Exported so `AgentConfig` can register it as an
5309
- * `AgentProcedure` when the consumer opts in via `emitChecker: true`.
5310
- *
5311
- * The script accepts the list of changed files as either:
5312
- *
5313
- * 1. Positional arguments (one file per arg).
5314
- * 2. Newline-separated entries on stdin (when no args supplied) —
5315
- * pipe `git diff --name-only` directly into it.
5316
- *
5317
- * It fails non-zero when any changed file matches a bundle-path
5318
- * pattern and the configured diagrams path is not also in the list.
5319
- * It exits `0` when no bundle files were touched or when the
5320
- * diagrams page was touched alongside them.
5321
- */
5322
- declare function renderWorkflowDiagramsCheckerScript(wd: ResolvedWorkflowDiagrams): string;
5323
-
5324
5013
  /**
5325
5014
  * Build the requirements-analyst bundle with the supplied resolved
5326
5015
  * paths.
@@ -7251,6 +6940,196 @@ declare function emptyCategoryBuckets(): {
7251
6940
  }>;
7252
6941
  };
7253
6942
 
6943
+ /**
6944
+ * One public export parsed out of an `.api.md` rollup. The signature
6945
+ * is the verbatim declaration text from the rollup (TypeScript
6946
+ * declaration form), with internal whitespace normalized to single
6947
+ * spaces so cosmetic re-formatting between runs does not surface as
6948
+ * a `changed` finding.
6949
+ */
6950
+ interface ApiSurfaceEntry {
6951
+ /**
6952
+ * Public name of the export (function name, class name, etc.).
6953
+ */
6954
+ readonly name: string;
6955
+ /**
6956
+ * Verbatim declaration line from the rollup with whitespace
6957
+ * collapsed. Used as the equality comparison for `added` /
6958
+ * `removed` / `changed` classification.
6959
+ */
6960
+ readonly signature: string;
6961
+ }
6962
+ /**
6963
+ * Result of diffing a baseline rollup against a current rollup. Each
6964
+ * field carries the API entries that fall into that change bucket.
6965
+ * Used by {@link createApiDiffCheck} to emit one finding per entry,
6966
+ * but exported separately so callers that want to render or
6967
+ * post-process the diff outside the audit-report shape can.
6968
+ */
6969
+ interface ApiDiffResult {
6970
+ /** Exports present in the current rollup but not the baseline. */
6971
+ readonly added: ReadonlyArray<ApiSurfaceEntry>;
6972
+ /** Exports present in the baseline but not the current rollup. */
6973
+ readonly removed: ReadonlyArray<ApiSurfaceEntry>;
6974
+ /**
6975
+ * Exports present in both rollups but whose declaration text
6976
+ * differs (signature change, type-parameter change, etc.). The
6977
+ * carried entry is the **current** rollup's view of the symbol so
6978
+ * downstream consumers can show the new signature.
6979
+ */
6980
+ readonly changed: ReadonlyArray<ApiSurfaceEntry>;
6981
+ }
6982
+ /**
6983
+ * Options accepted by {@link createApiDiffCheck}. The runner
6984
+ * consumes already-fetched rollup contents — the orchestrator is
6985
+ * responsible for running the `extract-api.sh` helper against the
6986
+ * current ref and against the configured baseline ref before
6987
+ * dispatching to the runner. Passing the rollups in as strings keeps
6988
+ * tests cheap (inline fixtures) and lets the same runner shape
6989
+ * cover the audit-mode case where the baseline is an empty rollup
6990
+ * (every export shows up as `added`).
6991
+ */
6992
+ interface ApiDiffCheckOptions {
6993
+ /**
6994
+ * Verbatim contents of the `.api.md` rollup the orchestrator
6995
+ * extracted against the **baseline** ref (typically `origin/main`
6996
+ * for `pr` mode or empty for `audit` mode). May be the empty
6997
+ * string when no baseline is available — every current export
6998
+ * then surfaces as `added`.
6999
+ */
7000
+ readonly baselineRollup: string;
7001
+ /**
7002
+ * Verbatim contents of the `.api.md` rollup the orchestrator
7003
+ * extracted against the **current** ref (the working tree the
7004
+ * scan is running over).
7005
+ */
7006
+ readonly currentRollup: string;
7007
+ /**
7008
+ * Path attached to every finding's `location.file`. Conventionally
7009
+ * the path to the `.api.md` file relative to the repo root (e.g.
7010
+ * `packages/@codedrifters/configulator/.api-extractor/configulator.api.md`)
7011
+ * so consumers can jump from a finding back to the source rollup.
7012
+ * Defaults to the empty string, meaning the finding has no
7013
+ * concrete file anchor.
7014
+ *
7015
+ * @default ""
7016
+ */
7017
+ readonly rollupPath?: string;
7018
+ /**
7019
+ * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
7020
+ * to `"apiDiff"` so logs match the audit-report category key.
7021
+ *
7022
+ * @default "apiDiff"
7023
+ */
7024
+ readonly name?: string;
7025
+ }
7026
+ /**
7027
+ * Parse a `.api.md` rollup into the set of public-API entries it
7028
+ * declares. The parser is intentionally line-oriented and tolerant
7029
+ * of api-extractor's exact formatting:
7030
+ *
7031
+ * 1. Find the first fenced `ts` code block (api-extractor wraps the
7032
+ * rollup in one). Lines outside the block are ignored.
7033
+ * 2. Walk the block linewise. Every line that begins with `export`
7034
+ * is the start of a declaration; subsequent lines that do not
7035
+ * begin with `export`, `//`, `}`, or `import` are appended until
7036
+ * a terminator (`;`, top-level `}`) closes the declaration.
7037
+ * 3. Extract the public name from the start of the declaration —
7038
+ * the first identifier after `export {function|class|interface|...}`
7039
+ * (or the first name in an `export { A, B }` clause).
7040
+ * 4. Normalize whitespace inside the captured signature to a single
7041
+ * space so re-flowing the rollup does not produce spurious
7042
+ * `changed` findings.
7043
+ *
7044
+ * Lines containing only `// @public`, `// @beta`, etc. are stripped
7045
+ * — they are release-tag annotations the extractor emits, and they
7046
+ * change independently of the signature itself.
7047
+ */
7048
+ declare function parseApiRollup(rollup: string): ReadonlyArray<ApiSurfaceEntry>;
7049
+ /**
7050
+ * Diff a baseline rollup against a current rollup and bucket every
7051
+ * public export into `added`, `removed`, or `changed`. Exported so
7052
+ * callers can compute the diff without going through the runner
7053
+ * shape.
7054
+ */
7055
+ declare function diffApiRollups(baselineRollup: string, currentRollup: string): ApiDiffResult;
7056
+ /**
7057
+ * Build an {@link AuditCheckRunner} that emits API-diff findings by
7058
+ * comparing a baseline rollup to a current rollup. Severity mapping
7059
+ * (per the parent epic's drift-handling matrix):
7060
+ *
7061
+ * - **added** — `mechanical`. A new public export is purely
7062
+ * additive; Phase 2 can stub TSDoc and add reference-doc rows
7063
+ * without human input.
7064
+ * - **removed** — `advisory`. A removed public export likely needs
7065
+ * a deprecation note in prose; Phase 2 cannot mechanically rewrite
7066
+ * conceptual prose.
7067
+ * - **changed** — `advisory`. A signature change may invalidate
7068
+ * inline-code references in docs and warrants human review of any
7069
+ * surrounding prose.
7070
+ */
7071
+ declare function createApiDiffCheck(options: ApiDiffCheckOptions): AuditCheckRunner;
7072
+
7073
+ /**
7074
+ * Options accepted by {@link createReferenceMismatchCheck}.
7075
+ *
7076
+ * The runner consumes already-computed reference records produced by
7077
+ * `extractDocReferences()`. The factory deliberately does not invoke
7078
+ * the extractor — that keeps the runner cheap to test with inline
7079
+ * fixtures and lets the orchestrator extract references once and
7080
+ * feed multiple checks from the same input.
7081
+ */
7082
+ interface ReferenceMismatchCheckOptions {
7083
+ /**
7084
+ * The reference records to translate into findings. Each record
7085
+ * carries the `isKnown` flag the extractor computed against the
7086
+ * supplied known-symbols set; the runner produces a finding for
7087
+ * every record where `isKnown` is `false`.
7088
+ */
7089
+ readonly records: ReadonlyArray<DocReferenceRecord>;
7090
+ /**
7091
+ * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
7092
+ * to `"referenceMismatches"` so logs match the audit-report
7093
+ * category key.
7094
+ *
7095
+ * @default "referenceMismatches"
7096
+ */
7097
+ readonly name?: string;
7098
+ /**
7099
+ * Optional set of symbols whose signature changed between the
7100
+ * baseline and the current revision. References to one of these
7101
+ * symbols produce a `signature-changed` finding rather than the
7102
+ * default `unknown-symbol` finding (the symbol resolves but its
7103
+ * type signature differs from the cached snapshot, per the
7104
+ * audit-report schema). Empty / omitted means no signature-change
7105
+ * findings are produced.
7106
+ */
7107
+ readonly signatureChangedSymbols?: ReadonlyArray<string>;
7108
+ }
7109
+ /**
7110
+ * Map a single {@link DocReferenceRecord} to zero or one audit
7111
+ * findings. Exported so callers can reuse the record-to-finding
7112
+ * mapping without going through a runner.
7113
+ *
7114
+ * Severity mapping:
7115
+ *
7116
+ * - `unknown-symbol` (record carries `isKnown: false`) — `advisory`.
7117
+ * The doc mentions a symbol that does not appear in the supplied
7118
+ * known-symbols set; a human reviewer should rename the mention or
7119
+ * remove it. The matching `signature-changed` case only fires when
7120
+ * the caller passes the symbol via `signatureChangedSymbols`.
7121
+ * - Records with `isKnown: true` and no signature change produce no
7122
+ * findings.
7123
+ */
7124
+ declare function referenceRecordToFinding(record: DocReferenceRecord, signatureChangedSymbols: ReadonlySet<string>): ReferenceMismatchFinding | undefined;
7125
+ /**
7126
+ * Build an {@link AuditCheckRunner} that emits doc-reference
7127
+ * mismatch findings from a precomputed list of
7128
+ * {@link DocReferenceRecord}. The runner is synchronous and
7129
+ * idempotent — calling `run()` twice produces identical findings.
7130
+ */
7131
+ declare function createReferenceMismatchCheck(options: ReferenceMismatchCheckOptions): AuditCheckRunner;
7132
+
7254
7133
  /**
7255
7134
  * One row in the TSDoc-coverage report — describes a single public
7256
7135
  * symbol exported (transitively) from the package's entry point and
@@ -7370,6 +7249,59 @@ interface AnalyzeTsDocCoverageOptions {
7370
7249
  */
7371
7250
  declare function analyzeTsDocCoverage(options: AnalyzeTsDocCoverageOptions | string): Array<TsDocCoverageRecord>;
7372
7251
 
7252
+ /**
7253
+ * Options accepted by {@link createTsdocCoverageCheck}.
7254
+ *
7255
+ * The runner consumes already-computed coverage records produced by
7256
+ * `analyzeTsDocCoverage()`. The factory deliberately does not invoke
7257
+ * the analyzer itself — that keeps the runner cheap to test (pass an
7258
+ * inline records array) and keeps the orchestrator free to compute
7259
+ * coverage once and feed multiple checks from the same input.
7260
+ */
7261
+ interface TsdocCoverageCheckOptions {
7262
+ /**
7263
+ * The coverage records to translate into findings. Typically the
7264
+ * concatenated output of `analyzeTsDocCoverage()` for every public
7265
+ * package the orchestrator is scanning. The factory may be called
7266
+ * with an empty array when no public exports were inspected — the
7267
+ * resulting runner produces no findings.
7268
+ */
7269
+ readonly records: ReadonlyArray<TsDocCoverageRecord>;
7270
+ /**
7271
+ * Stable name surfaced via {@link AuditCheckRunner.name}. Defaults
7272
+ * to `"tsdocCoverage"` so logs match the audit-report category key.
7273
+ *
7274
+ * @default "tsdocCoverage"
7275
+ */
7276
+ readonly name?: string;
7277
+ }
7278
+ /**
7279
+ * Map a single {@link TsDocCoverageRecord} to zero, one, or more
7280
+ * audit findings. Exported so callers can reuse the
7281
+ * record-to-finding mapping without going through a runner (e.g. the
7282
+ * audit-mode walker in #526 may compose findings differently).
7283
+ *
7284
+ * Severity mapping (per the parent epic's drift-handling matrix):
7285
+ *
7286
+ * - `missing-summary` — `mechanical` (Phase 2 can auto-stub).
7287
+ * - `thin-summary` — `advisory` (a human should rewrite).
7288
+ * - `missing-params` / `missing-returns` — `advisory` (the symbol
7289
+ * does carry a summary; the missing block tag is signal but does
7290
+ * not block).
7291
+ *
7292
+ * A record with `hasSummary && !hasThinSummary` and no missing block
7293
+ * tags produces no findings — fully-documented exports are reported
7294
+ * by their absence in the result.
7295
+ */
7296
+ declare function tsdocRecordToFindings(record: TsDocCoverageRecord, context: AuditCheckRunnerContext): Array<TsdocCoverageFinding>;
7297
+ /**
7298
+ * Build an {@link AuditCheckRunner} that emits TSDoc-coverage
7299
+ * findings from a precomputed list of {@link TsDocCoverageRecord}.
7300
+ * The runner is synchronous and idempotent; calling `run()` twice
7301
+ * produces identical findings.
7302
+ */
7303
+ declare function createTsdocCoverageCheck(options: TsdocCoverageCheckOptions): AuditCheckRunner;
7304
+
7373
7305
  /**
7374
7306
  * Returns the latest full-release version of an npm package that has been
7375
7307
  * published for at least `minimumReleaseAgeMinutes` minutes. Prefers the
@@ -9269,4 +9201,4 @@ declare const COMPLETE_JOB_ID = "complete";
9269
9201
  */
9270
9202
  declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
9271
9203
 
9272
- 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 };
9204
+ 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 ApiDiffCheckOptions, type ApiDiffFinding, type ApiDiffResult, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApiSurfaceEntry, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, AuditCategory, type AuditCheckRunner, type AuditCheckRunnerContext, type AuditFinding, type AuditFindingBase, type AuditLocation, AuditMode, type AuditReport, AuditSeverity, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CompileFencedSamplesOptions, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DELEGATE_TO_PR_REVIEWER, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_MERGE_METHOD, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_LINKED_ISSUE, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, type LinkFailureFinding, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PREFLIGHT_MERGE_METHOD_VALUES, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PreflightMergeMethod, type PreflightPrConfig, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type ReferenceMismatchCheckOptions, type ReferenceMismatchFinding, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueTemplates, type ResolvedPreflightPr, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedUnblockDependents, type RunRatioConfig, type RunScanOptions, type RunScanResult, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, type SampleCompilationFailure, type SampleFailureFinding, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, type TsdocCoverageCheckOptions, type TsdocCoverageFinding, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, createApiDiffCheck, createReferenceMismatchCheck, createTsdocCoverageCheck, customerProfileBundle, diffApiRollups, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, parseApiRollup, peopleProfileBundle, persistAuditReport, pnpmBundle, prReviewBundle, projenBundle, referenceRecordToFinding, 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, tsdocRecordToFindings, turborepoBundle, typescriptBundle, validateAgentTierConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validatePreflightPrConfig, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateUnblockDependentsConfig, vitestBundle };