grift-cli 0.5.0__py3-none-any.whl

grift_cli-0.5.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,26 @@
+tep_cli/__init__.py,sha256=Mt-fwNaHxKqY9wA8r-0TRZTZQxV3bai6Hc1gv5RKBC8,40
+tep_cli/__main__.py,sha256=4Qt60qI-UrGIV7VbBlP0_jIgo8LlBCA3X_oPyXn5KD0,4633
+tep_core/__init__.py,sha256=ZmFlXgmQ-dCTLT8yZRNiD_uN3hpLiv_MJ9ISQiJHgzA,387
+tep_core/activity.py,sha256=_3bTrP0XQPz02-trMAq6d8rlbGb-2EI0UKEzqyCCIYk,1934
+tep_core/analyze.py,sha256=bvbVjE_59Fdz54866ccsmPqU2_68ftrBYyoNOj3ju4A,4652
+tep_core/cochange.py,sha256=-rVdEFeew_kBbUnUfg7meTujj8ZdpMeJTspI_Q-JsVg,3340
+tep_core/core_period.py,sha256=U9U6BGuZj19ZLhHroRCCmrBJrIfGeEuOu-r_T7da3Hk,2601
+tep_core/gitutil.py,sha256=SNuOiLLBMZ97J-yUh2WytfkMlQhdL3GivdHCPoQYqXk,3170
+tep_core/identity.py,sha256=WhGlmGAHM1tdMltACBerfiST1fTXVHEYSjcytepMiOM,3669
+tep_core/lineage.py,sha256=OpXhe_88XFki5hwYVcUb1X8WOnr11f-mZANZfT0n7VY,546
+tep_core/observation.py,sha256=xlzw-FDBdYcy3Ud73_zaEdBokqYCBM6mvy-b8WZRN6Q,771
+tep_core/origin.py,sha256=TCMV5Q-nhFSOT_TiozLeKsy7oqUP8ESO_qnSAacYD0k,4937
+tep_core/paths.py,sha256=xEjpSl5tjZp_qXkNlC0qyt2d1PWoNcK8UK2YZLXsmJ0,1218
+tep_core/reference.py,sha256=QrE_CnojzEEgnRL-zDNHHLVaVOeawmisQKYk81zFSj0,2506
+tep_core/report.py,sha256=FcPia0vtP8qPlh8ov4Eh8hd_QSJ7kn4OE5aNlU0ukwk,8612
+tep_core/rework.py,sha256=tw6hrBkzyHFhtydTiQKwgj7H5y0QbnnC22A95xYkw5E,3980
+tep_core/scope.py,sha256=yha9vm72pqMWgE3i1coZQIxEMM4GtsOqw2TCYc3zYng,1180
+tep_core/survival.py,sha256=VoxOHN7L-BfuMrrllj1rXFhQe4WCzVXu_M7t1xNIJFY,2300
+tep_core/tests_observed.py,sha256=fF8Hyx8beLEbo9WLv3E5XOc2S-ZfwrJCmWgVEL5Q_mI,2694
+tep_core/version.py,sha256=2Nztz_qJZUbxN0wCjdEHN__Dl26yiNzxe-3fk0wf49M,280
+tep_core/data/v2026.09/distributions.json,sha256=x2C184rGVeW4-JE2qnfqgpSRNZ2B5n593eQ0j5tQGw8,1836
+grift_cli-0.5.0.dist-info/METADATA,sha256=45qd6QOIRzd7Dbtkaukoe340QOsOnCXKiwi499llCWY,4999
+grift_cli-0.5.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+grift_cli-0.5.0.dist-info/entry_points.txt,sha256=T4GYRNy2QNwtd-sIh0cQHd29_jmwqadckbI5UGKTddY,48
+grift_cli-0.5.0.dist-info/licenses/LICENSE,sha256=P6-C9fAmLf584KeKcQoZNLRLCm8TjczQiuW5av6noTE,1073
+grift_cli-0.5.0.dist-info/RECORD,,

grift_cli-0.5.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

grift_cli-0.5.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+grift = tep_cli.__main__:main

grift_cli-0.5.0.dist-info/licenses/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.

tep_cli/__init__.py

@@ -0,0 +1 @@
+"""Thin CLI wrapper around tep_core."""

tep_cli/__main__.py

