grift-cli 0.5.9__tar.gz → 0.8.0__tar.gz

grift_cli-0.8.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,79 @@
+name: バグ報告 / Bug report
+description: 期待と違う出力・終了コード・クラッシュ。An output, exit code or crash that differs from what you expected.
+title: "fix: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        観測値と期待値を分けて書いてください。再現に使う repo は「形」が分かれば十分です（公開 URL + SHA、または合成 repo を作るスクリプト）。
+        秘密情報・生メールアドレス・非公開 repo の履歴は貼らないでください。脆弱性は Issue ではなく [SECURITY.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/SECURITY.md) の窓口へ。
+
+        Please separate what you observed from what you expected. For the repository, its *shape* is enough (public URL + SHA, or a script that builds a synthetic repo).
+        Do not paste secrets, raw email addresses or private history. Vulnerabilities go to [SECURITY.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/SECURITY.md), not to an issue.
+  - type: textarea
+    id: command
+    attributes:
+      label: 実行したコマンド / Command you ran
+      description: フラグも含めてそのまま。As typed, including flags.
+      render: bash
+      placeholder: |
+        grift repo . --format json
+    validations:
+      required: true
+  - type: textarea
+    id: observed
+    attributes:
+      label: 観測値 / What you observed
+      description: 出力（必要な部分だけ）と終了コード。stderr があればそれも。Output (the relevant part), exit code, and stderr if any.
+      render: text
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: 期待値 / What you expected
+      description: どの文書・help・過去の版からそう期待したかも書いてください。Say which document, help text or earlier version led you to expect it.
+    validations:
+      required: true
+  - type: dropdown
+    id: repo-shape
+    attributes:
+      label: 再現 repo の形 / Shape of the reproducing repository
+      options:
+        - 公開 repo（URL と SHA を下に書く）/ Public repository (URL + SHA below)
+        - 合成 repo（作るスクリプトを下に書く）/ Synthetic repository (script below)
+        - 非公開で共有できない（形だけ下に書く）/ Private, cannot share (describe the shape below)
+        - この grift-cli リポジトリ自身 / This grift-cli repository itself
+    validations:
+      required: true
+  - type: textarea
+    id: repo-detail
+    attributes:
+      label: 再現 repo の詳細 / Repository details
+      description: |
+        URL + SHA、または `git init` から始まる最小スクリプト。共有できないときは commit 数・著者数・merge の有無・shallow / promisor か・bot commit の有無・identity の有無を書いてください。
+        URL + SHA, or a minimal script starting at `git init`. If you cannot share it: number of commits and authors, merges or not, shallow / promisor or not, bot commits or not, identity file or not.
+      render: bash
+  - type: input
+    id: version
+    attributes:
+      label: バージョン / Version
+      description: "`grift --version` の出力。The output of `grift --version`."
+      placeholder: grift 0.7.2
+    validations:
+      required: true
+  - type: input
+    id: env
+    attributes:
+      label: 環境 / Environment
+      description: OS、Python の版、入れ方（pipx / pip / GitHub Action）。OS, Python version, how installed (pipx / pip / GitHub Action).
+      placeholder: macOS 15 / Python 3.12.9 / pipx
+  - type: checkboxes
+    id: hygiene
+    attributes:
+      label: 確認 / Checks
+      options:
+        - label: 秘密情報・生メールアドレス・非公開履歴を貼っていない / No secrets, raw email addresses or private history are pasted above
+          required: true
+        - label: 同じ内容の Issue が無いか検索した / I searched for an existing issue

grift_cli-0.8.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 脆弱性の報告 / Report a vulnerability
+    url: https://github.com/Cor-Incorporated/grift-cli/blob/main/SECURITY.md
+    about: 公開 Issue には書かず、SECURITY.md の窓口へ。Do not open a public issue; use the channel in SECURITY.md.
+  - name: 非公開の連絡（削除依頼など）/ Private contact (removal requests etc.)
+    url: https://cor-jp.com/contact/
+    about: golden identity の削除依頼など、公開したくない内容はこちら。For anything you do not want public, such as removal requests for golden identities.
+  - name: 利用規範（TEP 準拠の条件）/ Usage norms
+    url: https://github.com/Cor-Incorporated/grift-cli/blob/main/docs/norms.md
+    about: 「この使い方は TEP 準拠か」はまず 7 条を読んでから。Read the seven articles before asking whether a use is TEP-compliant.

