grift-cli 0.5.2__tar.gz → 0.5.4__tar.gz

{grift_cli-0.5.2 → grift_cli-0.5.4}/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 タグ・PyPI・リポ public 化は本ファイルの記載対象外（人間ゲート）。
 
+## [0.5.4] — 2026-08-23
+
+`grift report` の stale 出力問題を解消 + 表示の版残存を一掃。
+
+### Fixed
+
+- **`grift report`（引数なし）は既存の `./out/report.json` があっても常に現在の HEAD を再分析**する（提唱者実測で検出: 旧仕様は既存 JSON を再表示し、2コミット目以降の SHA が古いまま残った — 自己証明の罹患として重大）。再分析なしの再レンダリングは引数指定時のみ
+- README 日英: Action 使用例を `@v0.5.4` へ・**PyPI 欄を版に依存しない表記に変更**（「最新 0.5.2」等の古い版番号が残り続ける問題を構造的に解消）・`grift report` を「初回の簡単導線」として条件付きで説明（主 CTA は `grift analyze . --scope repo --out ./out` を維持）
+- action.yml 既定ピンを 0.5.4 へ
+
+## [0.5.3] — 2026-08-23
+
+UX 改善（代表フィードバック）+ 公開 README の整合。
+
+### Changed
+
+- **`grift report`（引数なし）= そのディレクトリを分析して `./out/report.{json,md}` を自動作成**（`out/` がなければ作る）。引数を渡した場合は従来どおり既存 JSON からの再レンダリング（再分析なし）
+- `grift contribute`（引数なし）は `./out/report.json` → `.grift-out/report.json` → `./report.json` を自動探索。無ければ「先に `grift report` を」と案内
+- GitHub Action の使用例を `@v0.5.2` ぼ更新・「本公開は別ゲート」注記を公開済み表示に更新（README 日英）
+
+### Fixed
+
+- hygiene 除外リストに内部調査文書プレフィックス（SMOKE / REREVIEW / RELEASE-REHEARSAL / INTERNAL-PILOT）を追加
+
 ## [0.5.2] — 2026-08-23
 
 基準の憲法（norms / reader's guide / verify）+ 文脈層（context_profile v2・lifecycle-v2）+ corpus v2026.11 + contribute。

