grift-cli 0.5.0__tar.gz

grift_cli-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  schedule:
+    - cron: "0 6 * * 1"
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Unit tests
+        run: python -m pytest tests -m "not golden"
+
+  golden:
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Golden corpus
+        env:
+          TEP_GOLDEN: "1"
+        run: python -m pytest tests/test_golden.py -m golden

grift_cli-0.5.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Unit tests
+        run: python -m pytest tests -m "not golden"
+
+  publish:
+    needs: test
+    if: github.repository == 'Cor-Incorporated/grift-cli'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

grift_cli-0.5.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+venv/
+.pytest_cache/
+.coverage
+htmlcov/
+.golden-cache/
+.corpus-cache/
+corpus/runs/results.jsonl
+.ruff_cache/
+*.whl
+.DS_Store
+.hygiene-needles.txt

grift_cli-0.5.0/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+形式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/)。バージョンは SemVer。
+
+タグ・PyPI・リポ public 化は本ファイルの記載対象外（人間ゲート）。
+
+## [0.5.0] — 2026-08-22
+
+定義Bの節目（`--scope`・参照分布 v2026.09・解釈層）。行レベル rework は v0.6 予約のまま。
+
+### Added
+
+- `--scope tenant|repo`。tenant は証拠、repo はプロセス観測と参照分布。混ぜると `ScopeMismatchError`
+- 参照分布 v2026.09（repo スコープ）。n<30 の指標は位置を出さない
+- survival（`--survival`、τ=180日）。参照分布は v2027 予定
+- 公開コーパス pin（A/B/C/D、SHA 固定）。リーグテーブルは同梱しない
+
+### Changed
+
+- `corrective_rework_rate` を evidence_claim から観測専用へ降格（件名規約依存の交絡）
+- git log の非 UTF-8 を `errors="replace"` で落とさない
+- コマンド名を `grift` に確定（method=TEP / tool=grift）。旧 `tep` エントリは置かない
+- PyPI 配布名を `grift-cli` に確定（公開操作は人間ゲート）
+- H-5: 母数<20 では ratio と十分位を両方出さない（`insufficient_population`、件数の生表示のみ）
+
+### Discriminant (verbatim from `corpus/DISCRIMINANT-v2026.09.md` Run 2)
+
+- `test_cochange A vs D` → `inconclusive_small_n`
+- `test_cochange A vs C` → `separated`
+- `corrective_rework A vs C` → `fail_tier2`
+
+## [0.1.1] — 2026-08-22
+
+origin 語彙の P0 修正（検収合格 SHA `e954b16`）。ローカルタグ `v0.1.1` は未 push。v0.5.0 に一本化するかは代表判断。
+
+## [0.1.0] — 2026-08-21
+
+origin / activity の決定論的レポート。ゴールデン G1–G5。LLM なし。

grift_cli-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TEP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