grift_cli-0.8.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,52 @@
+name: 機能の提案 / Feature request
+description: 新しい観測・フラグ・出力形式の提案。A new observation, flag or output format.
+title: "feat: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        grift は合成スコア・順位・推奨・合否を出しません（[CONTRIBUTING.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/CONTRIBUTING.md) §7、[docs/norms.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/docs/norms.md)）。
+        それに当たる提案は、どれだけ便利でも受けられないので、先に下のチェックを見てください。
+
+        grift never produces a composite score, rank, recommendation or pass/fail ([CONTRIBUTING.en.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/CONTRIBUTING.en.md) §7, [docs/en/norms.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/docs/en/norms.md)).
+        A proposal that amounts to one cannot be accepted however useful it is, so please look at the checklist below first.
+  - type: textarea
+    id: observed
+    attributes:
+      label: 今の出力で困っていること（観測値）/ What today's output does (observed)
+      description: 実際に実行したコマンドと、今返ってくるもの。The command you ran and what comes back today.
+      render: text
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: 望む出力（期待値）/ What you want it to do (expected)
+      description: 可能なら report の JSON キー名や Markdown の文面の案まで。単位・分母・観測窓も。If you can, propose the JSON key, the Markdown wording, and its unit, denominator and window.
+    validations:
+      required: true
+  - type: textarea
+    id: repo-shape
+    attributes:
+      label: 違いが出る repo の形 / Shape of a repository where the difference shows
+      description: |
+        公開 repo の URL + SHA、または合成 repo を作るスクリプト。提案した観測が「観測できる repo」と「not_observed になる repo」の両方があると議論が速いです。
+        Public URL + SHA, or a script that builds a synthetic repo. One repo where the observation is possible and one where it must be `not_observed` speeds things up.
+      render: bash
+  - type: checkboxes
+    id: design
+    attributes:
+      label: 設計上の確認 / Design checks
+      options:
+        - label: 人を 1 つの数値・等級・順位に縮約しない / Does not reduce a person to one number, grade or rank
+          required: true
+        - label: 「膨らませ方」（形式的な操作で値が上がる経路）を一緒に書いた / I described how the value could be inflated by formal operations
+          required: true
+        - label: 母数 20 未満・履歴不完全のときに `not_observed` になる条件を書いた / I described when it becomes `not_observed` (population below 20, incomplete history)
+        - label: 新しい network 経路を必要としない。必要なら opt-in フラグ付き / Needs no new network path, or only behind an opt-in flag
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 代替案 / Alternatives
+      description: 既存のフラグや文書で代わりになるものを試したか。What existing flags or documents you tried instead.