{grift_cli-0.5.2 → grift_cli-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: grift-cli
-Version: 0.5.2
+Version: 0.5.4
 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
@@ -40,12 +40,14 @@ Named after the Grift product line.
 
 ```bash
 pipx install grift-cli
-grift analyze ./my-repo --scope repo
+grift analyze ./my-repo --scope repo --out ./out
 ```
 
 - `--scope tenant`（既定）: `.tep/identity.toml` に載った人の仕事 = **証拠用**
 - `--scope repo`: bot 以外の全人間コミット = **プロセス観測・参照分布用**
 
+**初回の簡単導線**: リポジトリ内で `grift report` だけでも現在の HEAD を分析して `./out/report.md` と `report.json` を書き出します（既存の `./out/report.json` があっても常に再分析します）。**確実に指定条件で測りたいとき・CI では `grift analyze . --scope repo --out ./out` を使ってください**（`report` は repo スコープ固定の省略形です）。
+
 参照分布 v2026.09 は **repo スコープ同士**でのみ照合する。tenant の値を repo 分布に載せない（混ぜたら分布が嘘になる）。
 
 ## 実レポート例
@@ -107,7 +109,7 @@ v2026.09 の記録（Run 2: A vs C `separated` ほか）は `corpus/DISCRIMINANT
 ## GitHub Action（観測のみ）
 
 ```yaml
-uses: Cor-Incorporated/grift-cli@v0.5.1
+uses: Cor-Incorporated/grift-cli@v0.5.4
 with:
   scope: repo
 ```
@@ -128,7 +130,7 @@ with:
 
 - 公開リポ: https://github.com/Cor-Incorporated/grift-cli
 - コマンド名: **`grift`**（方法論名 TEP はレポートに残す）
-- PyPI: 配布名 **`grift-cli`**。本公開は別ゲート（未了ならソースから `pipx install .`）
+- PyPI: 配布名 **`grift-cli`**（公開済み: `pipx install grift-cli`・最新版は [PyPI](https://pypi.org/project/grift-cli/) を参照）
 
 ## License
 

{grift_cli-0.5.2 → grift_cli-0.5.4}/README.en.md

@@ -17,10 +17,14 @@ Commit counts, line counts, and “activity” inflate easily once agents and ge
 
 ```bash
 pipx install grift-cli
-grift analyze ./my-repo --scope repo
+grift analyze ./my-repo --scope repo --out ./out
 ```
 
-If the package is not on PyPI yet: `pipx install .`
+**Quickest first run**: inside a repository, `grift report` alone analyzes the
+current HEAD and writes `./out/report.md` and `report.json` (it always
+re-analyzes, even if `./out/report.json` already exists). For explicit
+control and CI, use `grift analyze . --scope repo --out ./out` (`report` is a
+fixed repo-scope shorthand).
 
 - `--scope tenant` (default): work matched in `.tep/identity.toml` = **evidence**
 - `--scope repo`: all non-bot human commits = **process observation and reference distributions**
@@ -82,7 +86,7 @@ The v2026.09 record (Run 2: A vs C `separated` etc.) remains as history in `corp
 ## GitHub Action (observation only)
 
 ```yaml
-uses: Cor-Incorporated/grift-cli@v0.5.1
+uses: Cor-Incorporated/grift-cli@v0.5.4
 with:
   scope: repo
 ```

{grift_cli-0.5.2 → grift_cli-0.5.4}/README.md

@@ -17,12 +17,14 @@ Named after the Grift product line.
 
 ```bash
 pipx install grift-cli
-grift analyze ./my-repo --scope repo
+grift analyze ./my-repo --scope repo --out ./out
 ```
 
 - `--scope tenant`（既定）: `.tep/identity.toml` に載った人の仕事 = **証拠用**
 - `--scope repo`: bot 以外の全人間コミット = **プロセス観測・参照分布用**
 
+**初回の簡単導線**: リポジトリ内で `grift report` だけでも現在の HEAD を分析して `./out/report.md` と `report.json` を書き出します（既存の `./out/report.json` があっても常に再分析します）。**確実に指定条件で測りたいとき・CI では `grift analyze . --scope repo --out ./out` を使ってください**（`report` は repo スコープ固定の省略形です）。
+
 参照分布 v2026.09 は **repo スコープ同士**でのみ照合する。tenant の値を repo 分布に載せない（混ぜたら分布が嘘になる）。
 
 ## 実レポート例
@@ -84,7 +86,7 @@ v2026.09 の記録（Run 2: A vs C `separated` ほか）は `corpus/DISCRIMINANT
 ## GitHub Action（観測のみ）
 
 ```yaml
-uses: Cor-Incorporated/grift-cli@v0.5.1
+uses: Cor-Incorporated/grift-cli@v0.5.4
 with:
   scope: repo
 ```
@@ -105,7 +107,7 @@ with:
 
 - 公開リポ: https://github.com/Cor-Incorporated/grift-cli
 - コマンド名: **`grift`**（方法論名 TEP はレポートに残す）
-- PyPI: 配布名 **`grift-cli`**。本公開は別ゲート（未了ならソースから `pipx install .`）
+- PyPI: 配布名 **`grift-cli`**（公開済み: `pipx install grift-cli`・最新版は [PyPI](https://pypi.org/project/grift-cli/) を参照）
 
 ## License
 

{grift_cli-0.5.2 → grift_cli-0.5.4}/action.yml

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

grift_cli-0.5.4/docs/metrics-guide.md

@@ -0,0 +1,149 @@
+# grift レポートの読み方 — 指標ごとの平易な解説（v1・2026-08-23）
+
+**対象**: grift 0.5.4 以降（指標の定義は全ての 0.5.x で共通）。非エンジニアの方向け。
+**原則の再掲**: すべての数値は**観測された事実の記録**であって、優劣の評価ではありません。単独の数値での合否判断・人と人の比較は TEP 非準拠です（[docs/norms.md](norms.md)）。書かれていないこと（= not observed）は「無かったこと」を意味しません。
+**参考値の出典**: 特に断らない限り、公開リポジトリ 117 件のコーパス（v2026.11・repo スコープ）と v0.5.2 実地調査（requests / flask / GitHub CLI / chalk ほか）に基づきます。参考値は「だいたいの目安」であり、分布は成長とともに新版として出ます。
+
+---
+
+## まず全体の流れ（report.md の構成）
+
+1. **Shared block**: 3-5 行の要約（コピペで共有できる形式）
+2. **Provenance**: いつ・どのコミット・どの定義版で測ったか（再現に必要な情報）
+3. **証拠系**: test co-change（検証を伴った変更の割合）
+4. **観測系**: rework（手戻りの傾向）— 証拠主張ではない
+5. **文脈**: context profile（どんな repo か）
+6. **読み方の注意**（全レポート末尾に自動付与）
+
+2種類のスコープがあります:
+- **tenant スコープ**: identity.toml に載った特定の人の仕事（= 自己証明用）
+- **repo スコープ**: bot 以外の全員のコミット（= repo 全体の姿・参考分布との比較はこちらのみ）
+
+---
+
+## 証拠系: test co-change（テスト同期変更率）
+
+**単位**: ratio（0.0〜1.0）／**母数**: 本番コードを変えたコミット数
+
+### 何を測っているか
+
+「本番のコード（機能・ロジック）を変えたコミットのうち、**同じコミットでテストも変更した**割合」。テストを書く習慣が実際の変更に伴っているかを、申告ではなく git の記録から数えます。ドキュメントだけの変更は母数から除外されます。
+
+### 読み方
+
+- **高い（目安: 0.23 以上 ≒ 分布の上位30%）**: 本番変更にテストが伴う習慣が定着している。変更の意図を後から検証できる状態が保たれやすい
+- **中程度（目安: 0.07〜0.23）**: 多くの公開リポジトリがここにいます（中央値はおよそ 0.11〜0.16）
+- **低い / 0**: テスト基盤が無い・あっても本番変更と同期していない。**ただし「テストを書いていない」=「悪い」ではありません** — ドキュメント中心のリポジトリ、设计のみの期間、ツール類など、テストが前提でない仕事は正当に低くなります
+- **not observed**: テスト基盤そのものが検出できない（framework も tests ディレクトリも無い）場合。観測不能であって 0 ではありません
+
+### 分布の目安（v2026.11・n=68・repo スコープ）
+
+| 位置 | 値の目安 |
+|---|---|
+| 中央値付近（第5十分位） | 約 0.11〜0.16 |
+| 上位30%に入る | 0.23 以上 |
+| 上位10%（第9-10十分位） | 0.49 以上 |
+
+実例: GitHub CLI 0.37 / flask 0.20 / requests 0.12 / chalk 0.18（2026-08 実測）。検証文化で選んだ A クラス repo の中央値は 0.24。
+
+### 十分位（decile）の読み方
+
+`interpretation` に「第N十分位」が出るとき、それは**同じ repo スコープの公開コーパスの中での位置**です（例: 第7十分位 = 下から 70% の位置）。「優秀」の意味ではありません。n≥30 のときだけ表示されます。
+
+---
+
+## 観測系: corrective rework（修正的リワーク率）と path retouch
+
+**単位**: ratio／**母数**: 本番変更コミット数／**注意**: **証拠主張ではありません**（観測専用）
+
+### 何を測っているか
+
+- **corrective rework**: 直近21日以内に触ったファイルを、`fix` / `revert` 等の件名で**すぐにやり直した**コミットの割合。「作った直後に手直しが必要になった頻度」の観測
+- **path retouch**: 同じファイルを21日窓で再び触れた割合（手戻りというより「同じ場所を編集し続けている」傾向）
+
+### 読み方（これは「数値が低い＝優秀」では読まない）
+
+- commit メッセージの慣習（fix を書く文化か）で出方が変わるため、**人と人の比較・合否に使えません**（レポートにも明記されます）
+- 高い値の読み方の例: 検証が無いまま進めて後から直している／活発に試しては直しているフェーズにある — の**いずれとも取れる**ので、面接などでの質問の種に使います（「この期間に何がありましたか?」）
+- 低くても「バグが少ない」の証明にはなりません（バグ件数ではありません）
+
+### 分布の目安（v2026.11・n=101・repo スコープ）
+
+中央値付近 約 0.07〜0.10 ／ 上位側（0.19 以上）で第8-9十分位。A クラス（検証文化）の中央値は 0.05 と低めですが、因果の主張はできません。
+
+---
+
+## survival（行の生存率）— 0.5.x では任意指定
+
+`--survival` を付けたときだけ計算（τ=180日）。**「今も残っている行の割合」**を指数で出します（1.0 に近い = 6ヶ月経ってもほぼ残っている）。
+- 実測例: 小規模運用中 repo で 0.94 — ほぼ全行が残存
+- 参照分布は **v2027 予定**（現時点で高低の判断基準は提供しません）
+
+---
+
+## 文脈: context profile（どんな repo か）
+
+数値の意味は文脈で変わるため、repo の姿を並記します。**すべて分類であって序列ではありません。**
+
+### collaboration_class（協働のかたち）
+
+| クラス | 定義 | 読み方の例 |
+|---|---|---|
+| solo | 最多作成者の比率 90% 以上 | 個人项目。一貫性は保たれやすいが、バス係数（本人がいないと進まない度）は構造的に高い |
+| small_team | 関与者 5 人以下 | 少人数で役割が重なる協働 |
+| community | それ以上 | 多人数。審査プロセス（PR flow）や文書化が効いてきやすい |
+
+実測例: requests 802人 / flask 870人 / GitHub CLI 722人は community。個人開発は solo。
+
+### lifecycle_stage（活動密度）— 一次観測2つが本体
+
+**クラスは便宜であり、必ず生の2数値と併せて読みます**:
+
+- **active_days_180d**: 直近180日のうち、人がコミットした日が何日あったか（≥12 で active）
+- **days_since_last_human_commit**: 最後のコミットから何日経ったか
+
+| クラス | active_days_180d | 読み方の例 |
+|---|---|---|
+| active | 12日以上 | 現在も開発が続いている密度 |
+| maintained | 3〜11日 | 維持運用は続いている（改修・追従） |
+| dormant | 2日以下 | 180日窓ではほぼ静止している |
+
+注意: **密度は「開発 vs 保守」の区別を測れません**（高密度の保守運用も active になります）。一斉ハウスキーピングで「新しそうに見える」のを防ぐため、新しさでなく密度を採っています。
+
+### その他の文脈観測（抜粋）
+
+- **pr_flow_share**: merge コミット（PR マージ）の割合。高い = レビュー流程を経る文化
+- **conventional_commit_share**: `feat:` `fix:` のような定型件名の割合。高い = 変更種別が機械可読な管理
+- **language_composition**: 言語別のファイル接触比率（多言語 repo の判別に）
+- **dependency_manifests**: 依存管理ファイルの種類（複数 = polyglot / monorepo の兆候）
+- **top_actor_share**: 最多作成者の比率（単独性の程度。名前は出ません）
+
+---
+
+## よくある誤読と、してはいけない読み方
+
+| 誤読 | 正しくは |
+|---|---|
+| 「co-change が低い人はテストを書けない人」 | テストが前提でない仕事（docs・設計・ツール）は正当に低くなる。不在・低値を能力の否定として読むのは非準拠（norms 1条） |
+| 「corrective rework が高い = バグが多い人」 | 件名慣習への依存が強く、バグ件数でも品質でもない（観測専用） |
+| 「dormant = 捨てられた repo」 | 保守周期が長いだけの成熟 repo もある。復帰の履歴は gap として可視化されるが、gap を負に読むのは非準拠 |
+| 「第9十分位の人は第5十分位の人より優秀」 | 十分位は同スコープ repo 間の位置のみ。単独足切り・比較表は非準拠（norms 2条） |
+| 「decile が無い = 隠している」 | 母数 <20 か分布 n<30 では出力規則により非表示（insufficient_population / reference_too_small）です |
+
+---
+
+## 数値が出ない（not observed）とき
+
+「0 だった」と「測れなかった」は別物です。主な理由コード:
+
+| reason | 意味 |
+|---|---|
+| `no_test_framework_or_directory` | テスト基盤が検出できない |
+| `insufficient_population` | 母数が 20 コミット未満（率を出さず件数のみ） |
+| `pending_attribution` | identity（誰の仕事か）が未設定 |
+| `scope_is_tenant` | 参照分布は repo スコープ専用のため tenant 実行では付かない |
+| `survival_scan_disabled` | survival は `--survival` 指定時のみ |
+
+---
+
+*本書は docs/report-schema.md（正本・機械検証付き）の平易版です。数値の厳密な定義・単位・符号化は正本を参照してください。参考値の更新は分布の新版（v2026.11 → vNext）とともに行われます。*

{grift_cli-0.5.2 → grift_cli-0.5.4}/pyproject.toml

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

{grift_cli-0.5.2 → grift_cli-0.5.4}/scripts/hygiene_grep.py

@@ -56,6 +56,10 @@ def main() -> int:
             ":!docs/PREPUB*",
             ":!docs/kpi*",
             ":!docs/pilot*",
+            ":!docs/SMOKE*",
+            ":!docs/REREVIEW*",
+            ":!docs/RELEASE-REHEARSAL*",
+            ":!docs/INTERNAL-PILOT*",
         ],
         cwd=ROOT,
         capture_output=True,

{grift_cli-0.5.2 → grift_cli-0.5.4}/src/tep_cli/__main__.py

@@ -16,10 +16,11 @@ from tep_core.verify import CANNOT_VERIFY, MISMATCH, VERIFIED, verify_report
 from tep_core.version import __version__
 
 _EPILOG = """examples:
-  grift analyze . --scope repo
-  grift analyze ./repo --format md --out ./out
+  grift analyze . --scope repo --out ./out
+  grift report             # analyze current HEAD → ./out/report.{json,md} (always re-analyzes)
+  grift report path/report.json    # re-render md from an existing report (no re-analysis)
   grift verify ./out/report.json --repo ./repo
-  grift contribute ./out/report.json --out contribution.json
+  grift contribute         # build opt-in payload from ./out/report.json (never sends)
 詳細: README"""
 
 
@@ -141,11 +142,17 @@ def build_parser() -> argparse.ArgumentParser:
 
     render = sub.add_parser(
         "report",
-        help="Re-render report.md from an existing report.json (no re-analysis)",
+        help="Analyze the current repo and write ./out/report.{json,md}; or re-render md from an existing report.json",
         epilog=_EPILOG,
         formatter_class=argparse.RawDescriptionHelpFormatter,
     )
-    render.add_argument("report_json", type=Path, help="Path to report.json")
+    render.add_argument(
+        "report_json",
+        type=Path,
+        nargs="?",
+        default=None,
+        help="Path to an existing report.json to re-render (default: analyze the current repo into ./out)",
+    )
     render.add_argument(
         "--out",
         type=Path,
@@ -159,7 +166,13 @@ def build_parser() -> argparse.ArgumentParser:
         epilog=_EPILOG,
         formatter_class=argparse.RawDescriptionHelpFormatter,
     )
-    contribute.add_argument("report_json", type=Path, help="Path to a repo-scope report.json")
+    contribute.add_argument(
+        "report_json",
+        type=Path,
+        nargs="?",
+        default=None,
+        help="Path to a repo-scope report.json (default: search ./out, .grift-out, ./)",
+    )
     contribute.add_argument(
         "--out",
         type=Path,
@@ -243,11 +256,35 @@ def _run_verify(args: argparse.Namespace) -> int:
     return 2
 
 
+_DEFAULT_REPORT_SEARCH = (
+    Path("out") / "report.json",
+    Path(".grift-out") / "report.json",
+    Path("report.json"),
+)
+
+
+def _resolve_report_path(explicit: Path | None) -> tuple[Path | None, str]:
+    """Return (path, guidance). Search ./out, .grift-out, ./ when no explicit path."""
+    if explicit is not None:
+        return explicit, ""
+    for candidate in _DEFAULT_REPORT_SEARCH:
+        if candidate.is_file():
+            return candidate, ""
+    return None, ""
+
+
 def _run_report(args: argparse.Namespace) -> int:
+    if args.report_json is None:
+        # UX (代表 2026-08-23): bare `grift report` ALWAYS re-analyzes the
+        # current HEAD and rewrites ./out/report.{json,md}. It never falls
+        # back to a stale ./out/report.json — "report で測ったつもりが古い
+        # SHA のまま" は自己証明の罠になるため、既存ファイルは無条件に
+        # 上書きする。再分析なしの再レンダリングは引数指定時のみ。
+        return _analyze_to_out(scope="repo")
     try:
         payload = json.loads(args.report_json.read_text(encoding="utf-8"))
     except (OSError, json.JSONDecodeError) as exc:
-        sys.stderr.write(f"report unreadable: {exc}\n")
+        sys.stderr.write(f"report unreadable ({args.report_json}): {exc}\n")
         return 2
     try:
         markdown = render_markdown(payload)
@@ -263,13 +300,43 @@ def _run_report(args: argparse.Namespace) -> int:
     return 0
 
 
+def _analyze_to_out(*, scope: str = "repo") -> int:
+    """Run the analysis in the current directory and write ./out/report.{json,md}.
+
+    UX (代表 2026-08-23): bare `grift report` should just produce the reports —
+    create ./out if missing. Reuses the analyze pipeline on '.'.
+    """
+    repo = Path(".")
+    if not (repo / ".git").exists():
+        sys.stderr.write("grift: not a git repository (run inside the repo you want to analyze)\n")
+        return 2
+    identity = discover_identity(repo, None)
+    report = analyze_repository(repo, identity, Lineage(), scope=scope)
+    markdown = render_markdown(report)
+    encoded = json.dumps(report, indent=2, ensure_ascii=False) + "\n"
+    out_dir = Path("out")
+    out_dir.mkdir(parents=True, exist_ok=True)
+    (out_dir / "report.json").write_text(encoded, encoding="utf-8")
+    (out_dir / "report.md").write_text(markdown, encoding="utf-8")
+    sys.stdout.write(markdown)
+    sys.stderr.write(f"\nwrote {out_dir / 'report.json'} and {out_dir / 'report.md'}\n")
+    return 0
+
+
 def _run_contribute(args: argparse.Namespace) -> int:
     from tep_core.contribute import CONFIRMATION_TEXT, build_contribution, render_confirmation
 
+    report_path, _guidance = _resolve_report_path(args.report_json)
+    if report_path is None:
+        sys.stderr.write(
+            "contribute: no report.json found (searched ./out/report.json, .grift-out/report.json, ./report.json). "
+            "Run `grift report` first — it will analyze the repo and write ./out/report.json.\n"
+        )
+        return 2
     try:
-        report = json.loads(args.report_json.read_text(encoding="utf-8"))
+        report = json.loads(report_path.read_text(encoding="utf-8"))
     except (OSError, json.JSONDecodeError) as exc:
-        sys.stderr.write(f"report unreadable: {exc}\n")
+        sys.stderr.write(f"report unreadable ({report_path}): {exc}\n")
         return 2
     try:
         payload = build_contribution(report)

{grift_cli-0.5.2 → grift_cli-0.5.4}/src/tep_core/version.py

@@ -1,6 +1,6 @@
-__version__ = "0.5.2"
+__version__ = "0.5.4"
 REPORT_SCHEMA_VERSION = "report-v1"
-DEFINITION_VERSION = "tep-v0.5.2-2026-08-23"
+DEFINITION_VERSION = "tep-v0.5.4-2026-08-23"
 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.4/tests/test_default_report_path.py

@@ -0,0 +1,134 @@
+"""Bare `grift report` / `grift contribute`: default-path search + guidance.
+
+代表 UX feedback (2026-08-23): invoking the subcommands without a path used
+to hard-error on argparse / file-not-found without telling the user what to
+do first. Now they search ./out, .grift-out, ./ and, when nothing is found,
+exit 2 with actionable guidance.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from tep_cli.__main__ import main
+
+from git_fixture import commit, init_repo
+
+
+def _make_report_json(dir_path: Path) -> Path:
+    from tep_core.analyze import analyze_repository
+    from tep_core.identity import empty_identity
+    from tep_core.lineage import Lineage
+
+    repo = init_repo(dir_path / "repo")
+    (repo / "pyproject.toml").write_text(
+        '[project]\nname = "demo"\ndependencies = ["pytest"]\n', encoding="utf-8"
+    )
+    for index in range(12):
+        commit(
+            repo,
+            email="a@example.com",
+            date="2026-01-05",
+            message=f"feat: {index}",
+            filename="app.py",
+        )
+    report = analyze_repository(repo, empty_identity(), Lineage(), scope="repo")
+    target = dir_path / "out" / "report.json"
+    target.parent.mkdir(parents=True, exist_ok=True)
+    target.write_text(json.dumps(report, ensure_ascii=False), encoding="utf-8")
+    return target
+
+
+def test_report_bare_ignores_stale_out_and_reanalyzes(
+    tmp_path: Path, capsys: object, monkeypatch: object
+) -> None:
+    """Critical UX (提唱者 2026-08-23): bare `grift report` with an EXISTING
+    ./out/report.json must RE-ANALYZE the current HEAD, not re-render the
+    stale file."""
+    import json as _json
+    import subprocess as _sp
+
+    from git_fixture import commit as _commit, init_repo as _init
+
+    repo = _init(tmp_path / "repo")
+    (repo / "pyproject.toml").write_text(
+        '[project]\nname = "demo"\ndependencies = ["pytest"]\n', encoding="utf-8"
+    )
+    for index in range(5):
+        _commit(repo, email="a@example.com", date="2026-01-05", message=f"feat: {index}")
+    monkeypatch.chdir(repo)
+    assert main(["report"]) == 0
+    first_sha = _json.loads((repo / "out" / "report.json").read_text())["provenance"][
+        "analyzed_commit_sha"
+    ]
+    _commit(repo, email="a@example.com", date="2026-01-06", message="feat: more")
+    assert main(["report"]) == 0
+    second_sha = _json.loads((repo / "out" / "report.json").read_text())["provenance"][
+        "analyzed_commit_sha"
+    ]
+    assert first_sha != second_sha, "bare report must re-analyze, not re-render stale output"
+    head = _sp.run(
+        ["git", "rev-parse", "HEAD"], capture_output=True, text=True, cwd=repo
+    ).stdout.strip()
+    assert second_sha == head
+    assert "## Shared block" in capsys.readouterr().out
+
+
+def test_report_with_explicit_path_still_re_renders(tmp_path: Path, capsys: object) -> None:
+    """Explicit path keeps the re-render (no re-analysis) contract."""
+    _make_report_json(tmp_path)
+    code = main(["report", str(tmp_path / "out" / "report.json")])
+    assert code == 0
+    assert "## Shared block" in capsys.readouterr().out
+
+
+def test_report_bare_without_prior_output_analyzes_cwd(
+    tmp_path: Path, capsys: object, monkeypatch: object
+) -> None:
+    """UX: bare `grift report` in a git repo with no ./out → analyze now and
+    write ./out/report.{json,md}."""
+    from git_fixture import commit as _commit, init_repo as _init
+
+    repo = _init(tmp_path / "repo")
+    for index in range(3):
+        _commit(repo, email="a@example.com", date="2026-01-05", message=f"feat: {index}")
+    monkeypatch.chdir(repo)
+    code = main(["report"])
+    assert code == 0
+    out = capsys.readouterr()
+    assert "## Shared block" in out.out
+    assert (repo / "out" / "report.json").is_file()
+    assert (repo / "out" / "report.md").is_file()
+
+
+def test_report_bare_outside_git_repo_refused(
+    tmp_path: Path, capsys: object, monkeypatch: object
+) -> None:
+    monkeypatch.chdir(tmp_path)
+    code = main(["report"])
+    assert code == 2
+    assert "not a git repository" in capsys.readouterr().err
+
+
+def test_contribute_bare_without_report_gives_guidance(
+    tmp_path: Path, capsys: object, monkeypatch: object
+) -> None:
+    monkeypatch.chdir(tmp_path)
+    code = main(["contribute"])
+    assert code == 2
+    err = capsys.readouterr().err
+    assert "grift report" in err  # guidance points to the one-step entry
+
+
+def test_contribute_bare_uses_out_default(
+    tmp_path: Path, capsys: object, monkeypatch: object
+) -> None:
+    # repo-scope report in ./out → bare contribute reaches the F-C1 gate
+    _make_report_json(tmp_path)
+    monkeypatch.chdir(tmp_path)
+    code = main(["contribute", "--out", str(tmp_path / "c.json")])  # non-TTY, no --yes
+    assert code == 2  # F-C1 refusal path (not path-resolution error)
+    err = capsys.readouterr().err
+    assert "公開リポジトリに載ります" in err
+    assert "grift analyze . --out ./out" not in err  # found the file; failed on consent instead

{grift_cli-0.5.2 → grift_cli-0.5.4}/tests/test_hygiene.py

@@ -19,6 +19,10 @@ _AUDIT_PREFIXES = (
     "docs/PREPUB",
     "docs/kpi",
     "docs/pilot",
+    "docs/SMOKE",
+    "docs/REREVIEW",
+    "docs/RELEASE-REHEARSAL",
+    "docs/INTERNAL-PILOT",
 )