okstra 0.189.0 → 0.189.2

package/runtime/templates/reports/html/i18n/en.json

@@ -89,6 +89,45 @@
       "missing-information": "Missing information",
       "follow-up": "Follow-up",
       "plan-item": "Plan item"
+    },
+    "optionCriterion": {
+      "requirement-fit": "Requirement fit",
+      "architecture-fit": "Architecture fit",
+      "change-locality": "Change locality",
+      "implementation-complexity": "Implementation complexity",
+      "correctness-risk": "Correctness risk",
+      "reversibility": "Reversibility",
+      "verification-cost": "Verification cost",
+      "rollout-cost": "Rollout cost"
+    },
+    "feasibilityVerdict": {
+      "feasible": "Feasible",
+      "not-feasible": "Not feasible",
+      "uncertain": "Uncertain"
+    },
+    "commitmentKind": {
+      "user-behavior": "User behavior",
+      "code-change": "Code change",
+      "migration": "Migration",
+      "operational-change": "Operational change",
+      "preserved-behavior": "Preserved behavior",
+      "derived-work": "Derived work"
+    },
+    "coverageVerdict": {
+      "exact": "exact",
+      "under": "under",
+      "over": "over",
+      "contradicted": "contradicted"
+    },
+    "safetyCategory": {
+      "data-loss": "Data loss",
+      "security-violation": "Security violation",
+      "irreversible-migration": "Irreversible migration"
+    },
+    "briefSection": {
+      "Expected Behavior": "Expected behavior",
+      "Preserved Behavior": "Preserved behavior",
+      "Expected Outcome": "Expected outcome"
     }
   },
   "enumHint": {
@@ -122,7 +161,11 @@
     "dismiss": "Dismiss",
     "export-downloads": "Export downloads",
     "drop-that-file-into": ". Drop that file into",
-    "and-the-next-run-picks-your-answers-up-on-it": "and the next run picks your answers up on its own."
+    "and-the-next-run-picks-your-answers-up-on-it": "and the next run picks your answers up on its own.",
+    "brief-end-states": "End states the brief pinned",
+    "brief-end-states-intro": "The requirement ids this report cites (EB, PB, EO) name these brief items, quoted verbatim from the task brief.",
+    "brief-section": "Section",
+    "brief-statement": "Statement"
   },
   "runUsage": {
     "heading": "What this run cost",
@@ -342,7 +385,33 @@
       "option-id": "Option ID",
       "direction": "Direction",
       "confirmation-evidence": "Confirmation evidence",
-      "citation": "Citation"
+      "citation": "Citation",
+      "upstream-decisions": "Upstream decisions:",
+      "evaluation-criteria": "Evaluation criteria",
+      "evaluation-criteria-intro": "Every candidate is scored 1 to 5 on each criterion. The weighted score is the weight-averaged result, so a criterion with weight 5 counts five times as much as one with weight 1.",
+      "criterion": "Criterion",
+      "weight": "Weight",
+      "score": "Score",
+      "why-it-matters": "Why it matters",
+      "what-changes": "What this direction changes",
+      "goal": "Goal:",
+      "goal-column": "Goal",
+      "change-areas": "Expected change areas",
+      "commitment": "Commitment",
+      "commitment-body": "What the direction commits to",
+      "requirements": "Requirements",
+      "how-it-works": "How it is done",
+      "boundaries": "Architecture boundaries it keeps",
+      "why-this-direction": "Why this direction",
+      "feasibility-votes": "Feasibility by worker",
+      "worker": "Worker",
+      "verdict": "Verdict",
+      "counterevidence": "Strongest counterevidence",
+      "safety-blockers": "Safety blockers",
+      "unresolved-facts": "Unresolved feasibility facts",
+      "expected-outcome": "Expected outcome",
+      "coverage-line": "Covers {covered} of {total} requirements ({verdict}).",
+      "planning-invariants": "Must hold in planning"
     },
     "implementation-planning": {
       "what-the-plan-is-for": "What the plan is for",

package/runtime/templates/reports/html/i18n/ko.json

@@ -89,6 +89,45 @@
       "missing-information": "빠진 정보",
       "follow-up": "후속 작업",
       "plan-item": "계획 항목"
+    },
+    "optionCriterion": {
+      "requirement-fit": "요구사항 적합",
+      "architecture-fit": "아키텍처 적합",
+      "change-locality": "변경 국소성",
+      "implementation-complexity": "구현 복잡도",
+      "correctness-risk": "정확성 위험",
+      "reversibility": "되돌리기 쉬움",
+      "verification-cost": "검증 비용",
+      "rollout-cost": "배포 비용"
+    },
+    "feasibilityVerdict": {
+      "feasible": "실행 가능",
+      "not-feasible": "실행 불가",
+      "uncertain": "불확실"
+    },
+    "commitmentKind": {
+      "user-behavior": "사용자 동작",
+      "code-change": "코드 변경",
+      "migration": "마이그레이션",
+      "operational-change": "운영 변경",
+      "preserved-behavior": "보존 동작",
+      "derived-work": "파생 작업"
+    },
+    "coverageVerdict": {
+      "exact": "정확히 일치",
+      "under": "미달",
+      "over": "초과",
+      "contradicted": "모순"
+    },
+    "safetyCategory": {
+      "data-loss": "데이터 손실",
+      "security-violation": "보안 위반",
+      "irreversible-migration": "되돌릴 수 없는 마이그레이션"
+    },
+    "briefSection": {
+      "Expected Behavior": "기대 동작",
+      "Preserved Behavior": "보존 동작",
+      "Expected Outcome": "기대 산출"
     }
   },
   "enumHint": {
@@ -122,7 +161,11 @@
     "dismiss": "닫기",
     "export-downloads": "내보내면 다음 파일이 받아집니다",
     "drop-that-file-into": ". 그 파일을 여기에 두면",
-    "and-the-next-run-picks-your-answers-up-on-it": "다음 run 이 알아서 답변을 읽어 갑니다."
+    "and-the-next-run-picks-your-answers-up-on-it": "다음 run 이 알아서 답변을 읽어 갑니다.",
+    "brief-end-states": "브리프가 고정한 최종 상태",
+    "brief-end-states-intro": "이 리포트가 인용하는 요구사항 아이디(EB·PB·EO)는 브리프의 다음 항목입니다. 문장은 태스크 브리프 원문 그대로입니다.",
+    "brief-section": "절",
+    "brief-statement": "내용"
   },
   "runUsage": {
     "heading": "이번 실행에 든 비용",
@@ -342,7 +385,33 @@
       "option-id": "옵션 아이디",
       "direction": "방향",
       "confirmation-evidence": "확인 근거",
-      "citation": "인용"
+      "citation": "인용",
+      "upstream-decisions": "선행 결정:",
+      "evaluation-criteria": "평가 기준",
+      "evaluation-criteria-intro": "모든 후보를 기준마다 1~5점으로 매깁니다. 가중 점수는 가중치를 반영한 평균이라, 가중치 5인 기준은 가중치 1인 기준의 다섯 배로 반영됩니다.",
+      "criterion": "기준",
+      "weight": "가중치",
+      "score": "점수",
+      "why-it-matters": "왜 중요한가",
+      "what-changes": "무엇을 바꾸는가",
+      "goal": "목표:",
+      "goal-column": "목표",
+      "change-areas": "예상 변경 영역",
+      "commitment": "약속",
+      "commitment-body": "이 방향이 약속하는 것",
+      "requirements": "요구사항",
+      "how-it-works": "어떻게 구현하는가",
+      "boundaries": "지키는 아키텍처 경계",
+      "why-this-direction": "왜 이 방향인가",
+      "feasibility-votes": "작업자별 실행 가능성",
+      "worker": "작업자",
+      "verdict": "판정",
+      "counterevidence": "가장 강한 반대 근거",
+      "safety-blockers": "안전 차단 요인",
+      "unresolved-facts": "미확정 실행 가능성 사실",
+      "expected-outcome": "예상 결과",
+      "coverage-line": "요구사항 {total}개 중 {covered}개를 충족합니다({verdict}).",
+      "planning-invariants": "계획에서 지켜야 할 조건"
     },
     "implementation-planning": {
       "what-the-plan-is-for": "이 계획이 하려는 것",

package/runtime/templates/reports/html/macros/forms.html

@@ -47,6 +47,7 @@
   <fieldset><legend>{{ t('macros.forms.direction') }}</legend>
     {% for option in state.rankedOptions %}
     <input id="direction-selection-{{ option.id }}" type="radio" name="direction-selection-option" value="{{ option.id }}" data-option-name="{{ option.name }}" required><label for="direction-selection-{{ option.id }}">{{ option.id | inline_code }} · {{ option.name | inline_code }}{% if option.id == state.recommendedOptionId %} ({{ t('macros.forms.recommended') }}){% endif %}</label>
+    <p class="direction-goal">{{ option.goal | inline_code }}</p>
     {% endfor %}
   </fieldset>
   <input id="direction-selection-confirmed" type="checkbox" required><label for="direction-selection-confirmed">{{ t('macros.forms.confirmed') }}</label>

package/runtime/templates/reports/html/tasks/implementation-option-selection.template.html

@@ -2,6 +2,51 @@
 {% from "html/macros/layout.html" import narrative as render_narrative, summary_card, row_key %}
 {% from "html/macros/forms.html" import direction_selection %}
 
+{# One direction, read top to bottom as what it changes, how, why it ranks
+   where it does, and what the reader should expect afterwards. Every block
+   is a field the writer already fills; the card used to show the goal line
+   and the coverage table and left the mechanism, scores, votes, commitments
+   and invariants in the record only. #}
+{% macro option_card(row, rank, criteria) -%}
+<article class="summary-card" id="id-{{ row.id }}">
+    <p class="eyebrow">#{{ rank }} · {{ row.id | inline_code }} · {{ t('macros.layout.proposed-by') }} {{ row.proposedBy | inline_code }}</p>
+    <h3>{{ row.name | inline_code }}</h3>
+    <div class="option-detail">
+      <h4>{{ t('tasks.implementation-option-selection.what-changes') }}</h4>
+      <p><strong>{{ t('tasks.implementation-option-selection.goal') }}</strong> {{ row.goal | inline_code }}</p>
+      <p><strong>{{ t('tasks.implementation-option-selection.change-areas') }}</strong></p>
+      <ul>{% for area in row.expectedChangeAreas %}<li>{{ area | inline_code }}</li>{% endfor %}</ul>
+      <table data-report-field="implementationOptionSelection.rankedOptions.scopeCommitments"><thead><tr><th>{{ t('tasks.implementation-option-selection.commitment') }}</th><th>{{ t('tasks.implementation-option-selection.commitment-body') }}</th><th>{{ t('tasks.implementation-option-selection.requirements') }}</th></tr></thead><tbody>{% for item in row.scopeCommitments %}<tr>{{ row_key(pairs=[(t('macros.layout.id'), item.id), (t('macros.layout.kind'), item.kind | enum_label('commitmentKind'))]) }}<td>{{ item.commitment | inline_code }}</td><td>{{ item.requirementIds | join(", ") | inline_code }}</td></tr>{% endfor %}</tbody></table>
+    </div>
+    <div class="option-detail">
+      <h4>{{ t('tasks.implementation-option-selection.how-it-works') }}</h4>
+      <p>{{ row.coreMechanism | inline_code }}</p>
+      <p><strong>{{ t('tasks.implementation-option-selection.boundaries') }}</strong></p>
+      <ul>{% for boundary in row.architectureBoundaries %}<li>{{ boundary | inline_code }}</li>{% endfor %}</ul>
+    </div>
+    <div class="option-detail">
+      <h4>{{ t('tasks.implementation-option-selection.why-this-direction') }}</h4>
+      <p><strong>{{ t('tasks.implementation-option-selection.weighted-score') }}</strong> {{ row.weightedScore }} / 5</p>
+      <table data-report-field="implementationOptionSelection.rankedOptions.criterionScores"><thead><tr><th>{{ t('tasks.implementation-option-selection.criterion') }}</th><th class="figure">{{ t('tasks.implementation-option-selection.weight') }}</th><th class="figure">{{ t('tasks.implementation-option-selection.score') }}</th><th>{{ t('tasks.implementation-option-selection.reason') }}</th></tr></thead><tbody>{% for score in row.criterionScores %}<tr><td>{{ score.criterion | enum_label('optionCriterion') }}</td><td class="figure">{{ criteria.get(score.criterion, '') }}</td><td class="figure">{{ score.score }}</td><td>{{ score.rationale | inline_code }}</td></tr>{% endfor %}</tbody></table>
+      <p><strong>{{ t('tasks.implementation-option-selection.feasibility-votes') }}</strong></p>
+      <table data-report-field="implementationOptionSelection.rankedOptions.feasibilityVotes"><thead><tr><th>{{ t('tasks.implementation-option-selection.worker') }}</th><th>{{ t('tasks.implementation-option-selection.reason') }}</th><th>{{ t('tasks.implementation-option-selection.counterevidence') }}</th></tr></thead><tbody>{% for vote in row.feasibilityVotes %}<tr>{{ row_key(pairs=[(t('tasks.implementation-option-selection.worker'), vote.worker)], status_name=t('tasks.implementation-option-selection.verdict'), status_raw=vote.verdict, status_text=vote.verdict | enum_label('feasibilityVerdict')) }}<td>{{ vote.rationale | inline_code }}</td><td>{{ vote.counterevidence | inline_code }}</td></tr>{% endfor %}</tbody></table>
+      {% if row.safetyBlockers %}<p><strong>{{ t('tasks.implementation-option-selection.safety-blockers') }}</strong></p>
+      <ul>{% for blocker in row.safetyBlockers %}<li><span class="status status-risk">{{ blocker.category | enum_label('safetyCategory') }}</span> {{ blocker.statement | inline_code }} <span class="evidence-refs">{{ t('macros.layout.evidence') }} {{ blocker.evidence | evidence_refs }}</span></li>{% endfor %}</ul>{% endif %}
+      {% if row.unresolvedFeasibilityFacts %}<p><strong>{{ t('tasks.implementation-option-selection.unresolved-facts') }}</strong></p>
+      <ul>{% for fact in row.unresolvedFeasibilityFacts %}<li>{{ fact.fact | inline_code }} — {{ t('tasks.implementation-option-selection.why-it-matters') }} {{ fact.whyItMatters | inline_code }} <span class="evidence-refs">{{ t('macros.layout.evidence') }} {{ fact.evidence | evidence_refs }}</span></li>{% endfor %}</ul>{% endif %}
+    </div>
+    <div class="option-detail">
+      <h4>{{ t('tasks.implementation-option-selection.expected-outcome') }}</h4>
+      <div data-report-field="implementationOptionSelection.rankedOptions.coverageSummary"><p>{{ t('tasks.implementation-option-selection.coverage-line') | replace('{covered}', row.coverageSummary.coveredCount) | replace('{total}', row.coverageSummary.totalCount) | replace('{verdict}', row.coverageSummary.coverageVerdict | enum_label('coverageVerdict')) }}</p>
+      <p><strong>{{ t('macros.layout.coverage-percent') }}</strong> <span data-report-metric="coveragePercent">{{ row.coverageSummary.coveragePercent }}</span>% · <strong>{{ t('macros.layout.scope-precision-percent') }}</strong> <span data-report-metric="scopePrecisionPercent">{{ row.coverageSummary.scopePrecisionPercent }}</span>%</p></div>
+      <table data-report-field="implementationOptionSelection.rankedOptions.requirementCoverage"><thead><tr><th>{{ t('tasks.implementation-option-selection.requirement') }}</th><th>{{ t('tasks.implementation-option-selection.satisfaction') }}</th><th>{{ t('tasks.implementation-option-selection.verification') }}</th></tr></thead><tbody>{% for coverage in row.requirementCoverage %}<tr>{{ row_key(pairs=[(t('macros.layout.id'), coverage.requirementId), (t('macros.layout.status'), coverage.status)]) }}<td>{{ coverage.satisfaction | inline_code }}</td><td>{{ coverage.expectedVerification | inline_code }}</td></tr>{% endfor %}</tbody></table>
+      {% if row.planningInvariants %}<p><strong>{{ t('tasks.implementation-option-selection.planning-invariants') }}</strong></p>
+      <ul data-report-field="implementationOptionSelection.rankedOptions.planningInvariants">{% for invariant in row.planningInvariants %}<li>{{ invariant.id | inline_code }} · {{ invariant.statement | inline_code }} ({{ invariant.requirementIds | join(", ") | inline_code }})</li>{% endfor %}</ul>{% endif %}
+    </div>
+    <p class="evidence-refs">{{ t('macros.layout.evidence') }} {{ row.codeEvidence | evidence_refs }}</p>
+</article>
+{%- endmacro %}
+
 {% block human_content %}
 <section data-report-section="selection-status">
   <h2>{{ t('tasks.implementation-option-selection.selection-status') }}</h2>
@@ -21,29 +66,28 @@
   {{ render_narrative(narrative.comparisonOverview, "implementationOptionSelection.userNarrative.comparisonOverview") }}
   <p data-report-field="implementationOptionSelection.decisionContext.originalRequirementIds"><strong>{{ t('tasks.implementation-option-selection.requirement-ids') }}</strong> {{ selection.decisionContext.originalRequirementIds | join(", ") | inline_code }}</p>
   {% if selection.decisionContext.leadingCauseRefs %}<p><strong>{{ t('tasks.implementation-option-selection.leading-causes') }}</strong> {{ selection.decisionContext.leadingCauseRefs | join(", ") | inline_code }}</p>{% endif %}
+  {% if selection.decisionContext.upstreamDecisionRefs %}<p><strong>{{ t('tasks.implementation-option-selection.upstream-decisions') }}</strong> {{ selection.decisionContext.upstreamDecisionRefs | join(", ") | inline_code }}</p>{% endif %}
+</section>
+
+<section data-report-section="evaluation-criteria" data-report-field="implementationOptionSelection.evaluationCriteria">
+  <h2>{{ t('tasks.implementation-option-selection.evaluation-criteria') }}</h2>
+  <p class="section-lede">{{ t('tasks.implementation-option-selection.evaluation-criteria-intro') }}</p>
+  <table><thead><tr><th>{{ t('tasks.implementation-option-selection.criterion') }}</th><th class="figure">{{ t('tasks.implementation-option-selection.weight') }}</th><th>{{ t('tasks.implementation-option-selection.why-it-matters') }}</th></tr></thead><tbody>{% for criterion in selection.evaluationCriteria %}<tr><td>{{ criterion.criterion | enum_label('optionCriterion') }}</td><td class="figure">{{ criterion.weight }}</td><td>{{ criterion.rationale | inline_code }}</td></tr>{% endfor %}</tbody></table>
 </section>
 
 <section data-report-section="ranked-options" data-report-field="implementationOptionSelection.rankedOptions">
   <h2>{{ t('tasks.implementation-option-selection.ranked-options') }}</h2>
   {{ render_narrative(narrative.rankingExplanation, "implementationOptionSelection.userNarrative.rankingExplanation") }}
-  <div class="summary-grid">{% for row in selection.rankedOptions %}<article class="summary-card" id="id-{{ row.id }}">
-    <p class="eyebrow">#{{ loop.index }} · {{ row.id | inline_code }}</p>
-    <h3>{{ row.name | inline_code }}</h3>
-    <p>{{ row.goal | inline_code }}</p>
-    <div data-report-field="implementationOptionSelection.rankedOptions.coverageSummary"><p><strong>{{ t('macros.layout.coverage-percent') }}</strong> <span data-report-metric="coveragePercent">{{ row.coverageSummary.coveragePercent }}</span></p>
-    <p><strong>{{ t('macros.layout.scope-precision-percent') }}</strong> <span data-report-metric="scopePrecisionPercent">{{ row.coverageSummary.scopePrecisionPercent }}</span></p></div>
-    <p><strong>{{ t('tasks.implementation-option-selection.weighted-score') }}</strong> {{ row.weightedScore }}</p>
-    <table data-report-field="implementationOptionSelection.rankedOptions.requirementCoverage"><thead><tr><th>{{ t('tasks.implementation-option-selection.requirement') }}</th><th>{{ t('tasks.implementation-option-selection.satisfaction') }}</th><th>{{ t('tasks.implementation-option-selection.verification') }}</th></tr></thead><tbody>{% for coverage in row.requirementCoverage %}<tr>{{ row_key(pairs=[(t('macros.layout.id'), coverage.requirementId), (t('macros.layout.status'), coverage.status)]) }}<td>{{ coverage.satisfaction | inline_code }}</td><td>{{ coverage.expectedVerification | inline_code }}</td></tr>{% endfor %}</tbody></table>
-  </article>{% else %}<p>{{ t('tasks.implementation-option-selection.no-valid-options') }}</p>{% endfor %}</div>
+  <div class="summary-grid">{% for row in selection.rankedOptions %}{{ option_card(row, loop.index, criteriaWeights) }}{% else %}<p>{{ t('tasks.implementation-option-selection.no-valid-options') }}</p>{% endfor %}</div>
 </section>
 
 <section data-report-section="recommendation" data-report-field="implementationOptionSelection.recommendedOptionId">
   <h2>{{ t('tasks.implementation-option-selection.recommended-direction') }}</h2>
-  {% if recommendedOption %}{{ summary_card(recommendedOption.id ~ " · " ~ recommendedOption.name, recommendedOption.coreMechanism, "important") }}{% else %}<p>{{ t('tasks.implementation-option-selection.no-recommendation') }}</p>{% endif %}
+  {% if recommendedOption %}{{ summary_card(recommendedOption.id ~ " · " ~ recommendedOption.name, recommendedOption.goal ~ " " ~ recommendedOption.coreMechanism, "important") }}{% else %}<p>{{ t('tasks.implementation-option-selection.no-recommendation') }}</p>{% endif %}
 </section>
 
 <section data-report-section="candidate-audit" data-report-field="implementationOptionSelection.candidateAudit">
   <h2>{{ t('tasks.implementation-option-selection.candidate-audit') }}</h2>
-  <table><thead><tr><th>{{ t('tasks.implementation-option-selection.candidate') }}</th><th>{{ t('tasks.implementation-option-selection.disposition') }}</th><th>{{ t('tasks.implementation-option-selection.reason') }}</th><th>{{ t('macros.layout.coverage-percent') }}</th><th>{{ t('macros.layout.scope-precision-percent') }}</th></tr></thead><tbody>{% for row in selection.candidateAudit %}<tr id="id-{{ row.id }}">{{ row_key(pairs=[(t('macros.layout.id'), row.id), (t('macros.layout.proposed-by'), row.proposedBy)]) }}<td>{{ row.disposition }}</td><td>{{ row.reason | inline_code }}</td><td>{{ row.coverageSummary.coveragePercent }}</td><td>{{ row.coverageSummary.scopePrecisionPercent }}</td></tr>{% else %}<tr><td colspan="6">{{ t('tasks.implementation-option-selection.no-audit-entries') }}</td></tr>{% endfor %}</tbody></table>
+  <table><thead><tr><th>{{ t('tasks.implementation-option-selection.candidate') }}</th><th>{{ t('tasks.implementation-option-selection.goal-column') }}</th><th>{{ t('tasks.implementation-option-selection.disposition') }}</th><th>{{ t('tasks.implementation-option-selection.reason') }}</th><th>{{ t('macros.layout.coverage-percent') }}</th><th>{{ t('macros.layout.scope-precision-percent') }}</th></tr></thead><tbody>{% for row in selection.candidateAudit %}<tr id="id-{{ row.id }}">{{ row_key(pairs=[(t('macros.layout.id'), row.id), (t('macros.layout.proposed-by'), row.proposedBy)]) }}<td>{{ row.goal | inline_code }}</td><td>{{ row.disposition }}{% if row.mergedInto %} → {{ row.mergedInto | inline_code }}{% endif %}</td><td>{{ row.reason | inline_code }}</td><td>{{ row.coverageSummary.coveragePercent }}</td><td>{{ row.coverageSummary.scopePrecisionPercent }}</td></tr>{% else %}<tr><td colspan="6">{{ t('tasks.implementation-option-selection.no-audit-entries') }}</td></tr>{% endfor %}</tbody></table>
 </section>
 {% endblock %}

package/runtime/validators/validate-brief.py

@@ -42,6 +42,11 @@ Checks performed per brief file:
     3-digit id and an `— verify: <how>` observation method, EB/EO are rejected
     in the codebase-scan variant, and `## External Gates` — the destination for
     an item with no observation method — is required in every variant.
+15. A file whose frontmatter `type` is `group-context` is the task-group's
+    context document (`<briefs>/<task-group>/group-context.md`), not a brief:
+    it is checked by `okstra_ctl.group_context.validate_group_context` (four
+    required sections, no template placeholder left, directory slug matches
+    the frontmatter `task-group`). Any other `type` is a failure.
 
 Exit code 0 on PASS, 1 on FAIL.
 """
@@ -66,6 +71,7 @@ from okstra_ctl.improvement_lenses import (
     MAX_PRIORITY_LENSES,
     MIN_PRIORITY_LENSES,
 )
+from okstra_ctl.group_context import GROUP_CONTEXT_TYPE, validate_group_context
 from okstra_ctl.ids import slugify_task_segment
 
 REQUIRED_FRONTMATTER_KEYS = {
@@ -677,6 +683,9 @@ def validate_brief(path: Path, briefs_root: Path) -> list[str]:
     except ValueError as exc:
         return [f"frontmatter: {exc}"]
 
+    if fm.get("type") == GROUP_CONTEXT_TYPE:
+        return validate_group_context(path, briefs_root)
+
     missing = REQUIRED_FRONTMATTER_KEYS - fm.keys()
     if missing:
         errors.append(f"frontmatter missing keys: {sorted(missing)}")