@@ -0,0 +1,146 @@
+"""grift CLI (method = TEP)."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from tep_core.analyze import analyze_repository
+from tep_core.identity import discover_identity
+from tep_core.lineage import Lineage
+from tep_core.report import render_markdown
+from tep_core.version import __version__
+
+_EPILOG = """examples:
+  grift analyze . --scope repo
+  grift analyze ./repo --format md --out ./out
+詳細: README"""
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="grift",
+        description="grift — deterministic TEP evidence from a git repository. No LLM.",
+        epilog=_EPILOG,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    parser.add_argument("--version", action="version", version=f"grift {__version__}")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    analyze = sub.add_parser(
+        "analyze",
+        help="Analyze one git repository",
+        epilog=_EPILOG,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    analyze.add_argument("repo", type=Path, help="Path to a git working tree")
+    analyze.add_argument(
+        "--identity",
+        type=Path,
+        default=None,
+        help="Path to identity.toml (default: <repo>/.tep/identity.toml)",
+    )
+    analyze.add_argument(
+        "--parent",
+        default="",
+        help="Upstream parent full name (owner/name). Implies lineage.",
+    )
+    analyze.add_argument(
+        "--fork",
+        action="store_true",
+        help="Declare the repository as a fork (lineage).",
+    )
+    analyze.add_argument(
+        "--template",
+        type=Path,
+        default=None,
+        help="Path to a template repository (enables template_inherited).",
+    )
+    analyze.add_argument(
+        "--parent-repo",
+        type=Path,
+        default=None,
+        help="Local path to the parent repository (enables derivative classes).",
+    )
+    analyze.add_argument(
+        "--format",
+        choices=("md", "json", "both"),
+        default="both",
+        help="Output format (default: both, markdown first)",
+    )
+    analyze.add_argument(
+        "--out",
+        type=Path,
+        default=None,
+        help="Directory to write report.md and report.json",
+    )
+    analyze.add_argument(
+        "--vendor-scan",
+        action="store_true",
+        help="Classify generated_or_vendor from commit path names (slower).",
+    )
+    analyze.add_argument(
+        "--include-local-path",
+        action="store_true",
+        help="Include the absolute local path in report.json (off by default).",
+    )
+    analyze.add_argument(
+        "--survival",
+        action="store_true",
+        help="Enable EIS-style blame sampling (tau=180d). Slow; git I/O bound.",
+    )
+    analyze.add_argument(
+        "--scope",
+        choices=("tenant", "repo"),
+        default="tenant",
+        help="tenant: identity-matched evidence. repo: all human commits (reference distribution).",
+    )
+    return parser
+
+
+def _run_analyze(args: argparse.Namespace) -> int:
+    repo: Path = args.repo
+    if not (repo / ".git").exists() and not repo.joinpath("HEAD").exists():
+        sys.stderr.write(f"not a git repository: {repo}\n")
+        return 2
+    identity = discover_identity(repo, args.identity)
+    lineage = Lineage(is_fork=bool(args.fork), parent=args.parent or None)
+    report = analyze_repository(
+        repo,
+        identity,
+        lineage,
+        template_provided=args.template is not None,
+        parent_repo_provided=args.parent_repo is not None,
+        include_files=bool(args.vendor_scan),
+        include_local_path=bool(args.include_local_path),
+        survival=bool(args.survival),
+        scope=str(args.scope),
+    )
+    markdown = render_markdown(report)
+    encoded = json.dumps(report, indent=2, ensure_ascii=False) + "\n"
+    if args.out is not None:
+        args.out.mkdir(parents=True, exist_ok=True)
+        (args.out / "report.md").write_text(markdown, encoding="utf-8")
+        (args.out / "report.json").write_text(encoded, encoding="utf-8")
+    if args.format in {"md", "both"}:
+        sys.stdout.write(markdown)
+        if args.format == "both":
+            sys.stdout.write("\n")
+    if args.format in {"json", "both"}:
+        sys.stdout.write(encoded)
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if args.command == "analyze":
+        return _run_analyze(args)
+    parser.error("unknown command")
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tep_core/__init__.py

@@ -0,0 +1,14 @@
+"""tep-core: deterministic TEP evidence metrics from a git repository."""
+
+from tep_core.analyze import analyze_repository
+from tep_core.identity import load_identity
+from tep_core.lineage import Lineage
+from tep_core.version import DEFINITION_VERSION, __version__
+
+__all__ = [
+    "DEFINITION_VERSION",
+    "Lineage",
+    "analyze_repository",
+    "load_identity",
+    "__version__",
+]

tep_core/activity.py

@@ -0,0 +1,55 @@
+"""Activity-day metrics (TEP metric-design ruling 1, 2026-08-16)."""
+
+from __future__ import annotations
+
+import statistics
+from collections import Counter
+from datetime import date, timedelta
+
+from tep_core.observation import NotObserved, Observed
+
+WINDOW_13W_DAYS = 13 * 7
+
+
+def _parse_day(value: str) -> date:
+    year, month, day = (int(part) for part in value.split("-"))
+    return date(year, month, day)
+
+
+def activity_metrics(
+    tenant_dates: list[str],
+    day_counts: Counter[str],
+    *,
+    head_date: str | None,
+) -> dict[str, dict[str, object]]:
+    tenant_commits = len(tenant_dates)
+    payload: dict[str, dict[str, object]] = {
+        "tenant_commits": Observed(tenant_commits, "commits").to_dict(),
+    }
+    unique_days = sorted(set(tenant_dates))
+    active_days = len(unique_days)
+    payload["active_days"] = Observed(active_days, "days").to_dict()
+
+    if active_days == 0:
+        payload["commits_per_active_day"] = NotObserved("no_tenant_active_days").to_dict()
+        payload["commits_per_active_day_median"] = NotObserved("no_tenant_active_days").to_dict()
+        payload["active_days_13w"] = Observed(0, "days").to_dict()
+        return payload
+
+    per_day = tenant_commits / active_days
+    payload["commits_per_active_day"] = Observed(round(per_day, 4), "commits/active-day").to_dict()
+    daily_values = [day_counts[d] for d in unique_days]
+    payload["commits_per_active_day_median"] = Observed(
+        statistics.median(daily_values),
+        "commits/active-day",
+        sample_size=len(daily_values),
+    ).to_dict()
+
+    if head_date:
+        head = _parse_day(head_date)
+        cut = head - timedelta(days=WINDOW_13W_DAYS)
+        in_window = [d for d in unique_days if _parse_day(d) >= cut]
+        payload["active_days_13w"] = Observed(len(in_window), "days").to_dict()
+    else:
+        payload["active_days_13w"] = NotObserved("head_date_unavailable").to_dict()
+    return payload

tep_core/analyze.py

@@ -0,0 +1,123 @@
+"""Assemble a provenance-bearing TEP report."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from tep_core.activity import activity_metrics
+from tep_core.cochange import test_cochange
+from tep_core.core_period import compute_core_activity_period
+from tep_core.gitutil import GitError, read_commits, repository_identity, rev_parse
+from tep_core.identity import IdentityConfig
+from tep_core.lineage import Lineage
+from tep_core.observation import Observed
+from tep_core.origin import classify_commits
+from tep_core.reference import interpret_metric
+from tep_core.rework import rework_metrics
+from tep_core.scope import DEFAULT_SCOPE
+from tep_core.survival import survival_metrics
+from tep_core.tests_observed import observe_test_frameworks
+from tep_core.version import (
+    ACTIVITY_DEFINITION_VERSION,
+    DEFINITION_VERSION,
+    ORIGIN_DEFINITION_VERSION,
+    __version__,
+)
+
+
+def analyze_repository(
+    repo: Path,
+    identity: IdentityConfig,
+    lineage: Lineage,
+    *,
+    template_provided: bool = False,
+    parent_repo_provided: bool = False,
+    include_files: bool = False,
+    include_local_path: bool = False,
+    survival: bool = False,
+    scope: str = DEFAULT_SCOPE,
+) -> dict[str, Any]:
+    repo = repo.resolve()
+    commits = read_commits(repo, include_files=False)
+    if include_files:
+        try:
+            named = read_commits(repo, include_files=True)
+            files_by_sha = {item.sha: item.files for item in named}
+            for commit in commits:
+                commit.files = files_by_sha.get(commit.sha, ())
+        except GitError:
+            pass
+    origin = classify_commits(commits, identity, lineage)
+    tests = observe_test_frameworks(repo)
+    tests_observed = tests.get("kind") == "observed"
+    need_paths = include_files or scope == "repo" or origin.counts["tenant_unique"] > 0
+    if not include_files and need_paths:
+        try:
+            named = read_commits(repo, include_files=True)
+            files_by_sha = {item.sha: item.files for item in named}
+            for commit in commits:
+                commit.files = files_by_sha.get(commit.sha, ())
+        except GitError:
+            pass
+    head_sha = rev_parse(repo)
+    head_date = commits[0].date if commits else None
+    activity = activity_metrics(origin.tenant_dates, origin.tenant_day_counts, head_date=head_date)
+    cochange = test_cochange(
+        commits,
+        origin,
+        tests_observed=tests_observed,
+        pending_attribution=identity.pending_attribution,
+        head_date=head_date,
+        scope=scope,
+    )
+    rework = rework_metrics(
+        commits,
+        origin,
+        pending_attribution=identity.pending_attribution,
+        scope=scope,
+    )
+    corr = rework.get("corrective_rework_rate") if rework.get("kind") == "observed" else rework
+    return {
+        "schema_version": "tep-report-v1",
+        "provenance": {
+            "tool_name": "grift",
+            "method_name": "TEP",
+            "tool_version": __version__,
+            "definition_version": DEFINITION_VERSION,
+            "origin_definition_version": ORIGIN_DEFINITION_VERSION,
+            "activity_definition_version": ACTIVITY_DEFINITION_VERSION,
+            "analysis_scope": scope,
+            "analyzed_commit_sha": head_sha,
+            "analyzed_at": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        },
+        "repository": repository_identity(repo, include_local_path=include_local_path),
+        "identity": {
+            "pending_attribution": identity.pending_attribution,
+            "actor_count": identity.actor_count,
+        },
+        "lineage": lineage.to_dict(),
+        "origin": origin.origin_observations(
+            template_provided=template_provided,
+            parent_repo_provided=parent_repo_provided,
+            has_upstream_lineage=lineage.has_upstream_lineage,
+        ),
+        "attribution": {
+            "bot": Observed(origin.bot_commits, "commits").to_dict(),
+        },
+        "activity": activity,
+        "core_activity_period": compute_core_activity_period(origin.tenant_dates),
+        "test_frameworks": tests,
+        "test_cochange": cochange,
+        "rework": rework,
+        "survival": survival_metrics(repo, enabled=survival),
+        "interpretation": {
+            "test_cochange": interpret_metric(
+                report_scope=scope, metric_id="test_cochange", observation=cochange
+            ),
+            "corrective_rework": interpret_metric(
+                report_scope=scope, metric_id="corrective_rework", observation=corr
+            ),
+        },
+    }

