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

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

@@ -4,6 +4,20 @@
 
 タグ・PyPI・リポ public 化は本ファイルの記載対象外（人間ゲート）。
 
+## [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.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: grift-cli
-Version: 0.5.2
+Version: 0.5.3
 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
@@ -107,7 +107,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.3
 with:
   scope: repo
 ```
@@ -128,7 +128,7 @@ with:
 
 - 公開リポ: https://github.com/Cor-Incorporated/grift-cli
 - コマンド名: **`grift`**（方法論名 TEP はレポートに残す）
-- PyPI: 配布名 **`grift-cli`**。本公開は別ゲート（未了ならソースから `pipx install .`）
+- PyPI: 配布名 **`grift-cli`**（最新 0.5.2 を公開済み: `pipx install grift-cli`）
 
 ## License
 

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

@@ -82,7 +82,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.3
 with:
   scope: repo
 ```

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

@@ -84,7 +84,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.3
 with:
   scope: repo
 ```
@@ -105,7 +105,7 @@ with:
 
 - 公開リポ: https://github.com/Cor-Incorporated/grift-cli
 - コマンド名: **`grift`**（方法論名 TEP はレポートに残す）
-- PyPI: 配布名 **`grift-cli`**。本公開は別ゲート（未了ならソースから `pipx install .`）
+- PyPI: 配布名 **`grift-cli`**（最新 0.5.2 を公開済み: `pipx install grift-cli`）
 
 ## License
 

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

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "grift-cli"
-version = "0.5.2"
+version = "0.5.3"
 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.3}/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.3}/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 report             # analyze the current repo → ./out/report.{json,md}
+  grift report path/report.json   # re-render md from an existing report (no re-analysis)
+  grift analyze . --scope repo --out ./out
   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,33 @@ 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:
+    report_path, _guidance = _resolve_report_path(args.report_json)
+    if report_path is None:
+        # UX (代表 2026-08-23): bare `grift report` in a repo with no prior
+        # output = run the analysis now and write ./out/report.{json,md}.
+        return _analyze_to_out(scope="repo")
     try:
-        payload = json.loads(args.report_json.read_text(encoding="utf-8"))
+        payload = 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:
         markdown = render_markdown(payload)
@@ -263,13 +298,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.3}/src/tep_core/version.py

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

@@ -0,0 +1,114 @@
+"""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_uses_out_default(tmp_path: Path, capsys: object, monkeypatch: object) -> None:
+    _make_report_json(tmp_path)
+    monkeypatch.chdir(tmp_path)
+    code = main(["report"])
+    assert code == 0
+    out = capsys.readouterr().out
+    assert "# TEP analysis" in out
+    assert "## Shared block" in out
+
+
+def test_report_bare_searches_grift_out(
+    tmp_path: Path, capsys: object, monkeypatch: object
+) -> None:
+    _make_report_json(tmp_path)
+    (tmp_path / ".grift-out").mkdir(exist_ok=True)
+    (tmp_path / ".grift-out" / "report.json").write_text(
+        (tmp_path / "out" / "report.json").read_text(encoding="utf-8"), encoding="utf-8"
+    )
+    monkeypatch.chdir(tmp_path / ".grift-out")
+    code = main(["report"])
+    assert code == 0
+
+
+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.3}/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",
 )