grift-cli 0.5.0__tar.gz → 0.5.1__tar.gz

grift_cli-0.5.1/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,27 @@
+name: publish-testpypi
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: testpypi
+    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 TestPyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+        run: |
+          python -m pip install twine
+          python -m twine upload --repository testpypi dist/*

{grift_cli-0.5.0 → grift_cli-0.5.1}/CHANGELOG.md

@@ -4,6 +4,28 @@
 
 タグ・PyPI・リポ public 化は本ファイルの記載対象外（人間ゲート）。
 
+## [0.5.1] — 2026-08-22
+
+WP-P1e 二層契約 + Golden v2 第1波。Grift 本体統合（WP-G1）の unblock マイルストーン。
+
+### Added
+
+- export-v1（`--export <dir>`・opt-in）: commits.ndjson / actors.json / export-meta.json。生メール・生 author 文字列ゼロ出力。per-actor 品質指標は恒久禁止（`docs/export-schema.md`）
+- `docs/report-schema.md`: report-v1 凍結（追加互換）・純stdlib検証器 `tep_core.schema.validate_report`
+- golden G6〜G13 増設（計13本・上限内）: AI共著（claude-code）・引き継ぎ（axios）・dormant（co）・polyglot（pyscript）・テンプレ派生（scvi-tools）・solo（kilo）・founder（httpx）・日本語圏（voicevox）
+- `golden/coverage.md` カバレッジ行列 + HOLE 機械検出（issue 紐付け強制）
+- `docs/persona-answers.md`: 敵対レビュー21問の実数値実演集（転記数値は CI が golden 期待値と機械突合）
+- パリティ検算レシピ（export-schema.md）+ 逐語実行テスト
+- 終了コードと stdout 純度規約（README 日英）
+
+### Fixed
+
+- F-P10-3: identity loader が空・@含有・重複 canonical_id を受理し生メールが export に漏れる producer gap を修正。`CANONICAL_ID_PATTERN`（`^[a-z0-9][a-z0-9._-]{0,63}$`・版管理）で `IdentityValidationError`（CLI は exit 2・export 未書き出し）。schema 文書と実装は逐語一致テストで固定。性質テスト「exit 0 ⇒ export 内 `@` 0 バイト」
+
+### Changed
+
+- `schema_version` を `tep-report-v1` から `report-v1` へ改名（凍結前の最後の変更）
+
 ## [0.5.0] — 2026-08-22
 
 定義Bの節目（`--scope`・参照分布 v2026.09・解釈層）。行レベル rework は v0.6 予約のまま。

{grift_cli-0.5.0 → grift_cli-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: grift-cli
-Version: 0.5.0
+Version: 0.5.1
 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
@@ -48,6 +48,22 @@ grift analyze ./my-repo --scope repo
 
 自リポで `grift analyze . --format md` を実行する。各数値に単位と provenance（method=TEP・tool=grift・定義版・分析 SHA・`analysis_scope`）が付く。
 
+## 終了コードと stdout / stderr 規約
+
+| 終了コード | 意味 |
+|---|---|
+| 0 | 成功 |
+| 2 | 使用法エラー、または指定パスが git リポジトリでない |
+| 1 | その他の予期しない失敗（詳細は stderr） |
+
+`--format json` の stdout は **JSON 1 件のみ**（機械消費向けの純度保証）。`--format md` は markdown のみ、`--format both` は markdown → 空行 → JSON の順。診断とエラーは常に stderr。`--out DIR` を使っても stdout 規約は変わらない（`report.md` / `report.json` の追記のみ）。
+
+report.json の全フィールド定義は [docs/report-schema.md](docs/report-schema.md)（schema `report-v1`・凍結済み・追加互換）。
+
+## 機械取込用 export（opt-in）
+
+`grift analyze <repo> --export <dir>` で commits.ndjson（1行=1コミット・origin/actor/cochange）・actors.json（canonical_id ごとの帰属と活動）・export-meta.json（`config_digest` つき）を書く。**生メールアドレス・生 author 文字列は一切出力しない**。顧客向け叙述に載る数値は report.json の集計値が正。詳細は [docs/export-schema.md](docs/export-schema.md)。
+
 例（click、tenant スコープ。ゴールデン G1）:
 
 - test co-change: 0.2664 ratio（73 of 274）

{grift_cli-0.5.0 → grift_cli-0.5.1}/README.en.md

@@ -35,6 +35,22 @@ Example (click, tenant scope, golden G1):
 
 Below population 20, neither the rate nor a distribution position is shown (`insufficient_population`; raw counts only).
 
+## Exit codes and stdout / stderr contract
+
+| Exit code | Meaning |
+|---|---|
+| 0 | success |
+| 2 | usage error, or the given path is not a git repository |
+| 1 | any other unexpected failure (details on stderr) |
+
+With `--format json`, stdout is **exactly one JSON document** (purity guarantee for machine consumption). `--format md` writes markdown only; `--format both` writes markdown, a blank line, then JSON. Diagnostics and errors always go to stderr. `--out DIR` does not change the stdout contract (it additionally writes `report.md` / `report.json`).
+
+The full field-by-field definition of report.json lives in [docs/report-schema.md](docs/report-schema.md) (schema `report-v1`, frozen, additive-only).
+
+## Machine ingestion export (opt-in)
+
+`grift analyze <repo> --export <dir>` writes commits.ndjson (one row per commit: origin / actor / cochange), actors.json (attribution and engagement per canonical_id), and export-meta.json (with `config_digest`). **No raw emails or author strings are ever exported.** Aggregates in report.json remain authoritative for narrative. Details: [docs/export-schema.md](docs/export-schema.md).
+
 ## Metrics and limits
 
 | Metric | What it is evidence of | Limit |

{grift_cli-0.5.0 → grift_cli-0.5.1}/README.md

@@ -25,6 +25,22 @@ grift analyze ./my-repo --scope repo
 
 自リポで `grift analyze . --format md` を実行する。各数値に単位と provenance（method=TEP・tool=grift・定義版・分析 SHA・`analysis_scope`）が付く。
 
+## 終了コードと stdout / stderr 規約
+
+| 終了コード | 意味 |
+|---|---|
+| 0 | 成功 |
+| 2 | 使用法エラー、または指定パスが git リポジトリでない |
+| 1 | その他の予期しない失敗（詳細は stderr） |
+
+`--format json` の stdout は **JSON 1 件のみ**（機械消費向けの純度保証）。`--format md` は markdown のみ、`--format both` は markdown → 空行 → JSON の順。診断とエラーは常に stderr。`--out DIR` を使っても stdout 規約は変わらない（`report.md` / `report.json` の追記のみ）。
+
+report.json の全フィールド定義は [docs/report-schema.md](docs/report-schema.md)（schema `report-v1`・凍結済み・追加互換）。
+
+## 機械取込用 export（opt-in）
+
+`grift analyze <repo> --export <dir>` で commits.ndjson（1行=1コミット・origin/actor/cochange）・actors.json（canonical_id ごとの帰属と活動）・export-meta.json（`config_digest` つき）を書く。**生メールアドレス・生 author 文字列は一切出力しない**。顧客向け叙述に載る数値は report.json の集計値が正。詳細は [docs/export-schema.md](docs/export-schema.md)。
+
 例（click、tenant スコープ。ゴールデン G1）:
 
 - test co-change: 0.2664 ratio（73 of 274）

grift_cli-0.5.1/corpus/AD-PILOT-20260822.md

@@ -0,0 +1,34 @@
+# A/D 判別力パイロット（2026-08-22）
+
+基準は実行前に `docs/corpus-protocol.md` へ登録済み（`5f2665e`）。
+本ファイルは結果のみ。基準は動かしていない。
+
+実行: `python3 scripts/corpus_ad_pilot.py`（golden cache、生存スキャンなし）
+
+## 判定（事前基準の適用）
+
+| 層 | 事前基準 | 結果 |
+|---|---|---|
+| Tier 1 観測状態 | D は co-change が not_observed。identity 付き A は narrate_rate | **pass** |
+| Tier 2 率・効果量 | 両群 n≥2 のとき中央値差≥0.10・区間包含なし・Cliff δ≥0.33 | **inconclusive_small_n**（A narratable=1, D=0） |
+
+率の判別力は、このピン集合ではまだ宣言しない。D は低率ではなく「未観測」で分かれており、それは Tier 1 の事前方向どおり。click の 0.2664 を D の欠測と引き算して効果量にしたわけではない。
+
+## 行（リポ名のみ。個人名なし）
+
+| 群 | リポ | test_frameworks | test_cochange | corrective_rework |
+|---|---|---|---|---|
+| A | click | pytest | 0.2664 (n=274, narrate) | 0.0109（fresh-work stability。バグ件数ではない） |
+| A | express | mocha, nyc | not_observed (pending_attribution) | not_observed (pending_attribution) |
+| A | typer | pytest | not_observed (pending_attribution) | not_observed (pending_attribution) |
+| D | gitignore | not_observed | not_observed (no_test_framework_or_directory) | not_observed (pending_attribution) |
+| D | Spoon-Knife | not_observed | not_observed (no_test_framework_or_directory) | not_observed (pending_attribution) |
+
+## C pin（選定のみ。本パイロットでは未計測）
+
+- C1-vibe: `https://github.com/mabene/vibe.git` @ `c53ab3cb3461ef43bb1b6336da4e9cdd477c63ac`
+- 理由: README が「ソースは AI 対話で生成、人間が直接書いていない」と自己記述している。個人スコアカードには使わない。
+
+## 次
+
+Tier 2 を閉じるには、identity 付き A をあと1件以上、および（必要なら）テスト基盤があり tenant が測れる D ではない別ピンか、C との corrective 比較。基準の数値は変えない。

grift_cli-0.5.1/corpus/ad-pilot.json

@@ -0,0 +1,127 @@
+{
+  "protocol": "docs/corpus-protocol.md",
+  "criteria_registered_before_run": true,
+  "tier1_observation_status": {
+    "verdict": "pass",
+    "failures": []
+  },
+  "tier2_rates": {
+    "verdict": "inconclusive_small_n",
+    "n_A_narratable": 1,
+    "n_D_narratable": 0
+  },
+  "rows": [
+    {
+      "repo": "click",
+      "pending_attribution": false,
+      "test_frameworks": {
+        "kind": "observed",
+        "reason": null,
+        "names": [
+          "pytest"
+        ]
+      },
+      "test_cochange": {
+        "status": "observed",
+        "value": 0.2664,
+        "narrate_rate": true,
+        "population": 274
+      },
+      "corrective_rework": {
+        "status": "observed",
+        "value": 0.0109,
+        "narrate_rate": true,
+        "population": 274
+      },
+      "origin_tenant_unique": 326,
+      "group": "A",
+      "identity_bearing": true
+    },
+    {
+      "repo": "express",
+      "pending_attribution": true,
+      "test_frameworks": {
+        "kind": "observed",
+        "reason": null,
+        "names": [
+          "mocha",
+          "nyc"
+        ]
+      },
+      "test_cochange": {
+        "status": "not_observed",
+        "reason": "pending_attribution"
+      },
+      "corrective_rework": {
+        "status": "not_observed",
+        "reason": "pending_attribution"
+      },
+      "origin_tenant_unique": 0,
+      "group": "A",
+      "identity_bearing": false
+    },
+    {
+      "repo": "typer",
+      "pending_attribution": true,
+      "test_frameworks": {
+        "kind": "observed",
+        "reason": null,
+        "names": [
+          "pytest"
+        ]
+      },
+      "test_cochange": {
+        "status": "not_observed",
+        "reason": "pending_attribution"
+      },
+      "corrective_rework": {
+        "status": "not_observed",
+        "reason": "pending_attribution"
+      },
+      "origin_tenant_unique": 0,
+      "group": "A",
+      "identity_bearing": false
+    },
+    {
+      "repo": "gitignore",
+      "pending_attribution": true,
+      "test_frameworks": {
+        "kind": "not_observed",
+        "reason": "no_test_framework_or_directory",
+        "names": null
+      },
+      "test_cochange": {
+        "status": "not_observed",
+        "reason": "no_test_framework_or_directory"
+      },
+      "corrective_rework": {
+        "status": "not_observed",
+        "reason": "pending_attribution"
+      },
+      "origin_tenant_unique": 0,
+      "group": "D",
+      "identity_bearing": false
+    },
+    {
+      "repo": "Spoon-Knife",
+      "pending_attribution": true,
+      "test_frameworks": {
+        "kind": "not_observed",
+        "reason": "no_test_framework_or_directory",
+        "names": null
+      },
+      "test_cochange": {
+        "status": "not_observed",
+        "reason": "no_test_framework_or_directory"
+      },
+      "corrective_rework": {
+        "status": "not_observed",
+        "reason": "pending_attribution"
+      },
+      "origin_tenant_unique": 0,
+      "group": "D",
+      "identity_bearing": false
+    }
+  ],
+  "narrative_lock": "corrective_rework low is not a bug count; it is fresh-work stability"
+}

grift_cli-0.5.0/golden/pins.toml → grift_cli-0.5.1/corpus/manifest.toml

@@ -1,17 +1,41 @@
-# Pinned SHAs for the v0 golden corpus.
-# Expected JSON was written from git log inspection before tep_core existed.
+# Corpus pins. Group C is selected here; A/D pilot uses golden cache only.
 
 [[repos]]
-id = "G1-click"
+id = "A-click"
+group = "A"
 name = "click"
 url = "https://github.com/pallets/click.git"
 sha = "2c8cd3ac958a7eb316d67f2d316c27086c4c0369"
 identity = "golden/identity/G1-click.toml"
 fork = false
 parent = ""
+note = "identity-bearing A pin for tenant rates"
 
 [[repos]]
-id = "G2-gitignore"
+id = "A-express"
+group = "A"
+name = "express"
+url = "https://github.com/expressjs/express.git"
+sha = "a3714473feb3d2908add734d340e7755fd85e0a3"
+identity = ""
+fork = false
+parent = ""
+note = "culture marker only until identity is configured"
+
+[[repos]]
+id = "A-typer"
+group = "A"
+name = "typer"
+url = "https://github.com/tiangolo/typer.git"
+sha = "9a7b2e83f6b62c750d6026b0de9ebf2026a8b8fa"
+identity = ""
+fork = false
+parent = ""
+note = "culture marker only until identity is configured"
+
+[[repos]]
+id = "D-gitignore"
+group = "D"
 name = "gitignore"
 url = "https://github.com/github/gitignore.git"
 sha = "57286c3887203259752b747db94e6c3ad10ec53d"
@@ -20,7 +44,8 @@ fork = false
 parent = ""
 
 [[repos]]
-id = "G3-spoon-knife"
+id = "D-spoon-knife"
+group = "D"
 name = "Spoon-Knife"
 url = "https://github.com/octocat/Spoon-Knife.git"
 sha = "d0dd1f61b33d64e29d8bc1372a94ef6a2fee76a9"
@@ -29,19 +54,12 @@ fork = true
 parent = "octocat/Hello-World"
 
 [[repos]]
-id = "G4-express"
-name = "express"
-url = "https://github.com/expressjs/express.git"
-sha = "a3714473feb3d2908add734d340e7755fd85e0a3"
-identity = ""
-fork = false
-parent = ""
-
-[[repos]]
-id = "G5-typer"
-name = "typer"
-url = "https://github.com/tiangolo/typer.git"
-sha = "9a7b2e83f6b62c750d6026b0de9ebf2026a8b8fa"
+id = "C1-vibe"
+group = "C"
+name = "vibe"
+url = "https://github.com/mabene/vibe.git"
+sha = "c53ab3cb3461ef43bb1b6336da4e9cdd477c63ac"
 identity = ""
 fork = false
 parent = ""
+note = "self-described 100% AI-generated product; SHA at first clone; A/D pilot does not wait"

grift_cli-0.5.1/corpus/runs/discriminant-latest.json

@@ -0,0 +1,46 @@
+[
+  {
+    "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
+  }
+]

grift_cli-0.5.1/corpus/runs/summary.json

@@ -0,0 +1,9 @@
+{
+  "run_id": "20260821T164827Z",
+  "pins": 47,
+  "ok": 47,
+  "failed": 0,
+  "analysis_scope": "repo",
+  "failures_path": "/Users/teradakousuke/Developer/grift-cli/corpus/runs/failures.jsonl",
+  "results_path": "/Users/teradakousuke/Developer/grift-cli/corpus/runs/results.jsonl"
+}

grift_cli-0.5.1/docs/export-schema.md

@@ -0,0 +1,127 @@
+# export-v1 スキーマ — 機械取込用 opt-in 出力（凍結 2026-08-22）
+
+`grift analyze <repo> --export <dir>` が書く3ファイルの契約。Grift 本体統合（WP-G1）の取込対象。
+report-v1（`docs/report-schema.md`）と同じ追加互換規約: **export-v1 の間は追加のみ**（改名・削除・意味変更は v2）。
+
+- 定数: `tep_core.export.EXPORT_SCHEMA_VERSION = "tep-export-v1"`
+- report と export は同一の `prepare_inputs()`（commits 読み込み + origin 分類）を共有する。**単一実装**であり、二つの出力が乖離する余地は構造的にない
+
+## 境界（裁定 2026-08-22 二層契約）
+
+- 顧客向け叙述に載る数値は **report.json の集計値が正**（消費者は明細から独自集計した別の数を narrate しない）
+- 参照分布の位置は repo スコープ実行の出力のみ
+- 母数<20 非表示・`not_observed` ≠ 0 の上書き禁止 — 従来どおり
+- **per-actor の品質指標（actor別 co-change 等）は export-v2 でも解禁しない**（個人を評価対象にする出力の禁止レール）
+
+## ファイル構成
+
+| ファイル | 内容 |
+|---|---|
+| `commits.ndjson` | 1行 = 1コミット（NDJSON）。**git log 順（新しいコミットが先頭）** |
+| `actors.json` | canonical_id ごとの帰属と活動（engagement）。JSON 配列 |
+| `export-meta.json` | スキーマ版・provenance・`config_digest` |
+
+## commits.ndjson（1行のフィールド）
+
+| フィールド | 型 | 意味 |
+|---|---|---|
+| `sha` | string (40 hex) | コミット SHA |
+| `ts` | string `YYYY-MM-DD` | author date（日精度。他の全指標と同じ `--date=short` 由来） |
+| `origin` | string | 11分類のいずれか（report-v1 origin と同一語彙） |
+| `actor` | string \| null | 解決できたら `canonical_id`、できなければ null。**生メール・生 author 文字列は出ない** |
+| `bot` | bool | origin == `bot` と同値 |
+| `is_merge` | bool | 親コミット複数 |
+| `prod_paths_touched` | int >= 0 | 本番パス変更数（report と同一の path 分類） |
+| `test_paths_touched` | int >= 0 | テストパス変更数 |
+| `cochange` | bool \| null | **本番変更コミットのみ値を持つ**（prod_paths_touched > 0）。そのコミットがテストも変更したか。それ以外は null |
+| `subject_class` | string | `fix` \| `revert` \| `other`（report の rework 定義と同一正規表現） |
+
+merge コミットは `git log --name-only` の仕様上ファイル一覧が空になるため `prod_paths_touched = 0`・`cochange = null` になる。
+
+## actors.json（1要素のフィールド）
+
+| フィールド | 型 | 意味 |
+|---|---|---|
+| `canonical_id` | string | identity の安定 ID（**`@` を含めてはならない**） |
+| `attribution_state` | string | identity の当該 actor の状態 |
+| `commits` | int >= 1 | この actor の `tenant_unique` コミット数 |
+| `active_days` | int >= 1 | 一意な活動日数 |
+| `first_ts` / `last_ts` | string `YYYY-MM-DD` | 最初・最後の tenant_unique コミット日 |
+| `core_period` | object | report-v1 の `core_activity_period` と同一構造（この actor の日付で計算） |
+
+actor 行を持つのは **tenant_unique コミットが1以上の canonical_id のみ**。pattern 推論（actor 行なし）・bot・unresolved は行を持たない（commits.ndjson の `actor` が null で表現）。actor 順は canonical_id 辞書順（決定論的）。
+
+## export-meta.json
+
+| フィールド | 型 | 意味 |
+|---|---|---|
+| `schema` | string | 常に `"tep-export-v1"` |
+| `tool_name` / `tool_version` | string | `"grift"` / SEMVER |
+| `definition_version` / `origin_definition_version` / `activity_definition_version` | string | report-v1 provenance と同一 |
+| `analysis_scope` | string | `tenant` \| `repo` |
+| `analyzed_commit_sha` | string (40 hex) | |
+| `analyzed_at` | string UTC | |
+| `config_digest` | string (64 hex) | 下記 |
+| `commit_count` | int | commits.ndjson の行数 |
+
+## config_digest の正規化（Grift 側再計算用の完全仕様)
+
+`sha256( json.dumps(payload, sort_keys=True, separators=(",", ":"), ensure_ascii=False).encode("utf-8") )` の hexdigest。
+
+`payload` の内容:
+
+```json
+{
+  "schema": "tep-export-v1",
+  "definition_version": "<DEFINITION_VERSION>",
+  "origin_definition_version": "<ORIGIN_DEFINITION_VERSION>",
+  "activity_definition_version": "<ACTIVITY_DEFINITION_VERSION>",
+  "analysis_scope": "<tenant|repo>",
+  "lineage": {"is_fork": <bool>, "parent": <string|null>},
+  "template_provided": <bool>,
+  "parent_repo_provided": <bool>,
+  "vendor_scan": <bool>,
+  "identity": {
+    "actors": [
+      {"canonical_id": "<id>", "attribution_state": "<state>",
+       "emails": [<sorted strings>], "github_login": <string|null>}
+    ],
+    "email_patterns": [<sorted raw pattern strings>]
+  }
+}
+```
+
+- actors は canonical_id 辞書順、emails と email_patterns は辞書順ソート
+- 生メールは digest 計算には入るが**ディスクには出力されない**。identity.toml を生成した側（Grift）は同じ正規化でローカル再計算・照合できる
+- digest は設定のみから計算（analyzed_at / SHA を含まない）。同一設定なら再実行しても不変
+
+## 取込パリティ（消費者の義務 — 裁定3）
+
+取込側は commits.ndjson から origin 別行数合計（および test co-change）を再計算し、report.json の集計値と**一致しない場合は取込を中止**すること。CLI 側テスト（`tests/test_export.py`）がこの再計算を tenant / repo 両スコープで自動検証している。
+
+### パリティ検算レシピ（取込側はこの式を逐語実行する — F-P10-1）
+
+行 `r` は commits.ndjson の1行（JSON object）。以下の式は Python 式としてそのまま実行可能であること（`tests/test_export_recipe.py` が本節の式を文字列どおり取り出して実行し、doc と実装の乖離を検出する）。
+
+**origin パリティ（スコープ共通）**:
+
+- 各クラス c の行数: `sum(1 for r in rows if r["origin"] == c)`
+- 突合先: `report["origin"][c]`。`kind == "observed"` なら `value` と一致すること。`kind == "not_observed"` なら行数 0 であること
+
+**test co-change パリティ — tenant スコープ**:
+
+- 母集団フィルタ（tenant）: `r["origin"] == "tenant_unique" and r["cochange"] is not None`
+- cochanged フィルタ（tenant）: `r["origin"] == "tenant_unique" and r["cochange"] is True`
+- 突合先: `report["test_cochange"]["all_time"]` の `population` / `cochanged`（`test_cochange.kind == "not_observed"` のときは検算対象なし）
+
+**test co-change パリティ — repo スコープ**:
+
+- 母集団フィルタ（repo）: `r["bot"] is False and r["is_merge"] is False and r["cochange"] is not None`
+- cochanged フィルタ（repo）: `r["bot"] is False and r["is_merge"] is False and r["cochange"] is True`
+- 突合先: 同上
+
+**既知の誤実装（検収 追記9 の実例）**: tenant スコープで `cochange is not None` を忘れると、テスト専用コミットや merge まで母集団に混入し、誤った率（click で 73/274=0.2664 が正しいのに 444/1537=0.2889 を出す）を「パリティ不一致」として誤検知する。`cochange is not None`（= 本番変更コミット）の絞り込みは省略禁止。
+
+## 終了コードと stdout
+
+`--export` は stdout 規約を変えない（`--format json` の stdout は JSON 1 件のまま）。export は常にファイルのみに書く。

grift_cli-0.5.1/docs/identity-schema.md

@@ -0,0 +1,32 @@
+# Identity file schema (identity-v1)
+
+Local entry point for the same concept as Grift `actor_attributions`.
+
+| Field | Grift column | Meaning |
+|---|---|---|
+| `canonical_id` | stable member id (email is the DB key there) | Durable id for a person. CLI uses a non-email id so reports are not scorecards. |
+| `emails` | `canonical_email` plus aliases | Raw git author emails that map to this actor. |
+| `github_login` | `github_login` | Optional. |
+| `attribution_state` | `attribution_state` | `verified` / `claimed` / `inferred` / `unresolved` / `external` / `bot`. |
+
+## canonical_id validity (F-P10-3・版管理)
+
+`canonical_id` は次の正規表現に **fullmatch** しなければならない（producer が `IdentityValidationError` で拒否する）:
+
+```
+^[a-z0-9][a-z0-9._-]{0,63}$
+```
+
+意味: 小文字英数字で開始・以降は小文字英数字と `.` `_` `-` のみ・長さ 1〜64。**`@`・空白・制御文字・大文字・多バイト文字は不正**（export の no-`@` 契約をデータ非依存に保証するための定義パターン。blocklist ではない）。
+
+追加の拒否条件: 空文字（上記正規表現の fullmatch で自動的に拒否）・**重複 canonical_id**（各行一意であること）。
+
+本正規表現は実装（`tep_core.identity.CANONICAL_ID_PATTERN`）と**逐語一致**しなければならない — `tests/test_identity_validation.py` が schema 文書と実装の一致を検査する（レシピテストと同型の doc-code パリティ）。正規表現を変える場合は schema 文書・実装・テストを同じ PR で更新し、`CANONICAL_ID_PATTERN_VERSION` を上げる。
+
+| 版 | 正規表現 | 導入 |
+|---|---|---|
+| 1 | `^[a-z0-9][a-z0-9._-]{0,63}$` | 2026-08-22（F-P10-3 修正） |
+
+`tenant.email_patterns` are regular expressions matched against author emails. A match counts as tenant membership even without an `[[actors]]` row (`attribution_state` then becomes `inferred`).
+
+Empty file / missing file: `pending_attribution = true`. No built-in organisation pattern exists.