tep_core/cochange.py

@@ -0,0 +1,102 @@
+"""Test co-change rate (definition v1, 2026-08-19 ruling)."""
+
+from __future__ import annotations
+
+from datetime import date, timedelta
+
+from tep_core.activity import WINDOW_13W_DAYS
+from tep_core.gitutil import GitCommit
+from tep_core.observation import NotObserved
+from tep_core.origin import OriginResult
+from tep_core.paths import split_paths
+from tep_core.scope import DEFAULT_SCOPE, population_shas
+
+COCHANGE_DEFINITION_VERSION = "test-cochange-v1-2026-08-22"
+MIN_POPULATION_FOR_RATE = 20
+
+
+def _parse_day(value: str) -> date:
+    year, month, day = (int(part) for part in value.split("-"))
+    return date(year, month, day)
+
+
+def test_cochange(
+    commits: list[GitCommit],
+    origin: OriginResult,
+    *,
+    tests_observed: bool,
+    pending_attribution: bool,
+    head_date: str | None,
+    scope: str = DEFAULT_SCOPE,
+) -> dict[str, object]:
+    """Co-change among production-changing commits in the analysis scope.
+
+    tenant: identity-matched tenant_unique (evidence).
+    repo: all non-bot, non-merge humans (process / reference distribution).
+    """
+    if not tests_observed:
+        return NotObserved("no_test_framework_or_directory").to_dict()
+
+    shas = population_shas(commits, origin, scope)
+    if scope == "tenant" and pending_attribution and not shas:
+        return NotObserved("pending_attribution").to_dict()
+    if not shas:
+        return NotObserved(
+            "no_tenant_commits" if scope == "tenant" else "no_human_commits"
+        ).to_dict()
+    if not any(c.files for c in commits):
+        return NotObserved("commit_paths_unavailable").to_dict()
+
+    pop_all, co_all, test_only, docs_only = _window(commits, shas, start=None)
+    payload: dict[str, object] = {
+        "kind": "observed",
+        "definition_version": COCHANGE_DEFINITION_VERSION,
+        "analysis_scope": scope,
+        "all_time": _rate_block(pop_all, co_all, test_only, docs_only),
+    }
+    if head_date:
+        cut = _parse_day(head_date) - timedelta(days=WINDOW_13W_DAYS)
+        pop_w, co_w, test_w, docs_w = _window(commits, shas, start=cut)
+        payload["last_13w"] = _rate_block(pop_w, co_w, test_w, docs_w)
+    else:
+        payload["last_13w"] = NotObserved("head_date_unavailable").to_dict()
+    return payload
+
+
+def _window(
+    commits: list[GitCommit],
+    tenant_shas: set[str],
+    start: date | None,
+) -> tuple[int, int, int, int]:
+    pop = co = test_only = docs_only = 0
+    for commit in commits:
+        if commit.sha not in tenant_shas:
+            continue
+        if start is not None and _parse_day(commit.date) < start:
+            continue
+        prod, tests, docs = split_paths(commit.files)
+        if prod:
+            pop += 1
+            if tests:
+                co += 1
+        elif tests:
+            test_only += 1
+        elif docs:
+            docs_only += 1
+    return pop, co, test_only, docs_only
+
+
+def _rate_block(pop: int, co: int, test_only: int, docs_only: int) -> dict[str, object]:
+    if pop == 0:
+        return NotObserved("no_production_commits").to_dict()
+    rate = round(co / pop, 4)
+    return {
+        "kind": "observed",
+        "value": rate,
+        "unit": "ratio",
+        "population": pop,
+        "cochanged": co,
+        "test_only": test_only,
+        "docs_or_config_excluded": docs_only,
+        "narrate_rate": pop >= MIN_POPULATION_FOR_RATE,
+    }