grift_cli-0.5.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.5
+Name: grift-cli
+Version: 0.5.0
+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
+License: MIT
+License-File: LICENSE
+Keywords: evidence,git,origin,provenance,tep
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# grift — AI時代に痩せない証拠
+
+**日本語** | [English](README.en.md)
+
+Method = **TEP** / Tool = **grift**（CodeScene 型の二層。方法論名は TEP、コマンドは `grift`）。
+Named after the Grift product line.
+
+量は誰でも作れる。残るものと、検証が伴った変更を測る。技量スコアではない。
+
+コミット数・行数・「活動量」は、エージェントと生成コードの時代に簡単に膨らむ。grift は git だけから、TEP の帰属（誰の仕事か）と検証層（test co-change ほか）を**決定論的に**出す。LLM は使わない。合成スコアも等級語彙も出さない。
+
+## 5分で始める
+
+```bash
+pipx install grift-cli
+grift analyze ./my-repo --scope repo
+```
+
+- `--scope tenant`（既定）: `.tep/identity.toml` に載った人の仕事 = **証拠用**
+- `--scope repo`: bot 以外の全人間コミット = **プロセス観測・参照分布用**
+
+参照分布 v2026.09 は **repo スコープ同士**でのみ照合する。tenant の値を repo 分布に載せない（混ぜたら分布が嘘になる）。
+
+## 実レポート例
+
+自リポで `grift analyze . --format md` を実行する。各数値に単位と provenance（method=TEP・tool=grift・定義版・分析 SHA・`analysis_scope`）が付く。
+
+例（click、tenant スコープ。ゴールデン G1）:
+
+- test co-change: 0.2664 ratio（73 of 274）
+- corrective rework: 0.0109 ratio（3 of 274）— 観測値。証拠主張ではない
+- path retouch: 0.573 ratio — 観測のみ
+
+母数 20 未満では率も分布位置も出さない（`insufficient_population`。件数の生表示のみ）。
+
+## 指標と限界
+
+| 指標 | 何の証拠か | 限界 |
+|---|---|---|
+| origin / 帰属 | 誰の仕事か | identity 未設定は unresolved。Cor 実メールは同梱しない |
+| test co-change | 本番変更にテストが伴うか | テスト基盤なしは not_observed。母数<20 は率も十分位も出さない（`insufficient_population`） |
+| corrective rework | 件名が fix/revert の直近パス回帰（観測） | **証拠主張から降格**。件名規約依存の交絡あり。バグ件数ではない。再挑戦は v0.6 行レベル |
+| path retouch | 同一ファイル再接触 | 観測のみ。証拠主張に使わない |
+| survival (τ=180d) | 行の残り方 | `--survival` のみ。参照分布は **v2027 予定**。今回の公開分布には含めない |
+
+参照位置は「第N十分位」の1行だけ。n<30 の指標は位置を出さない（`reference_too_small`）。v2026.09 の観測 n: test co-change 33 / corrective rework 42（観測）/ survival 0。
+
+## 判別力の現況（repo スコープ・基準 `5f2665e`）
+
+出典: `corpus/DISCRIMINANT-v2026.09.md` Run 2。verdict はファイルから逐語。
+
+- `test_cochange A vs C` → `separated`（median_A 0.2379, median_other 0.0306, gap 0.2073, Cliff δ 0.7143, n 18/7）
+- `test_cochange A vs D` → `inconclusive_small_n`（n 18/1。D の narratable 観測が 1）
+- `corrective_rework A vs C` → `fail_tier2`（median_A 0.0522, median_other 0.1063, gap -0.0541, Cliff δ -0.7083, n 18/8）。観測診断のみ。証拠主張には使わない
+- survival: 本コーパスでは未計測。参照分布は v2027 予定
+
+WP4 Run 1 の記録（`separated` / `inconclusive_small_n` / `fail_tier2`）は同ファイルに履歴として残してある。
+
+## 倫理
+
+- 実在個人のスコアカード・順位表は公開も内部共有も禁止
+- 等級語彙（シニア/ジュニア/素晴らしい）を出さない
+- コーパスの manifest（リポ名+SHA）は再現用に公開してよい。**個別リポ値のリーグテーブルは公開しない**
+- 対照群 E（私的 ground truth）はこのリポに入れない
+
+## 公開状態
+
+- 公開リポ: https://github.com/Cor-Incorporated/grift-cli
+- コマンド名: **`grift`**（方法論名 TEP はレポートに残す）
+- PyPI: 配布名 **`grift-cli`**。本公開は別ゲート（未了ならソースから `pipx install .`）
+
+## License
+
+MIT. See [LICENSE](LICENSE).

grift_cli-0.5.0/README.en.md

