grift-cli 0.5.8__tar.gz → 0.5.9__tar.gz

{grift_cli-0.5.8 → grift_cli-0.5.9}/.grift/contribution.json

@@ -3,8 +3,8 @@
   "purpose": "TEP Report 集計と参照分布 vNext",
   "provenance": {
     "tool_name": "grift",
-    "tool_version": "0.5.8",
-    "definition_version": "tep-v0.5.8-2026-08-25",
+    "tool_version": "0.5.9",
+    "definition_version": "tep-v0.5.9-2026-08-25",
     "origin_definition_version": "origin-v1.1-2026-08-22",
     "activity_definition_version": "activity-v1-2026-08-16",
     "analysis_scope": "repo"
@@ -13,13 +13,13 @@
     "provenance": {
       "tool_name": "grift",
       "method_name": "TEP",
-      "tool_version": "0.5.8",
-      "definition_version": "tep-v0.5.8-2026-08-25",
+      "tool_version": "0.5.9",
+      "definition_version": "tep-v0.5.9-2026-08-25",
       "origin_definition_version": "origin-v1.1-2026-08-22",
       "activity_definition_version": "activity-v1-2026-08-16",
       "analysis_scope": "repo",
       "analyzed_commit_sha": "49248320758d2d9e604a2420c285136e1ea6eff3",
-      "analyzed_at": "2026-08-25T06:16:56Z"
+      "analyzed_at": "2026-08-25T09:17:01Z"
     },
     "lineage": {
       "is_fork": false,
@@ -167,13 +167,38 @@
     }
   },
   "context_profile": {
-    "definition_version": "context-v3-2026-08-25",
-    "analysis_scope": "repo",
+    "docs_share": {
+      "kind": "observed",
+      "value": 0.0,
+      "unit": "ratio"
+    },
+    "language_composition": {
+      "kind": "observed",
+      "value": {
+        "py": 1.0
+      },
+      "unit": "touch-share"
+    },
     "resolved_human_actors": {
       "kind": "observed",
       "value": 1,
       "unit": "actors"
     },
+    "lifecycle_stage": {
+      "kind": "observed",
+      "value": "dormant",
+      "unit": "class"
+    },
+    "release_cadence": {
+      "kind": "observed",
+      "value": null,
+      "unit": "tags/year"
+    },
+    "pr_flow_share": {
+      "kind": "observed",
+      "value": 0.0,
+      "unit": "ratio"
+    },
     "actor_turnover": {
       "kind": "observed",
       "value": {
@@ -189,68 +214,43 @@
       "value": "solo",
       "unit": "class"
     },
-    "kind": "observed",
-    "language_composition": {
-      "kind": "observed",
-      "value": {
-        "py": 1.0
-      },
-      "unit": "touch-share"
-    },
-    "monorepo_markers": {
-      "kind": "observed",
-      "value": [],
-      "unit": "markers"
-    },
-    "issue_link_density": {
-      "kind": "observed",
-      "value": 0.0,
-      "unit": "ratio"
-    },
-    "lifecycle_stage": {
-      "kind": "observed",
-      "value": "dormant",
-      "unit": "class"
-    },
+    "definition_version": "context-v3-2026-08-25",
     "repo_age_days": {
       "kind": "observed",
       "value": 0,
       "unit": "days"
     },
-    "pr_flow_share": {
+    "conventional_commit_share": {
       "kind": "observed",
-      "value": 0.0,
+      "value": 1.0,
       "unit": "ratio"
     },
+    "dependency_manifests": {
+      "kind": "observed",
+      "value": [],
+      "unit": "manifests"
+    },
+    "analysis_scope": "repo",
     "test_file_ratio": {
       "kind": "observed",
       "value": 0.3333,
       "unit": "ratio"
     },
-    "release_cadence": {
-      "kind": "observed",
-      "value": null,
-      "unit": "tags/year"
-    },
     "top_actor_share": {
       "kind": "observed",
       "value": 1.0,
       "unit": "ratio"
     },
-    "conventional_commit_share": {
-      "kind": "observed",
-      "value": 1.0,
-      "unit": "ratio"
-    },
-    "dependency_manifests": {
+    "monorepo_markers": {
       "kind": "observed",
       "value": [],
-      "unit": "manifests"
+      "unit": "markers"
     },
-    "docs_share": {
+    "issue_link_density": {
       "kind": "observed",
       "value": 0.0,
       "unit": "ratio"
-    }
+    },
+    "kind": "observed"
   }
 }

{grift_cli-0.5.8 → grift_cli-0.5.9}/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 タグ・PyPI・リポ public 化は本ファイルの記載対象外（人間ゲート）。
 
+## [0.5.9] — 2026-08-25
+
+### Changed（代表 UX フィードバック）
+
+- **report.md の説明を項目ごと（行末）に配置**: セクション末尾への一括説明を廃止し、各値の行末に短い日英併記の gloss を直付け（origin 11分類・activity 5項目・test co-change・corrective/path retouch・survival・context 各行・test frameworks）。値と説明の距離がゼロになり、レポートを上から読むだけで各数値の意味が分かる
+- **検収ゲート対応（提唱者4点）**: ①全 gloss の**単位一致**を機械強制（origin はコミット単位に統一 —「identityに一致しなかったコミット」等・行の単位と gloss の突合テスト）②gloss の**規範語ゲート**（良い/悪い/優れ/劣る/健全/理想等の混入ゼロをピン。解釈は metrics-guide 側のみ・rework の否定注記は維持）③**report.json は不変**（gloss は md のみ・render が dict を mutate しないことと verify が VERIFIED のままなことをテストで明示）④**Shared block は gloss なしと仕様明文化**（README 日英・metrics-guide に「簡潔さ優先、意味は本文行末 gloss が担う」の一行・gloss-free をピン）
+
 ## [0.5.8] — 2026-08-25
 
 提唱者事前レビューの必須ゲート（A/B/C/D/E）+ 日英併記拡充。

{grift_cli-0.5.8 → grift_cli-0.5.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: grift-cli
-Version: 0.5.8
+Version: 0.5.9
 Summary: Deterministic TEP evidence metrics from a single git repository. No LLM.
 Project-URL: Homepage, https://github.com/Cor-Incorporated/grift-cli
 Author: TEP contributors
@@ -104,6 +104,10 @@ grift contribute --out .grift/contribution.json  # ② payload を組み・全
 
 母数 20 未満では率も分布位置も出さない（`insufficient_population`。件数の生表示のみ）。
 
+## Shared block の扱い（仕様）
+
+Shared block（レポート冒頭 3-5 行のコピペ要約）には **gloss（説明）を付けない**。経歴書や issue にそのまま貼ったとき自己説明的な長文になるより、簡潔さ・貼りやすさを優先するため。各数値の意味は本文の行末 gloss と [docs/metrics-guide.md](metrics-guide.md) が担う。
+
 ## 指標の読み方（非エンジニア向け）
 
 すべての指標について「何を測っているか・高い/低いで何がわかるか・公開リポジトリ117件の分布上の目安」を [docs/metrics-guide.md](docs/metrics-guide.md) に平易にまとめています。初めてレポートを見る方はまずこちらを。誤読しやすい点（例: corrective rework はバグ件数ではない、dormant は放置ではない）も表にしてあります。

{grift_cli-0.5.8 → grift_cli-0.5.9}/README.en.md

@@ -95,6 +95,14 @@ grift contribute --out .grift/contribution.json   # 2) build & review the payloa
 - Use is limited to "TEP Report aggregation and the next reference
   distribution"; retained until the next annual Report; withdrawal via issue
 
+## Shared block policy (spec)
+
+The Shared block (the 3-5 line copy-pasteable summary at the top of every
+report) carries **no glosses**. Rationale: it is pasted into résumés and
+issues, where compactness beats self-explanation — the per-line glosses in
+the body and [docs/en/metrics-guide.md](en/metrics-guide.md) carry the
+meanings.
+
 ## How to read the metrics (for non-engineers)
 
 [docs/metrics-guide.md](docs/metrics-guide.md) explains every metric in plain

{grift_cli-0.5.8 → grift_cli-0.5.9}/README.md

@@ -81,6 +81,10 @@ grift contribute --out .grift/contribution.json  # ② payload を組み・全
 
 母数 20 未満では率も分布位置も出さない（`insufficient_population`。件数の生表示のみ）。
 
+## Shared block の扱い（仕様）
+
+Shared block（レポート冒頭 3-5 行のコピペ要約）には **gloss（説明）を付けない**。経歴書や issue にそのまま貼ったとき自己説明的な長文になるより、簡潔さ・貼りやすさを優先するため。各数値の意味は本文の行末 gloss と [docs/metrics-guide.md](metrics-guide.md) が担う。
+
 ## 指標の読み方（非エンジニア向け）
 
 すべての指標について「何を測っているか・高い/低いで何がわかるか・公開リポジトリ117件の分布上の目安」を [docs/metrics-guide.md](docs/metrics-guide.md) に平易にまとめています。初めてレポートを見る方はまずこちらを。誤読しやすい点（例: corrective rework はバグ件数ではない、dormant は放置ではない）も表にしてあります。

{grift_cli-0.5.8 → grift_cli-0.5.9}/action.yml

@@ -16,7 +16,7 @@ inputs:
   version:
     description: "grift-cli version to install (pinned)"
     required: false
-    default: "0.5.8"
+    default: "0.5.9"
   comment:
     description: "Opt-in: post the shared block as a PR comment (default off)"
     required: false

{grift_cli-0.5.8 → grift_cli-0.5.9}/docs/metrics-guide.md

@@ -70,7 +70,7 @@ grift のレポートは3層の観測で構成されます。**層 = その数
 
 ## まず全体の流れ（report.md の構成）
 
-1. **Shared block**: 3-5 行の要約（コピペで共有できる形式）
+1. **Shared block**: 3-5 行の要約（コピペで共有できる形式・**gloss なし — 簡潔さ優先、意味は本文行末 gloss と本書が担う**）
 2. **Provenance**: いつ・どのコミット・どの定義版で測ったか（再現に必要な情報）
 3. **帰属（origin 11分類）**: この repo のコミットが誰の/何の仕事か（上のインベントリ参照）
 4. **証拠系**: test co-change（検証を伴った変更の割合）

{grift_cli-0.5.8 → grift_cli-0.5.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "grift-cli"
-version = "0.5.8"
+version = "0.5.9"
 description = "Deterministic TEP evidence metrics from a single git repository. No LLM."
 readme = "README.md"
 license = { text = "MIT" }

{grift_cli-0.5.8 → grift_cli-0.5.9}/src/tep_core/report.py

@@ -23,6 +23,22 @@ _DISPLAY_NAME = {
     "tenant_merge_or_sync": "merge commits (PR flow)",
 }
 
+# Inline one-line glosses (ja / en) per origin class — keep short so the
+# value stays scannable; full definitions live in docs/metrics-guide.
+_ORIGIN_GLOSS = {
+    "tenant_unique": "本人の独自コミット / this person's original commits",
+    "tenant_merge_or_sync": "PRマージ経由 / merged via PR flow",
+    "upstream_sync": "上流の取り込み / pulls from upstream",
+    "inherited_upstream": "fork由来の他人のコミット / other people's commits from the forked history",
+    "tenant_derivative": "親リポ由来の改変コミット / commits derived from the parent repo",
+    "external_upstream_contribution": "上流へ還流したコミット / commits contributed back upstream",
+    "template_inherited": "テンプレート由来のコミット / template-derived commits",
+    "generated_or_vendor": "生成・ベンダー成果物のみのコミット / commits touching only generated or vendored files",
+    "ambiguous_origin": "作者情報が欠損したコミット / commits with missing author info",
+    "unresolved": "identityに一致しなかったコミット / commits not matched by the identity",
+    "bot": "自動化アカウントのコミット / automation-account commits",
+}
+
 _SKIP_NOT_OBSERVED = frozenset({"upstream_sync", "tenant_merge_or_sync"})
 
 
@@ -122,18 +138,20 @@ def render_markdown(report: dict[str, Any]) -> str:
         ):
             continue
         label = _DISPLAY_NAME.get(name, name)
-        lines.append(f"- {label}: {_fmt_obs(obs)}")
+        gloss = _ORIGIN_GLOSS.get(name, "")
+        suffix = f" — {gloss}" if gloss else ""
+        lines.append(f"- {label}: {_fmt_obs(obs)}{suffix}")
     lines += [
         "",
         "## Activity (tenant_unique commits)",
-        f"- tenant commits: {_fmt_obs(activity['tenant_commits'])}",
-        f"- active days: {_fmt_obs(activity['active_days'])}",
-        f"- commits per active day: {_fmt_obs(activity['commits_per_active_day'])}",
+        f"- tenant commits: {_fmt_obs(activity['tenant_commits'])} — identityに一致した人のコミット数 / commits by identity-matched people",
+        f"- active days: {_fmt_obs(activity['active_days'])} — コミットした一意な日数 / unique days with commits",
+        f"- commits per active day: {_fmt_obs(activity['commits_per_active_day'])} — 1活動日あたりの密度 / per-active-day density",
         (
             "- commits per active day (median): "
-            f"{_fmt_obs(activity['commits_per_active_day_median'])}"
+            f"{_fmt_obs(activity['commits_per_active_day_median'])} — 中央値（日ごとの偏りに強い）/ median (robust to daily spikes)"
         ),
-        f"- active days (13 weeks): {_fmt_obs(activity['active_days_13w'])}",
+        f"- active days (13 weeks): {_fmt_obs(activity['active_days_13w'])} — 直近13週の活動日数 / active days in the last 13 weeks",
         "",
         "## Core activity period",
     ]
@@ -153,27 +171,27 @@ def render_markdown(report: dict[str, Any]) -> str:
         lines.append(f"- not observed ({tests.get('reason')})")
     else:
         names = ", ".join(tests.get("names") or []) or "none named"
-        lines.append(f"- observed: {names} (boolean {tests.get('value')})")
+        lines.append(
+            f"- observed: {names} (boolean {tests.get('value')})"
+            " — 検出されたテスト基盤 / detected test substrate"
+        )
     lines += [
         "",
         "## Test co-change",
-        "（何を測るか / What this measures: 本番コードを変えたコミットのうち、同じコミットでテストも変更した割合。高い=変更にテストが伴う習慣。テストが前提でない仕事は正当に低くなる — the share of production-changing commits whose same commit also changed tests. High = the habit of pairing changes with tests. Work where tests are not the norm legitimately lands low.)",
-        f"- {_fmt_metric_block(report.get('test_cochange'))}",
+        f"- {_fmt_metric_block(report.get('test_cochange'))} — 本番変更のうち同コミットでテストも変更した割合 / share of production changes paired with tests in the same commit",
     ]
     interp = report.get("interpretation") or {}
     lines += _fmt_interp_line("co-change", interp.get("test_cochange"))
     lines += [
         "",
         "## Rework",
-        "（何を測るか / What this measures: 作った直後に手直しが発生した傾向の観測。バグ件数でも品質でもなく、件名慣習の影響を受けるため比較・合否には使えない — observed tendency of immediate rework after fresh changes. Not a bug count, not quality; subject-convention dependent, so never use for comparisons or pass/fail.)",
         *_fmt_rework_lines(report.get("rework")),
     ]
     lines += _fmt_interp_line("corrective rework", interp.get("corrective_rework"))
     lines += [
         "",
         "## Survival (tau=180 days)",
-        "（何を測るか / What this measures: 6ヶ月後も残っている行の割合。1.0に近い=書いたものが残り続けている — the share of lines still present after 6 months. Near 1.0 = what was written keeps living.)",
-        f"- {_fmt_metric_block(report.get('survival'))}",
+        f"- {_fmt_metric_block(report.get('survival'))} — 6ヶ月後も残っている行の割合（1.0に近い=残り続けている）/ share of lines still present after 6 months (near 1.0 = keeps living)",
     ]
     lines += ["", *(_fmt_context_lines(report.get("context_profile")))]
     lines += ["", *readers_guide_lines()]
@@ -201,11 +219,11 @@ def _fmt_context_lines(ctx: dict[str, Any] | None) -> list[str]:
 
     lines = [
         "## Context profile (observational; not a ranking)",
-        "（このrepoのかたち / The shape of this repo: 協働・活動密度・プロセスの分類。序列ではなく、数値の読み方を条件付ける文脈 — collaboration, activity density, and process classification. Not a ranking; context that conditions how to read the numbers.)",
         (
             f"- collaboration: {val('collaboration_class')} "
             f"({val('resolved_human_actors')} resolved human actors; "
             f"top actor share {val('top_actor_share')} ratio)"
+            " — 協働のかたち / shape of collaboration"
         ),
         (
             f"- lifecycle: {val('lifecycle_stage')} "
@@ -213,8 +231,8 @@ def _fmt_context_lines(ctx: dict[str, Any] | None) -> list[str]:
             f"days_since_last_human_commit {val('days_since_last_human_commit')} = 最終コミットからの日数 / days since the last human commit; "
             f"repo age {val('repo_age_days')} days)"
         ),
-        f"- process: pr_flow_share {val('pr_flow_share')} ratio; conventional subjects {val('conventional_commit_share')} ratio",
-        f"- languages (touch-share): {_fmt_langs(val('language_composition'))}",
+        f"- process: pr_flow_share {val('pr_flow_share')} ratio (PRマージ経由 / via PR merges); conventional subjects {val('conventional_commit_share')} ratio (定型件名 / conventional subjects)",
+        f"- languages (touch-share): {_fmt_langs(val('language_composition'))} — 言語構成（接触比率）/ language mix by path touches",
     ]
     return lines
 
@@ -276,7 +294,7 @@ def _fmt_rework_lines(obs: dict[str, Any] | None) -> list[str]:
                 f"- corrective rework (observational, subject-convention dependent; "
                 f"not an evidence claim): {corr.get('value')} {corr.get('unit')} "
                 f"({corr.get('corrective_commits')} of {corr.get('population')} "
-                f"commits; {window} day window)"
+                f"commits; {window} day window) — 作った直後の手直し傾向。バグ数でも品質でもない / tendency of immediate rework; not a bug count, not quality"
             )
             lines.append(
                 "- limit: corrective rework is fresh-work stability "
@@ -306,6 +324,7 @@ def _fmt_rework_lines(obs: dict[str, Any] | None) -> list[str]:
             "- path retouch (observational, not an evidence claim): "
             f"{touch.get('value')} {touch.get('unit')} "
             f"({touch.get('retouch_commits')} of {touch.get('population')} commits)"
+            " — 同じファイルを21日窓で再び触れた割合 / share re-touching the same files within 21 days"
         )
     return lines or ["- observed"]
 

{grift_cli-0.5.8 → grift_cli-0.5.9}/src/tep_core/version.py

@@ -1,6 +1,6 @@
-__version__ = "0.5.8"
+__version__ = "0.5.9"
 REPORT_SCHEMA_VERSION = "report-v1"
-DEFINITION_VERSION = "tep-v0.5.8-2026-08-25"
+DEFINITION_VERSION = "tep-v0.5.9-2026-08-25"
 ORIGIN_DEFINITION_VERSION = "origin-v1.1-2026-08-22"
 ACTIVITY_DEFINITION_VERSION = "activity-v1-2026-08-16"
 CORE_ACTIVITY_DEFINITION_VERSION = "core-activity-v1-2026-08-16"

grift_cli-0.5.9/tests/test_gloss_gates.py

@@ -0,0 +1,210 @@
+"""v0.5.9 review gates (提唱者 2026-08-25):
+(1) gloss unit alignment — every glossed line's unit must appear in the gloss
+(2) gloss vocabulary gate — no normative words (良い/悪い/優れ/劣る/健全/理想/...)
+(3) report.json immutability — glosses live in markdown only
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from tep_core.analyze import analyze_repository
+from tep_core.identity import empty_identity
+from tep_core.lineage import Lineage
+from tep_core.report import (
+    _ORIGIN_GLOSS,
+    render_markdown,
+)
+
+from git_fixture import commit, init_repo
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def _repo_report(tmp_path: Path):
+    repo = init_repo(tmp_path / "repo")
+    (repo / "pyproject.toml").write_text(
+        '[project]\nname = "d"\ndependencies = ["pytest"]\n', encoding="utf-8"
+    )
+    (repo / "tests").mkdir()
+    for index in range(24):
+        commit(
+            repo,
+            email="a@example.com",
+            date="2026-01-05",
+            message=f"feat: {index}",
+            filename="app.py",
+        )
+        if index % 2 == 0:
+            commit(
+                repo,
+                email="a@example.com",
+                date="2026-01-05",
+                message=f"test: {index}",
+                filename="tests/t.py",
+            )
+    return analyze_repository(repo, empty_identity(), Lineage(), scope="repo")
+
+
+# --- (1) unit alignment ----------------------------------------------------
+
+UNIT_TOKENS = (
+    "commits",
+    "days",
+    "ratio",
+    "actors",
+    "class",
+    "boolean",
+    "tags",
+    "dirs",
+    "manifests",
+    "markers",
+    "date",
+    "month-range",
+    "releases",
+)
+# lines whose VALUE unit must be echoed by the gloss: map line-prefix → required token(s)
+_UNIT_EXPECTATIONS = [
+    # origin classes are all "commits"
+    ("tenant_unique:", "コミット"),
+    ("unresolved:", "コミット"),
+    ("bot:", "コミット"),
+    ("generated_or_vendor:", "コミット"),
+    ("ambiguous_origin:", "コミット"),
+    ("tenant_derivative:", "コミット"),
+    ("external_upstream_contribution:", "コミット"),
+    ("template_inherited:", "コミット"),
+    # activity
+    ("tenant commits:", "コミット"),
+    ("active days:", "日数"),
+    ("commits per active day:", "密度"),
+    ("active days (13 weeks):", "日数"),
+]
+
+
+def test_1_origin_glosses_carry_commit_unit() -> None:
+    for name, gloss in _ORIGIN_GLOSS.items():
+        if name in ("tenant_merge_or_sync", "upstream_sync"):
+            continue  # flow-path glosses; line unit still commits but gloss is route
+        assert "コミット" in gloss, f"{name}: gloss lacks コミット unit: {gloss}"
+        assert "commits" in gloss or "PR" in gloss or "upstream" in gloss, (
+            f"{name}: gloss lacks en unit"
+        )
+
+
+def test_1_every_glossed_line_echoes_its_unit(tmp_path: Path) -> None:
+    report = _repo_report(tmp_path)
+    markdown = render_markdown(report)
+    for line in markdown.splitlines():
+        if "—" not in line or not line.startswith("- "):
+            continue
+        gloss = line.split("—", 1)[1]
+        for prefix, token in _UNIT_EXPECTATIONS:
+            if prefix in line.split("—")[0]:
+                assert token in gloss, f"unit mismatch: {line.strip()[:80]}"
+
+
+# --- (2) gloss vocabulary gate -----------------------------------------------
+
+NORMATIVE = [
+    "良い",
+    "悪い",
+    "優れ",
+    "劣る",
+    "健全",
+    "理想",
+    "優秀",
+    "優劣",
+    "質が高",
+    "質が低",
+    "excellent",
+    "superior",
+    "inferior",
+    "healthy",
+    "ideal",
+    "good,",
+    "bad,",
+]
+
+
+def test_2_glosses_carry_no_normative_words(tmp_path: Path) -> None:
+    report = _repo_report(tmp_path)
+    markdown = render_markdown(report)
+    for line in markdown.splitlines():
+        if "—" not in line:
+            continue
+        gloss = line.split("—", 1)[1]
+        for word in NORMATIVE:
+            assert word not in gloss, f"normative word {word!r} in gloss: {gloss.strip()[:60]}"
+
+
+def test_2_gloss_dictionary_clean() -> None:
+    for name, gloss in _ORIGIN_GLOSS.items():
+        for word in NORMATIVE:
+            assert word not in gloss, f"{name}: {word!r} in {gloss!r}"
+
+
+# --- (3) report.json immutability --------------------------------------------
+
+
+def test_3_report_json_has_no_gloss(tmp_path: Path) -> None:
+    report = _repo_report(tmp_path)
+    text = json.dumps(report, ensure_ascii=False)
+    for marker in ("—", "何を測るか", "このrepoのかたち", "gloss"):
+        assert marker not in text, f"report.json carries markdown gloss marker {marker!r}"
+    # schema untouched
+    assert report["schema_version"] == "report-v1"
+
+
+def test_3_verify_unaffected_by_glosses(tmp_path: Path) -> None:
+    """Glosses are markdown-only decoration: verify recomputes the report dict
+    and must return VERIFIED even after rendering the markdown."""
+    import copy
+    import json as _json
+
+    from tep_core.verify import VERIFIED, verify_report
+
+    report = _repo_report(tmp_path)
+    before = copy.deepcopy(report)
+    render_markdown(report)
+    assert report == before, "render_markdown must not mutate the report dict"
+    path = tmp_path / "report.json"
+    path.write_text(_json.dumps(report), encoding="utf-8")
+    outcome = verify_report(path, tmp_path / "repo")
+    assert outcome.status == VERIFIED
+
+
+def test_4_shared_block_stays_gloss_free(tmp_path: Path) -> None:
+    """(4) spec: Shared block carries no glosses (paste-friendly compactness)."""
+    from tep_core.report import shared_block as _sb
+
+    report = _repo_report(tmp_path)
+    for line in _sb(report):
+        assert "—" not in line, f"shared block line carries a gloss: {line}"
+
+
+def test_g1_no_standalone_paren_note_lines(tmp_path: Path) -> None:
+    """G-1: section-header parenthetical notes are forbidden — glosses live
+    on value lines only (Test frameworks used to double-print the note)."""
+    report = _repo_report(tmp_path)
+    markdown = render_markdown(report)
+    for line in markdown.splitlines():
+        stripped = line.strip()
+        assert not (stripped.startswith("（") and stripped.endswith("）")), (
+            f"standalone paren note line present: {stripped[:50]}"
+        )
+
+
+def test_g1_no_immediate_duplicate_gloss_lines(tmp_path: Path) -> None:
+    """G-1: a repo with detected frameworks must not print the same gloss
+    twice in a row (header note + value line duplication pattern)."""
+    report = _repo_report(tmp_path)
+    markdown = render_markdown(report)
+    lines = markdown.splitlines()
+    for i in range(len(lines) - 1):
+        if "—" in lines[i] and "—" in lines[i + 1]:
+            g1 = lines[i].split("—", 1)[1].strip()
+            g2 = lines[i + 1].split("—", 1)[1].strip()
+            if g1 and g1 == g2:
+                raise AssertionError(f"consecutive duplicate glosses: {g1[:50]}")

{grift_cli-0.5.8 → grift_cli-0.5.9}/tests/test_ux_v057.py

@@ -135,14 +135,19 @@ def test_report_md_carries_meaning_one_liners(tmp_path, capsys):
     from tep_core.report import render_markdown
 
     markdown = render_markdown(report)
-    assert "何を測るか / What this measures" in markdown
-    assert "本番コードを変えたコミットのうち" in markdown and "share of production-changing commits" in markdown
-    assert "バグ件数でも品質でもなく" in markdown and "not a bug count" in markdown
-    assert "このrepoのかたち / The shape of this repo" in markdown
-    assert "直近180日で人がコミットした日数" in markdown and "unique days with human commits" in markdown
-    # reader's guide is bilingual too
+    # v0.5.8+: glosses are INLINE on each value line (not section-level)
+    assert "share of production changes paired with tests in the same commit" in markdown
+    assert "not a bug count, not quality" in markdown
+    assert "share of lines still present after 6 months" in markdown
+    assert "shape of collaboration" in markdown
+    assert "unique days with human commits in the last 180 days" in markdown
+    assert "commits by identity-matched people" in markdown
+    # reader's guide is bilingual
     assert "## この数値でしてはいけない判断 / Decisions these numbers must NOT be used for" in markdown
     assert "not grades" in markdown and "non-compliant with the TEP norms" in markdown
+    # no leftover section-level explanation blocks
+    assert "（何を測るか / What this measures" not in markdown
+    assert "（このrepoのかたち / The shape of this repo" not in markdown
 
 
 def test_49_open_fallback_without_gh(tmp_path, capsys, monkeypatch):