tep_core/core_period.py

@@ -0,0 +1,78 @@
+"""Core activity period: minimal contiguous month range covering >=80%."""
+
+from __future__ import annotations
+
+from collections import Counter
+from datetime import date
+
+from tep_core.observation import NotObserved
+from tep_core.version import CORE_ACTIVITY_DEFINITION_VERSION
+
+CORE_ACTIVITY_MIN_SHARE = 0.80
+
+
+def _parse_day(value: str) -> date:
+    year, month, day = (int(part) for part in value.split("-"))
+    return date(year, month, day)
+
+
+def _month_key(value: date) -> str:
+    return f"{value.year:04d}-{value.month:02d}"
+
+
+def _add_month(year: int, month: int, delta: int) -> tuple[int, int]:
+    total = year * 12 + (month - 1) + delta
+    return total // 12, total % 12 + 1
+
+
+def compute_core_activity_period(commit_dates: list[str]) -> dict[str, object]:
+    """Return Observed month-range or NotObserved.
+
+    Sliding window over calendar months (empty months kept) from the first
+    tenant commit month to the last. The shortest window whose share is
+    >= 80% wins; ties take the earliest start.
+    """
+    if not commit_dates:
+        return NotObserved("no_tenant_commits").to_dict()
+
+    months: Counter[str] = Counter()
+    for raw in commit_dates:
+        months[_month_key(_parse_day(raw))] += 1
+
+    keys = sorted(months)
+    start_y, start_m = (int(p) for p in keys[0].split("-"))
+    end_y, end_m = (int(p) for p in keys[-1].split("-"))
+    sequence: list[tuple[str, int]] = []
+    year, month = start_y, start_m
+    while (year, month) <= (end_y, end_m):
+        key = f"{year:04d}-{month:02d}"
+        sequence.append((key, months.get(key, 0)))
+        year, month = _add_month(year, month, 1)
+
+    total = sum(count for _, count in sequence)
+    if total == 0:
+        return NotObserved("no_tenant_commits").to_dict()
+
+    best: tuple[int, int, int, float] | None = None
+    for start in range(len(sequence)):
+        acc = 0
+        for end in range(start, len(sequence)):
+            acc += sequence[end][1]
+            share = acc / total
+            if share >= CORE_ACTIVITY_MIN_SHARE:
+                span = end - start
+                if best is None or span < best[0] or (span == best[0] and start < best[1]):
+                    best = (span, start, end, share)
+                break
+    if best is None:
+        return NotObserved("no_tenant_commits").to_dict()
+
+    _, start_idx, end_idx, share = best
+    return {
+        "kind": "observed",
+        "start": sequence[start_idx][0],
+        "end": sequence[end_idx][0],
+        "share": round(share, 4),
+        "unit": "month-range",
+        "definition_version": CORE_ACTIVITY_DEFINITION_VERSION,
+    }