@@ -0,0 +1,76 @@
+# grift — evidence that does not inflate in the AI era
+
+[日本語](README.md) | **English**
+
+Method = **TEP** / Tool = **grift** (two-layer naming, CodeScene-style: the methodology stays TEP; the command is `grift`).
+Named after the Grift product line.
+
+Anyone can produce volume. This tool measures what remains, and which changes came with verification. It is not a skill score.
+
+Commit counts, line counts, and “activity” inflate easily once agents and generated code are in the loop. grift reads git only and emits TEP provenance (whose work) and a verification layer (test co-change and related metrics) **deterministically**. No LLM. No composite score. No skill-rank labels.
+
+## Start in five minutes
+
+```bash
+pipx install grift-cli
+grift analyze ./my-repo --scope repo
+```
+
+If the package is not on PyPI yet: `pipx install .`
+
+- `--scope tenant` (default): work matched in `.tep/identity.toml` = **evidence**
+- `--scope repo`: all non-bot human commits = **process observation and reference distributions**
+
+Reference distribution v2026.09 is compared **only at repo scope**. Do not plot tenant values on the repo distribution (mixing scopes makes the distribution a lie).
+
+## Example report
+
+Run `grift analyze . --format md` on your own repository. Every number carries a unit and provenance (method=TEP, tool=grift, definition version, analyzed SHA, `analysis_scope`).
+
+Example (click, tenant scope, golden G1):
+
+- test co-change: 0.2664 ratio (73 of 274)
+- corrective rework: 0.0109 ratio (3 of 274) — observational; not an evidence claim
+- path retouch: 0.573 ratio — observational only
+
+Below population 20, neither the rate nor a distribution position is shown (`insufficient_population`; raw counts only).
+
+## Metrics and limits
+
+| Metric | What it is evidence of | Limit |
+|---|---|---|
+| origin / attribution | whose work | unset identity → unresolved. Real tenant emails are not shipped |
+| test co-change | whether production changes came with tests | no test substrate → `not_observed`. population < 20 → no rate and no decile (`insufficient_population`) |
+| corrective rework | recent-path return with a fix/revert subject (observational) | **demoted from evidence claim**. confounded by subject conventions. not a bug count. line-level retry is v0.6 |
+| path retouch | same-file re-touch | observational only. not an evidence claim |
+| survival (τ=180d) | whether lines remain | `--survival` only. reference distribution planned for **v2027**. not in this public distribution |
+
+Reference position is a single “decile N” line. Metrics with n<30 omit position (`reference_too_small`). v2026.09 measured n: test co-change 33 / corrective rework 42 (observational) / survival 0.
+
+## Discriminatory power (repo scope, criteria `5f2665e`)
+
+Source: `corpus/DISCRIMINANT-v2026.09.md` Run 2. Verdicts copied **verbatim** from the file.
+
+- `test_cochange A vs C` → `separated` (median_A 0.2379, median_other 0.0306, gap 0.2073, Cliff δ 0.7143, n 18/7)
+- `test_cochange A vs D` → `inconclusive_small_n` (n 18/1; D has 1 narratable observation)
+- `corrective_rework A vs C` → `fail_tier2` (median_A 0.0522, median_other 0.1063, gap -0.0541, Cliff δ -0.7083, n 18/8). diagnostic only; not an evidence claim
+- survival: not measured in this corpus. reference distribution planned for v2027
+
+WP4 Run 1 (`separated` / `inconclusive_small_n` / `fail_tier2`) is kept as history in the same file.
+
+## Ethics
+
+- Named-person scorecards and league tables are forbidden, publicly and internally
+- Do not emit skill-rank labels (senior / junior / “excellent”)
+- Corpus manifests (repo name + SHA) may be published for reproduction. **Per-repo value league tables are not published**
+- Control group E (private ground truth) is not in this repository
+
+## Status
+
+- Public repository: https://github.com/Cor-Incorporated/grift-cli
+- Command name: **`grift`** (methodology name TEP remains on reports)
+- PyPI: distribution name **`grift-cli`**. Publishing is a separate human gate (until then, `pipx install .`)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

grift_cli-0.5.0/README.md