grift_cli-0.8.0/.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,52 @@
+name: 質問 / Question
+description: 出力の読み方、使い方、文書の分かりにくさ。How to read an output, how to use a command, unclear documentation.
+title: "question: "
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        先に見ると早いもの: [README](https://github.com/Cor-Incorporated/grift-cli/blob/main/README.md) の「試す」、[docs/metrics-guide.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/docs/metrics-guide.md)（数値の読み方）、[docs/norms.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/docs/norms.md)（利用規範）。
+        「文書を読んでも分からなかった」という報告は、それ自体が文書のバグなので歓迎です。
+
+        Worth a look first: the "Try it" section of the [README](https://github.com/Cor-Incorporated/grift-cli/blob/main/README.en.md), [docs/en/metrics-guide.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/docs/en/metrics-guide.md) (how to read the numbers), [docs/en/norms.md](https://github.com/Cor-Incorporated/grift-cli/blob/main/docs/en/norms.md) (usage norms).
+        "I read the docs and still did not get it" is a documentation bug and welcome here.
+  - type: textarea
+    id: question
+    attributes:
+      label: 質問 / Question
+    validations:
+      required: true
+  - type: textarea
+    id: observed
+    attributes:
+      label: 見た出力（観測値）/ The output you saw (observed)
+      description: 実行したコマンドと、問題の部分。The command and the part of the output in question.
+      render: text
+  - type: textarea
+    id: expected
+    attributes:
+      label: そう思った理由（期待値）/ What you expected and why
+      description: どの文書や経験からそう期待したか。Which document or experience led you to expect something else.
+  - type: dropdown
+    id: repo-shape
+    attributes:
+      label: 見ていた repo の形 / Shape of the repository you were looking at
+      options:
+        - 公開 repo（URL と SHA を下に）/ Public repository (URL + SHA below)
+        - 自分の非公開 repo（形だけ下に）/ My private repository (shape below)
+        - まだ実行していない / Have not run it yet
+  - type: textarea
+    id: repo-detail
+    attributes:
+      label: repo の詳細 / Repository details
+      description: URL + SHA、または commit 数・著者数・merge / shallow / bot の有無。URL + SHA, or commits, authors, merges / shallow / bots.
+  - type: checkboxes
+    id: read
+    attributes:
+      label: 読んだもの / What you already read
+      options:
+        - label: README の「試す」/ The "Try it" section of the README
+        - label: docs/metrics-guide.md（数値の読み方）/ docs/en/metrics-guide.md
+        - label: docs/norms.md（利用規範）/ docs/en/norms.md
+        - label: CONTRIBUTING.md

grift_cli-0.8.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,66 @@
+<!--
+1 PR = 1 意図。ブランチ名と PR タイトルの type（feat / fix / docs / refactor / chore / ci / test / perf）を一致させてください。
+作法と禁止事項は CONTRIBUTING.md §6 / §7。英語版は CONTRIBUTING.en.md。
+One PR, one intent. Branch name and PR title share a type. Etiquette and prohibitions: CONTRIBUTING.en.md §6 / §7.
+-->
+
+## 目的 / Purpose
+
+<!-- この PR が変える 1 つのこと。関連 Issue があれば `Closes #N`。The one thing this PR changes. `Closes #N` if there is an issue. -->
+
+## 変更の種類 / Kind of change
+
+- [ ] docs（文書のみ。`src/` に触れない / documentation only, no `src/`）
+- [ ] fix
+- [ ] feat（テストを含む / ships with tests）
+- [ ] refactor / chore / ci / test / perf
+
+## 変更内容 / What changed
+
+<!-- 箇条書きで。ファイルと理由。Bullets: file and why. -->
+
+## 実行したテスト / Tests you ran
+
+```text
+python -m pytest tests -m "not golden" -q
+# → passed / failed の件数をここに貼る。Paste the passed / failed counts here.
+```
+
+## H5-E2E
+
+<!--
+実際に実行したコマンドと、その生出力の要約（20 文字以上）または安定したログ path。
+実行環境を持たない変更（docs のみ）は `H5-E2E: none` の 1 行。
+The command you actually ran and a summary of its raw output (20+ characters) or a stable log path.
+For changes with no runtime (docs only), the single line `H5-E2E: none`.
+-->
+
+```text
+H5-E2E: <command>
+H5-E2E-OUT: <raw output summary or log path>
+```
+
+## ADR-0001 の確認 G / R / B（`src/`・schema・norms に触れた PR は必須）/ ADR-0001 check (required when `src/`, a schema or the norms change)
+
+<!-- 定義は CONTRIBUTING.md §6。該当しない欄は「該当なし」と書く。Definitions in CONTRIBUTING.en.md §6. Write "not applicable" where nothing qualifies. -->
+
+- **G（Green）** 受入条件を満たすテストが通った / the acceptance test passes:
+- **R（Red）** 片側だけ変えると落ちることを実測した（何を壊して何が落ちたか）/ one-sided change fails (what you broke, what failed):
+- **B（Binding）** 宣言と実体を 1 つのテストで結んだ / declaration and enforcement tied by one test:
+
+## 証跡ゲート / Evidence gates（`src/` に触れた PR のみ / only when `src/` changed）
+
+<!-- CONTRIBUTING.md §5 の 4 本。赤になったものと、意図した出力変更かどうか。The four gates in CONTRIBUTING.en.md §5: which went red, and whether the output change is intended. -->
+
+- [ ] #1 `evidence/v060/scenarios` — 緑 / 再生成した / 赤のまま（理由: ）
+- [ ] #2 `evidence/v060/scenarios-public` — 赤でも可。release で再束縛 / may stay red; re-bound at release
+- [ ] #3 `evidence/v070/benchmark.json` — 緑 / 再生成した
+- [ ] #4 `benchmarks/v060/golden` + `DEFINITION_VERSION` — 緑 / 上げた
+
+## チェック / Checklist
+
+- [ ] 合成スコア・順位・推奨・合否を出す出力やキーを足していない（`FORBIDDEN_VERDICT_KEYS`、`check_forbidden_vocab`）/ No score, rank, recommendation or pass/fail output or key
+- [ ] 新しい network 経路は無い。あるなら opt-in フラグ付き / No new network path, or only behind an opt-in flag
+- [ ] 生メールアドレス・個人を特定する値を出力・テスト fixture・文書に載せていない / No raw email or identifying value in output, fixtures or docs
+- [ ] 文書を変えたなら日英両方（`README.md` ↔ `README.en.md`、`docs/*` ↔ `docs/en/*`）/ Docs changed in both languages
+- [ ] 利用者に見える変更は `CHANGELOG.md` の `[Unreleased]` に 1 行 / One line under `[Unreleased]` for anything a user can see