okstra 0.189.2 → 0.189.4

package/runtime/python/okstra_ctl/report_html/render.py

@@ -12,12 +12,18 @@ from jinja2 import Environment, FileSystemLoader, StrictUndefined, select_autoes
 from ..final_report_paths import final_report_data_path, translation_sidecar_path
 from ..final_report_schema import load_schema_for_data, validate
 from ..i18n import HTML_DICTIONARY_REL, load_dictionary, make_jinja_global
-from ..report_translation import overlay
+from ..report_translation import overlay, rendered_english_lines
 from ..report_view_artifacts import user_responses_dir_for_report
 from ..usage_cells import format_duration_ms
 from ..json_boundary import load_owned_object
-from .common import anchor_index
-from .context_links import brief_end_states, carry_in_links
+from .common import anchor_index, worker_finding_links
+from .context_links import (
+    approved_plan_links,
+    brief_end_states,
+    carry_in_links,
+    end_state_table,
+    selected_direction_links,
+)
 from .filters import (
     code_evidence,
     enum_label,
@@ -136,21 +142,41 @@ def render_v2_html_view(
     # report's clarifications only fill ids this page has no row for.
     links = {
         row_id: f"#{name}"
-        for row_id, name in anchor_index(data, view.omitted_fields).items()
+        for row_id, name in anchor_index(
+            data, view.anchored_fields, view.scoped_anchor_fields
+        ).items()
     }
     brief_rows = brief_end_states(data_path)
     for row in brief_rows:
         links.setdefault(row["id"], f"#id-{row['id']}")
     links.update(carry_in_links(data, data_path, exclude=links))
+    links.update(selected_direction_links(data, data_path, exclude=links))
+    links.update(approved_plan_links(data, data_path, exclude=links))
+    # 워커 finding 번호(`F-NNN`)는 그 번호를 출처로 적은 승격 근거 행이 하나뿐일
+    # 때만 그 행으로 간다. 이 페이지가 정의한 id 가 우선이다.
+    links.update({
+        finding: href
+        for finding, href in worker_finding_links(data).items()
+        if finding not in links
+    })
     chrome = load_dictionary(lang, HTML_DICTIONARY_REL)
     translate = make_jinja_global(chrome)
     env.globals["t"] = translate
     env.filters["code_evidence"] = code_evidence
     env.filters["enum_label"] = lambda value, vocabulary: enum_label(value, vocabulary, chrome)
     env.filters["enum_legend"] = lambda vocabulary: enum_legend(vocabulary, chrome)
-    env.filters["evidence_refs"] = lambda refs: evidence_refs(refs, links)
-    env.filters["inline_code"] = lambda value: inline_code(value, links)
-    env.filters["paragraphs"] = lambda value: paragraphs(value, links)
+    # `extra` is a card-scoped link map (`common.scoped_anchor_map`): a
+    # direction's own commitment rows outrank the page index for the ids its
+    # prose cites, and nothing else on the page can see them.
+    env.filters["evidence_refs"] = lambda refs, extra=None: evidence_refs(
+        refs, {**links, **(extra or {})}
+    )
+    env.filters["inline_code"] = lambda value, extra=None: inline_code(
+        value, {**links, **(extra or {})}
+    )
+    env.filters["paragraphs"] = lambda value, extra=None: paragraphs(
+        value, {**links, **(extra or {})}
+    )
     response_js = (root / "report.js").read_text(encoding="utf-8")
     base_js = (root / "html/assets/base.js").read_text(encoding="utf-8")
     source_data = final_report_data_path(Path(run_meta.source_report)).as_posix()
@@ -163,9 +189,15 @@ def render_v2_html_view(
         "sourceData": source_data,
         "dataSha256": _sha256(data_path),
         "clarificationItems": data.get("clarificationItems", []),
-        # 브리프의 최종 상태 행. 모든 phase 가 EB/PB/EO 아이디를 인용하지만
-        # 문장은 브리프에만 있으므로 여기서 한 번 그려 인용에 착지점을 준다.
-        "briefEndStates": brief_rows,
+        # 브리프의 최종 상태 행과 이 run 의 `endStateCoverage` 판정을 한 표로.
+        # 모든 phase 가 EB/PB/EO 아이디를 인용하지만 문장은 브리프에만 있고,
+        # "이 run 이 그 상태를 덮었는가" 는 coverage 표에만 있다.
+        "endStates": end_state_table(brief_rows, data),
+        # 에이전트 활동 표. 계획 리포트의 결정 카드가 `#id-A-NNN` 으로 가리키고
+        # 다른 phase 의 산문도 인용하므로 모든 타입의 페이지가 같은 절을 그린다.
+        "agentActivity": [
+            row for row in data.get("agentActivity") or [] if isinstance(row, dict)
+        ],
         # 합의·이견 근거는 태스크 본문과 같이 기본 화면에 올린다. 근거 대장
         # 감사 모드에만 두면 판정이 사용자에게 안 보인다.
         "crossVerification": data.get("crossVerification") or {},
@@ -178,9 +210,18 @@ def render_v2_html_view(
     }
     output_path = _html_path(data_path)
     document = env.get_template(route.template_name).render(**context)
-    output_path.write_text(
-        inject_report_index(document, label=translate("base.contents")), encoding="utf-8"
-    )
+    document = inject_report_index(document, label=translate("base.contents"))
+    output_path.write_text(document, encoding="utf-8")
+    if lang != "en":
+        # 사이드카 보고("left in English")는 추출 범위 안만 센다. 페이지에 실제로
+        # 남은 영어 문장은 여기서 세어 같은 stdout 에 낸다 — 두 숫자가 갈리면
+        # `PROSE_KEYS` 밖의 필드가 화면에 나가고 있다는 뜻이다.
+        english = rendered_english_lines(document)
+        sys.stdout.write(
+            f"rendered {len(english)} line(s) still in English on the {lang} page"
+            + (f" (e.g. {english[0][:80]!r})" if english else "")
+            + "\n"
+        )
     if context["clarificationItems"] or context.get("directionSelection"):
         # The footer tells the reader to drop the exported file here, so the
         # directory has to exist before they go looking for it.

package/runtime/python/okstra_ctl/report_html/view_models/change_impact_analysis.py

@@ -5,6 +5,12 @@ from ..common import analysis_review_ids, evidence_index
 from ..models import HumanReportView, VisualEdge, VisualNode
 from ..visualizations import flow_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "changeImpactAnalysis.impactItems",
+)
+
 
 def _impact_figure(change: dict):
     nodes = [
@@ -39,11 +45,12 @@ def build_change_impact_analysis_view(data: dict) -> HumanReportView:
         "narrative": change["userNarrative"],
         "blastRadiusFigure": figure,
         "analysisReviewIds": analysis_review_ids(data),
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         task_type="change-impact-analysis",
         template_name="html/tasks/change-impact-analysis.template.html",
         context=context,
         figures=(figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/error_analysis.py

@@ -7,6 +7,12 @@ from ..common import evidence_index
 from ..models import HumanReportView, VisualEdge, VisualNode
 from ..visualizations import cause_graph_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "errorAnalysis.causeCandidates",
+)
+
 
 _LEAD_CLAUSE = re.compile(r"\s[—–-]\s|(?<=[.。!?])\s")
 _MAX_LABEL_CHARS = 44
@@ -92,11 +98,12 @@ def build_error_analysis_view(data: dict) -> HumanReportView:
         "error": error,
         "narrative": error["userNarrative"],
         "causeFigure": figure,
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         "error-analysis",
         "html/tasks/error-analysis.template.html",
         context,
         (figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/feature_analysis.py

@@ -5,6 +5,15 @@ from ..common import analysis_review_ids, evidence_index
 from ..models import HumanReportView, VisualNode
 from ..visualizations import flow_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "featureAnalysis.flows",
+    "featureAnalysis.domainRules",
+    "featureAnalysis.stateChanges",
+    "featureAnalysis.testCoverage",
+)
+
 
 _FLOW_KINDS = {"normal": "Normal path", "alternative": "Alternative path", "failure": "Failure path"}
 
@@ -31,11 +40,12 @@ def build_feature_analysis_view(data: dict) -> HumanReportView:
         "narrative": feature["userNarrative"],
         "flowFigure": figure,
         "analysisReviewIds": analysis_review_ids(data),
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         task_type="feature-analysis",
         template_name="html/tasks/feature-analysis.template.html",
         context=context,
         figures=(figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/final_verification.py

@@ -6,6 +6,16 @@ from ..common import evidence_index
 from ..models import HumanReportView, VisualNode
 from ..visualizations import coverage_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "finalVerification.validationEvidence",
+    "finalVerification.addedSurfaceAudit",
+    "finalVerification.acceptanceBlockers",
+    "finalVerification.residualRisk",
+    "finalVerdict.conditionalAcceptanceConditions",
+)
+
 
 def _coverage_nodes(final: dict) -> tuple[VisualNode, ...]:
     return tuple(
@@ -31,15 +41,17 @@ def build_final_verification_view(data: dict) -> HumanReportView:
         "humanSummary": data["humanSummary"],
         "verdict": data["verdictCard"],
         "verdictToken": verdict_token,
+        "finalVerdict": data["finalVerdict"],
         "final": final,
         "narrative": final["userNarrative"],
         "coverageFigure": figure,
         "releaseAllowed": release_handoff_allowed(data),
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         "final-verification",
         "html/tasks/final-verification.template.html",
         context,
         (figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/implementation.py

@@ -5,6 +5,13 @@ from ..common import evidence_index
 from ..models import HumanReportView, VisualNode
 from ..visualizations import change_map_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "implementation.requirementCoverage",
+    "implementation.outOfPlanEdits",
+)
+
 
 _FILE_ACTIONS = {"created": "Created", "modified": "Modified", "deleted": "Deleted"}
 
@@ -33,11 +40,12 @@ def build_implementation_view(data: dict) -> HumanReportView:
         "implementation": implementation,
         "narrative": implementation["userNarrative"],
         "changeFigure": figure,
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         "implementation",
         "html/tasks/implementation.template.html",
         context,
         (figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/implementation_option_selection.py

@@ -1,9 +1,31 @@
 """Human-first implementation-direction comparison view."""
 from __future__ import annotations
 
-from ..common import evidence_index
+from ..common import evidence_index, scoped_anchor_map
 from ..models import HumanReportView
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "implementationOptionSelection.rankedOptions",
+    "implementationOptionSelection.candidateAudit",
+)
+SCOPED_ANCHOR_FIELDS = (
+    "implementationOptionSelection.rankedOptions.scopeCommitments",
+    "implementationOptionSelection.rankedOptions.planningInvariants",
+    "implementationOptionSelection.candidateAudit.scopeCommitments",
+)
+
+
+def _card_links(data: dict) -> dict[str, dict[str, str]]:
+    links: dict[str, dict[str, str]] = {}
+    for path in SCOPED_ANCHOR_FIELDS:
+        for parent_id, children in scoped_anchor_map(data, path).items():
+            links.setdefault(parent_id, {}).update(
+                {child_id: f"#{anchor}" for child_id, anchor in children.items()}
+            )
+    return links
+
 
 def build_implementation_option_selection_view(data: dict) -> HumanReportView:
     selection = data["implementationOptionSelection"]
@@ -29,11 +51,16 @@ def build_implementation_option_selection_view(data: dict) -> HumanReportView:
             ),
             None,
         ),
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS, SCOPED_ANCHOR_FIELDS),
+        # 카드별 링크 맵. 방향마다 `IC-001` 이 다시 시작하므로 그 카드 안의
+        # 인용은 그 카드의 행으로만 간다.
+        "cardLinks": _card_links(data),
     }
     return HumanReportView(
         task_type="implementation-option-selection",
         template_name="html/tasks/implementation-option-selection.template.html",
         context=context,
         figures=(),
+        anchored_fields=ANCHORED_FIELDS,
+        scoped_anchor_fields=SCOPED_ANCHOR_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/implementation_planning.py

@@ -89,13 +89,18 @@ def _stage_figure(planning: dict):
     return stage_map_figure(nodes=nodes, edges=edges, title="Implementation stage dependencies")
 
 
-# 승인자가 보지 않는 구현자·사고 대응 표. 계획 본문 검증은 판정과 근거가
-# 승인 판단이라 여기 두지 않는다.
-_OMITTED_FIELDS = (
-    "validationChecklist",
-    "crossProjectDependencies",
-    "dependencyMigrationRisk",
-    "rollbackStrategy",
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`). The implementer-facing tables the
+# approver does not read — validation checklist, cross-project dependencies,
+# migration risk, rollback — are not drawn, so their rows land in the ledger.
+ANCHORED_FIELDS = (
+    "implementationPlanning.directionRealization.fileStructure",
+    "implementationPlanning.directionRealization.planningInvariants",
+    "implementationPlanning.optionCandidates.fileStructure",
+    "implementationPlanning.designPreparation.items",
+    "implementationPlanning.requirementCoverage",
+    "implementationPlanning.planBodyVerification.planItems",
+    "implementationPlanning.supersessionLedger",
 )
 
 
@@ -131,12 +136,12 @@ def build_implementation_planning_view(data: dict) -> HumanReportView:
             row["activityId"]: row for row in activities if row.get("activityId")
         },
         "decisionCards": decision_cards,
-        "evidenceIndex": evidence_index(data, _OMITTED_FIELDS),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         "implementation-planning",
         "html/tasks/implementation-planning.template.html",
         context,
         (figure,) if figure is not None else (),
-        _OMITTED_FIELDS,
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/improvement_discovery.py

@@ -5,6 +5,12 @@ from ..common import evidence_index
 from ..models import HumanReportView, VisualNode
 from ..visualizations import matrix_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "improvementDiscovery.candidates",
+)
+
 
 def _candidate_nodes(improvement: dict) -> tuple[VisualNode, ...]:
     return tuple(
@@ -32,11 +38,12 @@ def build_improvement_discovery_view(data: dict) -> HumanReportView:
         "improvement": improvement,
         "narrative": improvement["userNarrative"],
         "matrixFigure": figure,
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         "improvement-discovery",
         "html/tasks/improvement-discovery.template.html",
         context,
         (figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/project_analysis.py

@@ -5,6 +5,19 @@ from ..common import evidence_index
 from ..models import HumanReportView, VisualEdge, VisualNode
 from ..visualizations import dependency_figure, infrastructure_figure, workflow_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger. The
+# architecture figure anchors component nodes; the infrastructure figure's
+# store and external nodes carry synthetic ids and anchor nothing.
+ANCHORED_FIELDS = (
+    "projectAnalysis.components",
+    "projectAnalysis.internalInterfaces",
+    "projectAnalysis.workflows",
+    "projectAnalysis.rankedHotspots",
+    "projectAnalysis.qualityCoverage",
+    "projectAnalysis.featureIndex",
+)
+
 
 def _component_nodes(project: dict) -> tuple[VisualNode, ...]:
     return tuple(
@@ -130,11 +143,12 @@ def build_project_analysis_view(data: dict) -> HumanReportView:
         "workflowFigure": workflows,
         "narrative": project["userNarrative"],
         "architectureFigure": architecture,
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         task_type="project-analysis",
         template_name="html/tasks/project-analysis.template.html",
         context=context,
         figures=tuple(f for f in (architecture, infrastructure, workflows) if f),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/release_handoff.py

@@ -7,6 +7,11 @@ from ..common import evidence_index
 from ..models import HumanReportView, VisualNode
 from ..visualizations import timeline_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+)
+
 
 def _safe_http_url(value: str) -> str:
     parsed = urlparse(value)
@@ -37,11 +42,12 @@ def build_release_handoff_view(data: dict) -> HumanReportView:
         "narrative": handoff["userNarrative"],
         "handoffFigure": figure,
         "prUrl": _safe_http_url(handoff["pullRequestOutcome"].get("url", "")),
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         "release-handoff",
         "html/tasks/release-handoff.template.html",
         context,
         (figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_html/view_models/requirements_discovery.py

@@ -5,6 +5,13 @@ from ..common import evidence_index
 from ..models import HumanReportView, VisualEdge, VisualNode
 from ..visualizations import decision_flow_figure
 
+# Record fields this template anchors as `id-<row id>` (see
+# `HumanReportView.anchored_fields`); ids elsewhere land in the ledger.
+ANCHORED_FIELDS = (
+    "requirementsDiscovery.confirmedRequirements",
+    "requirementsDiscovery.unresolvedRequirements",
+)
+
 
 def _routing_figure(data: dict, requirements: dict):
     current = data["header"]["taskKey"]
@@ -47,11 +54,12 @@ def build_requirements_discovery_view(data: dict) -> HumanReportView:
         "narrative": requirements["userNarrative"],
         "routingFigure": figure,
         "clarificationItems": data.get("clarificationItems", []),
-        "evidenceIndex": evidence_index(data),
+        "evidenceIndex": evidence_index(data, ANCHORED_FIELDS),
     }
     return HumanReportView(
         "requirements-discovery",
         "html/tasks/requirements-discovery.template.html",
         context,
         (figure,),
+        anchored_fields=ANCHORED_FIELDS,
     )

package/runtime/python/okstra_ctl/report_translation.py

@@ -24,6 +24,8 @@ from typing import Any, Iterator, Mapping, NamedTuple
 # Values the renderer reads as text and nothing else.
 PROSE_KEYS = frozenset({
     "acceptance",
+    "action",
+    "actions",
     "addedWork",
     "alternativesConsidered",
     "answer",
@@ -31,18 +33,23 @@ PROSE_KEYS = frozenset({
     "approvalDisposition",
     "approvalEvidence",
     "architectureBoundaries",
+    "assumptions",
     "behavior",
     "blastRadius",
     "blockReason",
     "blockedReason",
+    "blockers",
     "body",
+    "boundary",
     "briefEvidence",
+    "canonical",
     "carryIn",
     "causeSummary",
     "change",
     "check",
     "claim",
     "commitment",
+    "complexity",
     "condition",
     "confirmingSignal",
     "conformanceExemption",
@@ -53,6 +60,7 @@ PROSE_KEYS = frozenset({
     "coreReason",
     "counterevidence",
     "decision",
+    "decisions",
     "declinedFixRecommendations",
     "description",
     "details",
@@ -75,15 +83,22 @@ PROSE_KEYS = frozenset({
     "expectedOutcome",
     "expectedResult",
     "expectedVerification",
+    "explanation",
     "fact",
     "failureHandling",
+    "falsifyingEvidenceChecked",
     "finalConclusion",
     "goal",
+    "guardrails",
     "headline",
     "howToStart",
     "hypothesis",
+    "ifStillOpen",
+    "injectedAs",
+    "interfaces",
     "item",
     "justification",
+    "knownFacts",
     "label",
     "mitigation",
     "motivation",
@@ -108,15 +123,23 @@ PROSE_KEYS = frozenset({
     "reason",
     "rejectedSummary",
     "rejectingSignal",
+    "relation",
+    "replacedInTest",
+    "replacedWith",
+    "requestKind",
     "requiredDecision",
     "requiredWork",
     "requirement",
     "resolution",
     "responsibility",
+    "reversibility",
+    "risk",
     "rolloutCost",
     "routingRecommendation",
-    "selfFixNote",
     "satisfaction",
+    "scope",
+    "selfFixNote",
+    "sliceValue",
     "stageTitle",
     "stageValidation",
     "statement",
@@ -136,6 +159,7 @@ PROSE_KEYS = frozenset({
     "triggerSignal",
     "unblockCondition",
     "userChoice",
+    "userConstraints",
     "userInput",
     "userText",
     "verification",
@@ -426,6 +450,39 @@ def overlay(
 HANGUL_PROSE_LIMIT = 0.20
 
 
+_RENDERED_SKIP_RE = re.compile(
+    r"<script.*?</script>|<style.*?</style>|<svg.*?</svg>|<pre.*?</pre>|<option.*?</option>",
+    re.DOTALL,
+)
+_TEXT_NODE_RE = re.compile(r">([^<>]{40,})<")
+_ENTITY_RE = re.compile(r"&[#A-Za-z0-9]+;")
+
+
+def rendered_english_lines(html: str, *, min_words: int = 6) -> list[str]:
+    """Text nodes of a rendered page that carry no Hangul and read as a sentence.
+
+    `OverlayReport.untranslated` only sees the pointers the extractor offered,
+    so a reader-facing field outside `PROSE_KEYS` never shows up there — the
+    2026-09-05 audit found 40 plan-item explanations and 29 step actions in
+    English on a page that reported "0 left in English". This reads the page
+    itself. Scripts, styles, figures, code blocks and `<option>` values are
+    skipped: figure labels and response values are meant to stay verbatim.
+    Inline `<code>` is stripped so a sentence around a path still counts.
+    """
+    body = html.split("<main", 1)[-1]
+    body = _RENDERED_SKIP_RE.sub(" ", body)
+    body = re.sub(r"</?code>", "", body)
+    lines: list[str] = []
+    for match in _TEXT_NODE_RE.finditer(body):
+        text = _ENTITY_RE.sub(" ", match.group(1)).strip()
+        if len(text.split()) < min_words:
+            continue
+        if any("가" <= char <= "힣" for char in text):
+            continue
+        lines.append(text)
+    return lines
+
+
 def hangul_share(data: Mapping[str, Any]) -> tuple[float, int]:
     """Return the Hangul share of the report's authored prose, and its length."""
     text = "".join(extract(data).values())

package/runtime/python/okstra_ctl/run.py

@@ -4742,6 +4742,10 @@ def prepare_task_bundle(inp: PrepareInputs) -> PrepareOutputs:
         relative_to_project_root(Path(inp.selected_direction_path), project_root)
         if inp.selected_direction_path else ""
     )
+    approved_plan_relative = (
+        relative_to_project_root(Path(inp.approved_plan_path), project_root)
+        if inp.approved_plan_path else ""
+    )
 
     forbidden_by_phase = load_phase_forbidden(workspace_root)
 
@@ -4761,6 +4765,8 @@ def prepare_task_bundle(inp: PrepareInputs) -> PrepareOutputs:
         "CLARIFICATION_RESPONSE_RELATIVE_PATH": clarification_relative,
         "SELECTED_DIRECTION_PATH": inp.selected_direction_path,
         "SELECTED_DIRECTION_RELATIVE_PATH": selected_direction_relative,
+        "APPROVED_PLAN_PATH": inp.approved_plan_path,
+        "APPROVED_PLAN_RELATIVE_PATH": approved_plan_relative,
         **_reverify_scope_ctx(inp.reverify_scope),
         "BRIEF_FILE_PATH": str(inp.brief_path),
         "BRIEF_RELATIVE_PATH": brief_relative,