@@ -0,0 +1,74 @@
+# grift — AI時代に痩せない証拠
+
+**日本語** | [English](README.en.md)
+
+Method = **TEP** / Tool = **grift**（CodeScene 型の二層。方法論名は TEP、コマンドは `grift`）。
+Named after the Grift product line.
+
+量は誰でも作れる。残るものと、検証が伴った変更を測る。技量スコアではない。
+
+コミット数・行数・「活動量」は、エージェントと生成コードの時代に簡単に膨らむ。grift は git だけから、TEP の帰属（誰の仕事か）と検証層（test co-change ほか）を**決定論的に**出す。LLM は使わない。合成スコアも等級語彙も出さない。
+
+## 5分で始める
+
+```bash
+pipx install grift-cli
+grift analyze ./my-repo --scope repo
+```
+
+- `--scope tenant`（既定）: `.tep/identity.toml` に載った人の仕事 = **証拠用**
+- `--scope repo`: bot 以外の全人間コミット = **プロセス観測・参照分布用**
+
+参照分布 v2026.09 は **repo スコープ同士**でのみ照合する。tenant の値を repo 分布に載せない（混ぜたら分布が嘘になる）。
+
+## 実レポート例
+
+自リポで `grift analyze . --format md` を実行する。各数値に単位と provenance（method=TEP・tool=grift・定義版・分析 SHA・`analysis_scope`）が付く。
+
+例（click、tenant スコープ。ゴールデン G1）:
+
+- test co-change: 0.2664 ratio（73 of 274）
+- corrective rework: 0.0109 ratio（3 of 274）— 観測値。証拠主張ではない
+- path retouch: 0.573 ratio — 観測のみ
+
+母数 20 未満では率も分布位置も出さない（`insufficient_population`。件数の生表示のみ）。
+
+## 指標と限界
+
+| 指標 | 何の証拠か | 限界 |
+|---|---|---|
+| origin / 帰属 | 誰の仕事か | identity 未設定は unresolved。Cor 実メールは同梱しない |
+| test co-change | 本番変更にテストが伴うか | テスト基盤なしは not_observed。母数<20 は率も十分位も出さない（`insufficient_population`） |
+| corrective rework | 件名が fix/revert の直近パス回帰（観測） | **証拠主張から降格**。件名規約依存の交絡あり。バグ件数ではない。再挑戦は v0.6 行レベル |
+| path retouch | 同一ファイル再接触 | 観測のみ。証拠主張に使わない |
+| survival (τ=180d) | 行の残り方 | `--survival` のみ。参照分布は **v2027 予定**。今回の公開分布には含めない |
+
+参照位置は「第N十分位」の1行だけ。n<30 の指標は位置を出さない（`reference_too_small`）。v2026.09 の観測 n: test co-change 33 / corrective rework 42（観測）/ survival 0。
+
+## 判別力の現況（repo スコープ・基準 `5f2665e`）
+
+出典: `corpus/DISCRIMINANT-v2026.09.md` Run 2。verdict はファイルから逐語。
+
+- `test_cochange A vs C` → `separated`（median_A 0.2379, median_other 0.0306, gap 0.2073, Cliff δ 0.7143, n 18/7）
+- `test_cochange A vs D` → `inconclusive_small_n`（n 18/1。D の narratable 観測が 1）
+- `corrective_rework A vs C` → `fail_tier2`（median_A 0.0522, median_other 0.1063, gap -0.0541, Cliff δ -0.7083, n 18/8）。観測診断のみ。証拠主張には使わない
+- survival: 本コーパスでは未計測。参照分布は v2027 予定
+
+WP4 Run 1 の記録（`separated` / `inconclusive_small_n` / `fail_tier2`）は同ファイルに履歴として残してある。
+
+## 倫理
+
+- 実在個人のスコアカード・順位表は公開も内部共有も禁止
+- 等級語彙（シニア/ジュニア/素晴らしい）を出さない
+- コーパスの manifest（リポ名+SHA）は再現用に公開してよい。**個別リポ値のリーグテーブルは公開しない**
+- 対照群 E（私的 ground truth）はこのリポに入れない
+
+## 公開状態
+
+- 公開リポ: https://github.com/Cor-Incorporated/grift-cli
+- コマンド名: **`grift`**（方法論名 TEP はレポートに残す）
+- PyPI: 配布名 **`grift-cli`**。本公開は別ゲート（未了ならソースから `pipx install .`）
+
+## License
+
+MIT. See [LICENSE](LICENSE).

