From ef17617a6fd39970b08767aa27b246c1288db8ae Mon Sep 17 00:00:00 2001
From: JSONbored <49853598+JSONbored@users.noreply.github.com>
Date: Sun, 12 Jul 2026 06:38:21 -0700
Subject: [PATCH] docs(engine): document the readinessMode/readinessMinScore
 engine-layer rename

FocusManifestGateConfig's readinessMode/readinessMinScore fold into
RepositorySettings.qualityGateMode/qualityGateMinScore -- a third
spelling of the same concept the yml-key rename already covers, but
undocumented at the engine-layer type itself (unlike its sibling
checkMode two lines above, which does cross-reference its DB
counterpart). Comment-only, no behavior change.

Refs #5285
---
 packages/gittensory-engine/src/focus-manifest.ts | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/gittensory-engine/src/focus-manifest.ts b/packages/gittensory-engine/src/focus-manifest.ts
index 38677a31d..0468271b4 100644
--- a/packages/gittensory-engine/src/focus-manifest.ts
+++ b/packages/gittensory-engine/src/focus-manifest.ts
@@ -83,6 +83,10 @@ export type FocusManifestGateConfig = {
   pack: GatePolicyPack | null;
   linkedIssue: GateRuleMode | null;
   duplicates: GateRuleMode | null;
+  /** `gate.readiness.mode`/`gate.readiness.minScore` -- this engine-layer pair folds into
+   *  `RepositorySettings.qualityGateMode`/`qualityGateMinScore` (src/signals/focus-manifest.ts), a third
+   *  spelling of the same concept alongside the yml key name; the `readiness` gate is distinct from the
+   *  separate `mergeReadiness` composite gate above. */
   readinessMode: GateRuleMode | null;
   readinessMinScore: number | null;
   slopMode: GateRuleMode | null;