grift_cli-0.5.0/corpus/DISCRIMINANT-v2026.09.md

@@ -0,0 +1,130 @@
+# Discriminant v2026.09 (repo scope)
+
+Criteria: `docs/corpus-protocol.md` (registered `5f2665e`) plus WP4 A vs C.
+No per-repo league table. reverse direction → kill.
+Historical runs are kept below; they are not rewritten.
+
+## Run 2 (WP1b-4, 2026-08-22)
+
+- ok rows: 47 (failures: 0)
+- groups: A=22, B=7, C=11, D=7
+- analysis_scope: repo (all rows)
+- WP1b-1: `corrective_rework` is observational (not an evidence claim). The
+  comparison is retained as a diagnostic, not as a promotion criterion.
+
+| comparison | verdict | n | gap | Cliff δ |
+|---|---|---|---|---|
+| test_cochange A vs D | inconclusive_small_n | 18/1 | None | None |
+| test_cochange A vs C | separated | 18/7 | 0.2073 | 0.7143 |
+| corrective_rework A vs C | fail_tier2 | 18/8 | -0.0541 | -0.7083 |
+
+```json
+[
+  {
+    "metric": "test_cochange A vs D",
+    "verdict": "inconclusive_small_n",
+    "n_A": 18,
+    "n_other": 1
+  },
+  {
+    "metric": "test_cochange A vs C",
+    "verdict": "separated",
+    "median_A": 0.2379,
+    "median_other": 0.0306,
+    "gap": 0.2073,
+    "range_A": [
+      0.1113,
+      0.4964
+    ],
+    "range_other": [
+      0.0,
+      0.4154
+    ],
+    "contained": false,
+    "cliffs_delta": 0.7143,
+    "n_A": 18,
+    "n_other": 7
+  },
+  {
+    "metric": "corrective_rework A vs C",
+    "verdict": "fail_tier2",
+    "median_A": 0.0522,
+    "median_other": 0.1063,
+    "gap": -0.0541,
+    "range_A": [
+      0.0,
+      0.1499
+    ],
+    "range_other": [
+      0.047,
+      0.1971
+    ],
+    "contained": false,
+    "cliffs_delta": -0.7083,
+    "n_A": 18,
+    "n_other": 8
+  }
+]
+```
+
+## Run 1 (WP4, 2026-08-21) — historical, not overwritten
+
+- ok rows: 31
+- groups: A=9, B=7, C=8, D=7
+
+| comparison | verdict | n | gap | Cliff δ |
+|---|---|---|---|---|
+| test_cochange A vs D | inconclusive_small_n | 8/1 | None | None |
+| test_cochange A vs C | separated | 8/4 | 0.1609 | 1.0 |
+| corrective_rework A vs C | fail_tier2 | 8/5 | -0.0345 | -0.6 |
+
+corrective_rework 低 ≠ バグが少ない（fresh-work stability）。
+
+```json
+[
+  {
+    "metric": "test_cochange A vs D",
+    "verdict": "inconclusive_small_n",
+    "n_A": 8,
+    "n_other": 1
+  },
+  {
+    "metric": "test_cochange A vs C",
+    "verdict": "separated",
+    "median_A": 0.1683,
+    "median_other": 0.0075,
+    "gap": 0.1609,
+    "range_A": [
+      0.1113,
+      0.4964
+    ],
+    "range_other": [
+      0.0,
+      0.0369
+    ],
+    "contained": false,
+    "cliffs_delta": 1.0,
+    "n_A": 8,
+    "n_other": 4
+  },
+  {
+    "metric": "corrective_rework A vs C",
+    "verdict": "fail_tier2",
+    "median_A": 0.0581,
+    "median_other": 0.0926,
+    "gap": -0.0345,
+    "range_A": [
+      0.0,
+      0.1063
+    ],
+    "range_other": [
+      0.047,
+      0.1951
+    ],
+    "contained": false,
+    "cliffs_delta": -0.6,
+    "n_A": 8,
+    "n_other": 5
+  }
+]
+```