chatgh 0.2.2__tar.gz → 0.2.4__tar.gz

{chatgh-0.2.2/src/chatgh.egg-info → chatgh-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatgh
-Version: 0.2.2
+Version: 0.2.4
 Summary: GitHub CLI and Python helpers for ChatArch
 Author-email: ChatArch <1073853456@qq.com>
 License-Expression: MIT
@@ -43,7 +43,7 @@ pip install -e ".[dev]"
 默认行为：
 
 - `repo`：优先使用显式 `--repo owner/repo`，未传时从当前 git remote 推断。
-- `token`：优先使用显式 `--token`，其次读取当前仓库对应的 git credential，再回退 typed env 里的 `GITHUB_ACCESS_TOKEN`。
+- `token`：优先使用显式 `--token`，其次读取当前仓库 `.git/config` 中 repo-local HTTPS auth header，再回退 typed env 里的 `GITHUB_ACCESS_TOKEN`。
 - 输出：默认是人类可读格式；支持 `--json-output` 的命令会输出稳定 JSON，适合脚本消费。
 
 ### Token 来源
@@ -51,7 +51,7 @@ pip install -e ".[dev]"
 Token 解析顺序稳定为：
 
 1. 显式 `--token`。
-2. repo-scoped git credential，路径为规范化后的 `owner/repo`，不带 `.git` 后缀。
+2. 当前仓库 `.git/config` 中的 repo-local HTTPS auth header，路径为规范化后的 `https://github.com/owner/repo.git`。
 3. typed env 中的 `GITHUB_ACCESS_TOKEN`。
 
 可以用 `chatenv` 查看或配置 typed env：
@@ -72,13 +72,14 @@ chatenv cat -t gh
 - `git@github.com:octocat/Hello-World.git`
 - `ssh://git@github.com/octocat/Hello-World.git`
 
-写入 repo-scoped credential 时，path 会规范化为 `octocat/Hello-World`。
+写入 repo-local HTTPS auth header 时，path 会规范化为 `https://github.com/octocat/Hello-World.git`。
 
 ## CLI 入口
 
 ```bash
 chatgh --help
 chatgh pr --help
+chatgh repo --help
 chatgh run --help
 chatgh repo-perms --help
 chatgh set-token --help
@@ -89,7 +90,10 @@ chatgh set-token --help
 - `chatgh pr list`：generated-layer PR 列表。
 - `chatgh pr view NUMBER`：generated-layer PR 详情。
 - `chatgh pr checks NUMBER`：generated-layer PR head commit check runs。
-- `chatgh pr create/comment/merge/edit`：PR 创建、评论、合并和编辑操作。
+- 当前公开 `chatgh pr` 命令面只包含 `list/view/checks`；PR 创建、评论、合并和编辑流程仍由内部 helper 支持，后续作为独立 CLI 命令恢复前不在帮助与文档中承诺。
+- `chatgh repo list`：列出 user/org 下的仓库；默认 table，支持 `--json-output`、`--limit`、`--sort updated|created|pushed|name|stars|open-prs|open-issues`、`--direction asc|desc`，字段包含 visibility、stars、open PRs、open issues、created/updated time 等。
+- `chatgh repo create`：创建仓库；默认 private，可用 `--public` 显式创建公开仓库。
+- `chatgh repo protection`：查看单个仓库或 owner 下仓库的默认分支保护与 repository rulesets；治理/规则审计不挤进 `repo list` 默认表格。
 - `chatgh run view`：查看 workflow run 和 jobs。
 - `chatgh run logs`：查看 job 日志，支持 tail 和落盘。
 - `chatgh repo-perms`：查看 token 权限和派生 capabilities。
@@ -99,26 +103,7 @@ chatgh set-token --help
 
 ### 创建 PR
 
-优先使用 `--body-file`，避免 shell 转义破坏 Markdown：
-
-```bash
-cat > /tmp/pr_body.md <<'EOF'
-## Summary
-- migrate GitHub helpers to chatgh
-
-## Testing
-- python -m pytest -q
-EOF
-
-chatgh pr create \
-  --repo octocat/Hello-World \
-  --base main \
-  --head feature-branch \
-  --title "feat: migrate github helpers" \
-  --body-file /tmp/pr_body.md
-```
-
-缺少 `base` / `head` / `title` 且终端可交互时，命令会自动补问；显式 `-I` 会禁用补问。
+当前版本未公开 `chatgh pr create` CLI 命令。需要创建 PR 时，请使用项目既有 GitHub 流程或直接调用 GitHub API；等写操作命令恢复为稳定 CLI surface 后再补回示例。
 
 ### 查看 PR
 
@@ -135,12 +120,10 @@ chatgh pr view 123 --repo octocat/Hello-World --json-output
 - `mergeable` 和 `mergeable_state`。
 - created/updated/merged timestamps。
 
-### 查看和等待 CI
+### 查看 CI
 
 ```bash
 chatgh pr checks 123 --repo octocat/Hello-World
-chatgh pr checks --repo octocat/Hello-World --number 123 --wait
-chatgh pr checks --repo octocat/Hello-World --number 123 --wait --interval 10 --timeout 600
 chatgh pr checks 123 --repo octocat/Hello-World --json-output
 ```
 
@@ -150,11 +133,7 @@ chatgh pr checks 123 --repo octocat/Hello-World --json-output
 - check runs
 - workflow runs
 
-`--wait` 会持续轮询直到 statuses、check runs 和 workflow runs 都结束：
-
-- 默认不设超时，会一直等。
-- `--interval <seconds>` 控制轮询间隔。
-- 只有显式传 `--timeout <seconds>` 时才会超时报错。
+当前公开 CLI 不提供 `--wait` / `--interval` / `--timeout` 参数；需要等待终态时，在外层流程中轮询 `chatgh pr checks`。
 
 如果 GitHub token 无权读取 check-runs API，命令会把 check-runs 错误放进 payload，同时仍尽量展示 combined status 和 workflow runs。
 
@@ -173,25 +152,18 @@ chatgh run logs --repo octocat/Hello-World --job-id 987654321 --tail 200 --outpu
 
 ### 评论、合并和编辑 PR
 
-```bash
-chatgh pr comment --repo octocat/Hello-World --number 123 --body "Looks good"
+当前版本未公开 `chatgh pr comment/merge/edit` CLI 命令。相关业务函数已保留在 `chatgh.github.commands` 中，后续恢复为稳定 CLI surface 前，建议通过项目既有流程或 GitHub API 执行写操作。
 
-chatgh pr merge --repo octocat/Hello-World --number 123 --method squash
-chatgh pr merge --repo octocat/Hello-World --number 123 --method squash --check
+### 查看仓库保护规则
 
-chatgh pr edit --repo octocat/Hello-World --number 123 --title "New title"
-chatgh pr edit --repo octocat/Hello-World --number 123 --body-file /tmp/pr_body.md
-chatgh pr edit --repo octocat/Hello-World --number 123 --state closed
-chatgh pr edit --repo octocat/Hello-World --number 123 --base main
+```bash
+chatgh repo protection --repo octocat/Hello-World
+chatgh repo protection --repo octocat/Hello-World --json-output
+chatgh repo protection --owner octocat --limit 50 --jobs 8
+chatgh repo protection --owner octocat --limit 50 --jobs 8 --json-output
 ```
 
-`pr merge --check` 会在合并前拒绝以下情况：
-
-- PR 当前 `mergeable=False`。
-- `mergeable_state` 为 `dirty`、`blocked`、`behind`、`draft` 或 `unknown`。
-- combined status、check runs 或 workflow runs 存在失败、取消或未完成项。
-
-不带 `--check` 时，命令保持直接调用 GitHub merge API 的行为。
+`repo protection` 会展示默认分支、是否 protected、classic branch protection 细节（例如是否要求 PR、review 数量、是否允许 force push / deletion），以及 GitHub 可读取时的 repository ruleset 摘要。部分 private 仓库可能因为 GitHub plan/visibility 限制读取 rulesets 返回错误；命令会在 JSON 里保留该错误，同时尽量展示 branch protection 状态。owner inventory 模式会先列仓库，再用 `--jobs` 并发检查每个仓库，输出顺序保持稳定。
 
 ### 配置和检查 token
 
@@ -209,7 +181,14 @@ chatgh set-token --token "$GITHUB_ACCESS_TOKEN" --save-env
 - GitHub 返回的 `permissions`。
 - 派生 capabilities：`can_read_pr`、`can_comment_pr`、`can_merge_pr`、`can_view_checks`、`can_view_actions`。
 
-`set-token` 只在当前目录能识别 GitHub remote 时生效。默认只写入 repo-scoped git credential；传 `--save-env` 时会同步写入 typed env 的 `GITHUB_ACCESS_TOKEN`。
+`set-token` 只在当前目录能识别 GitHub remote 时生效。默认只写入当前仓库自己的 `.git/config`：
+
+```ini
+[http "https://github.com/octocat/Hello-World.git"]
+    extraHeader = Authorization: Basic <base64(x-access-token:TOKEN)>
+```
+
+不要把 token 写进 remote URL，也不要把 raw `extraHeader` 输出到日志。传 `--save-env` 时会同步写入 typed env 的 `GITHUB_ACCESS_TOKEN`。
 
 ## 交互模式
 
@@ -233,7 +212,7 @@ git fetch origin main
 
 - `chatgh pr view` / `chatgh pr checks` 显示 `mergeable` 不是 `False`，`mergeable_state` 不是 `dirty`。
 - 本地基于最新 base 做过 merge 或 rebase 演练，并在该结果上跑过最相关测试。
-- CI 需要终态时用 `chatgh pr checks --wait`，不要只看一次快照。
+- CI 需要终态时，在外层流程中轮询 `chatgh pr checks`，不要只看一次快照。
 
 ## Python API
 

{chatgh-0.2.2 → chatgh-0.2.4}/README.md

@@ -15,7 +15,7 @@ pip install -e ".[dev]"
 默认行为：
 
 - `repo`：优先使用显式 `--repo owner/repo`，未传时从当前 git remote 推断。
-- `token`：优先使用显式 `--token`，其次读取当前仓库对应的 git credential，再回退 typed env 里的 `GITHUB_ACCESS_TOKEN`。
+- `token`：优先使用显式 `--token`，其次读取当前仓库 `.git/config` 中 repo-local HTTPS auth header，再回退 typed env 里的 `GITHUB_ACCESS_TOKEN`。
 - 输出：默认是人类可读格式；支持 `--json-output` 的命令会输出稳定 JSON，适合脚本消费。
 
 ### Token 来源
@@ -23,7 +23,7 @@ pip install -e ".[dev]"
 Token 解析顺序稳定为：
 
 1. 显式 `--token`。
-2. repo-scoped git credential，路径为规范化后的 `owner/repo`，不带 `.git` 后缀。
+2. 当前仓库 `.git/config` 中的 repo-local HTTPS auth header，路径为规范化后的 `https://github.com/owner/repo.git`。
 3. typed env 中的 `GITHUB_ACCESS_TOKEN`。
 
 可以用 `chatenv` 查看或配置 typed env：
@@ -44,13 +44,14 @@ chatenv cat -t gh
 - `git@github.com:octocat/Hello-World.git`
 - `ssh://git@github.com/octocat/Hello-World.git`
 
-写入 repo-scoped credential 时，path 会规范化为 `octocat/Hello-World`。
+写入 repo-local HTTPS auth header 时，path 会规范化为 `https://github.com/octocat/Hello-World.git`。
 
 ## CLI 入口
 
 ```bash
 chatgh --help
 chatgh pr --help
+chatgh repo --help
 chatgh run --help
 chatgh repo-perms --help
 chatgh set-token --help
@@ -61,7 +62,10 @@ chatgh set-token --help
 - `chatgh pr list`：generated-layer PR 列表。
 - `chatgh pr view NUMBER`：generated-layer PR 详情。
 - `chatgh pr checks NUMBER`：generated-layer PR head commit check runs。
-- `chatgh pr create/comment/merge/edit`：PR 创建、评论、合并和编辑操作。
+- 当前公开 `chatgh pr` 命令面只包含 `list/view/checks`；PR 创建、评论、合并和编辑流程仍由内部 helper 支持，后续作为独立 CLI 命令恢复前不在帮助与文档中承诺。
+- `chatgh repo list`：列出 user/org 下的仓库；默认 table，支持 `--json-output`、`--limit`、`--sort updated|created|pushed|name|stars|open-prs|open-issues`、`--direction asc|desc`，字段包含 visibility、stars、open PRs、open issues、created/updated time 等。
+- `chatgh repo create`：创建仓库；默认 private，可用 `--public` 显式创建公开仓库。
+- `chatgh repo protection`：查看单个仓库或 owner 下仓库的默认分支保护与 repository rulesets；治理/规则审计不挤进 `repo list` 默认表格。
 - `chatgh run view`：查看 workflow run 和 jobs。
 - `chatgh run logs`：查看 job 日志，支持 tail 和落盘。
 - `chatgh repo-perms`：查看 token 权限和派生 capabilities。
@@ -71,26 +75,7 @@ chatgh set-token --help
 
 ### 创建 PR
 
-优先使用 `--body-file`，避免 shell 转义破坏 Markdown：
-
-```bash
-cat > /tmp/pr_body.md <<'EOF'
-## Summary
-- migrate GitHub helpers to chatgh
-
-## Testing
-- python -m pytest -q
-EOF
-
-chatgh pr create \
-  --repo octocat/Hello-World \
-  --base main \
-  --head feature-branch \
-  --title "feat: migrate github helpers" \
-  --body-file /tmp/pr_body.md
-```
-
-缺少 `base` / `head` / `title` 且终端可交互时，命令会自动补问；显式 `-I` 会禁用补问。
+当前版本未公开 `chatgh pr create` CLI 命令。需要创建 PR 时，请使用项目既有 GitHub 流程或直接调用 GitHub API；等写操作命令恢复为稳定 CLI surface 后再补回示例。
 
 ### 查看 PR
 
@@ -107,12 +92,10 @@ chatgh pr view 123 --repo octocat/Hello-World --json-output
 - `mergeable` 和 `mergeable_state`。
 - created/updated/merged timestamps。
 
-### 查看和等待 CI
+### 查看 CI
 
 ```bash
 chatgh pr checks 123 --repo octocat/Hello-World
-chatgh pr checks --repo octocat/Hello-World --number 123 --wait
-chatgh pr checks --repo octocat/Hello-World --number 123 --wait --interval 10 --timeout 600
 chatgh pr checks 123 --repo octocat/Hello-World --json-output
 ```
 
@@ -122,11 +105,7 @@ chatgh pr checks 123 --repo octocat/Hello-World --json-output
 - check runs
 - workflow runs
 
-`--wait` 会持续轮询直到 statuses、check runs 和 workflow runs 都结束：
-
-- 默认不设超时，会一直等。
-- `--interval <seconds>` 控制轮询间隔。
-- 只有显式传 `--timeout <seconds>` 时才会超时报错。
+当前公开 CLI 不提供 `--wait` / `--interval` / `--timeout` 参数；需要等待终态时，在外层流程中轮询 `chatgh pr checks`。
 
 如果 GitHub token 无权读取 check-runs API，命令会把 check-runs 错误放进 payload，同时仍尽量展示 combined status 和 workflow runs。
 
@@ -145,25 +124,18 @@ chatgh run logs --repo octocat/Hello-World --job-id 987654321 --tail 200 --outpu
 
 ### 评论、合并和编辑 PR
 
-```bash
-chatgh pr comment --repo octocat/Hello-World --number 123 --body "Looks good"
+当前版本未公开 `chatgh pr comment/merge/edit` CLI 命令。相关业务函数已保留在 `chatgh.github.commands` 中，后续恢复为稳定 CLI surface 前，建议通过项目既有流程或 GitHub API 执行写操作。
 
-chatgh pr merge --repo octocat/Hello-World --number 123 --method squash
-chatgh pr merge --repo octocat/Hello-World --number 123 --method squash --check
+### 查看仓库保护规则
 
-chatgh pr edit --repo octocat/Hello-World --number 123 --title "New title"
-chatgh pr edit --repo octocat/Hello-World --number 123 --body-file /tmp/pr_body.md
-chatgh pr edit --repo octocat/Hello-World --number 123 --state closed
-chatgh pr edit --repo octocat/Hello-World --number 123 --base main
+```bash
+chatgh repo protection --repo octocat/Hello-World
+chatgh repo protection --repo octocat/Hello-World --json-output
+chatgh repo protection --owner octocat --limit 50 --jobs 8
+chatgh repo protection --owner octocat --limit 50 --jobs 8 --json-output
 ```
 
-`pr merge --check` 会在合并前拒绝以下情况：
-
-- PR 当前 `mergeable=False`。
-- `mergeable_state` 为 `dirty`、`blocked`、`behind`、`draft` 或 `unknown`。
-- combined status、check runs 或 workflow runs 存在失败、取消或未完成项。
-
-不带 `--check` 时，命令保持直接调用 GitHub merge API 的行为。
+`repo protection` 会展示默认分支、是否 protected、classic branch protection 细节（例如是否要求 PR、review 数量、是否允许 force push / deletion），以及 GitHub 可读取时的 repository ruleset 摘要。部分 private 仓库可能因为 GitHub plan/visibility 限制读取 rulesets 返回错误；命令会在 JSON 里保留该错误，同时尽量展示 branch protection 状态。owner inventory 模式会先列仓库，再用 `--jobs` 并发检查每个仓库，输出顺序保持稳定。
 
 ### 配置和检查 token
 
@@ -181,7 +153,14 @@ chatgh set-token --token "$GITHUB_ACCESS_TOKEN" --save-env
 - GitHub 返回的 `permissions`。
 - 派生 capabilities：`can_read_pr`、`can_comment_pr`、`can_merge_pr`、`can_view_checks`、`can_view_actions`。
 
-`set-token` 只在当前目录能识别 GitHub remote 时生效。默认只写入 repo-scoped git credential；传 `--save-env` 时会同步写入 typed env 的 `GITHUB_ACCESS_TOKEN`。
+`set-token` 只在当前目录能识别 GitHub remote 时生效。默认只写入当前仓库自己的 `.git/config`：
+
+```ini
+[http "https://github.com/octocat/Hello-World.git"]
+    extraHeader = Authorization: Basic <base64(x-access-token:TOKEN)>
+```
+
+不要把 token 写进 remote URL，也不要把 raw `extraHeader` 输出到日志。传 `--save-env` 时会同步写入 typed env 的 `GITHUB_ACCESS_TOKEN`。
 
 ## 交互模式
 
@@ -205,7 +184,7 @@ git fetch origin main
 
 - `chatgh pr view` / `chatgh pr checks` 显示 `mergeable` 不是 `False`，`mergeable_state` 不是 `dirty`。
 - 本地基于最新 base 做过 merge 或 rebase 演练，并在该结果上跑过最相关测试。
-- CI 需要终态时用 `chatgh pr checks --wait`，不要只看一次快照。
+- CI 需要终态时，在外层流程中轮询 `chatgh pr checks`，不要只看一次快照。
 
 ## Python API
 

{chatgh-0.2.2 → chatgh-0.2.4}/src/chatgh/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

{chatgh-0.2.2 → chatgh-0.2.4}/src/chatgh/cli.py

@@ -3,7 +3,7 @@
 import click
 
 from chatgh.commands.pr import pr_group
-from chatgh.github.cli import repo_permissions, run_group, set_repo_token
+from chatgh.github.cli import repo_group, repo_permissions, run_group, set_repo_token
 
 
 @click.group()
@@ -12,6 +12,7 @@ def main() -> None:
 
 
 main.add_command(pr_group, name="pr")
+main.add_command(repo_group, name="repo")
 main.add_command(run_group, name="run")
 main.add_command(repo_permissions, name="repo-perms")
 main.add_command(set_repo_token, name="set-token")

{chatgh-0.2.2 → chatgh-0.2.4}/src/chatgh/github/api.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import base64
 from urllib.parse import urlparse
 import subprocess
 from typing import Optional, TypedDict
@@ -74,7 +75,7 @@ def resolve_token_with_source(
         credential_path, exact_only=exact_only
     )
     if credential_token:
-        return {"token": credential_token, "source": "git credential"}
+        return {"token": credential_token, "source": "repo git config"}
     credential_token = read_github_token_from_credentials(
         credential_path, exact_only=exact_only
     )
@@ -212,20 +213,22 @@ def read_github_token_from_git(
 ) -> Optional[str]:
     if not credential_path:
         return None
-    return _git_credential_fill(credential_path)
+    return _read_repo_local_extraheader(credential_path)
 
 
-def _git_credential_fill(credential: CredentialQuery) -> Optional[str]:
-    credential_input = (
-        f"protocol={credential['protocol']}\n"
-        f"host={credential['host']}\n"
-        f"path={credential['path']}\n"
-    )
-    credential_input += "\n"
+def _github_https_url(credential: CredentialQuery) -> str:
+    path = credential["path"].strip().removeprefix("/").removesuffix(".git")
+    return f"https://{credential['host']}/{path}.git"
+
+
+def _extraheader_config_key(credential: CredentialQuery) -> str:
+    return f"http.{_github_https_url(credential)}.extraHeader"
+
+
+def _read_repo_local_extraheader(credential: CredentialQuery) -> Optional[str]:
     try:
         result = subprocess.run(
-            ["git", "credential", "fill"],
-            input=credential_input,
+            ["git", "config", "--local", "--get", _extraheader_config_key(credential)],
             check=False,
             capture_output=True,
             text=True,
@@ -234,41 +237,30 @@ def _git_credential_fill(credential: CredentialQuery) -> Optional[str]:
         return None
     if result.returncode != 0:
         return None
-    values: dict[str, str] = {}
-    for line in result.stdout.splitlines():
-        if "=" not in line:
-            continue
-        key, value = line.split("=", 1)
-        values[key] = value
-    if values.get("host") != credential["host"]:
+    return _token_from_extraheader(result.stdout.strip())
+
+
+def _token_from_extraheader(header: str) -> Optional[str]:
+    prefix = "Authorization: Basic "
+    if not header.startswith(prefix):
+        return None
+    encoded = header[len(prefix) :].strip()
+    try:
+        decoded = base64.b64decode(encoded).decode("utf-8")
+    except Exception:
+        return None
+    username, sep, password = decoded.partition(":")
+    if sep != ":" or username != "x-access-token" or not password:
         return None
-    return values.get("password") or None
+    return password
 
 
 def configure_github_https_token(credential: CredentialQuery, token: str) -> None:
     try:
+        raw = f"x-access-token:{token}".encode("utf-8")
+        header = "Authorization: Basic " + base64.b64encode(raw).decode("ascii")
         subprocess.run(
-            ["git", "config", "--global", "credential.helper", "store"],
-            check=True,
-            capture_output=True,
-            text=True,
-        )
-        subprocess.run(
-            ["git", "config", "--global", "credential.useHttpPath", "true"],
-            check=True,
-            capture_output=True,
-            text=True,
-        )
-        credential_input = (
-            f"protocol={credential['protocol']}\n"
-            f"host={credential['host']}\n"
-            f"path={credential['path']}\n"
-            "username=x-access-token\n"
-            f"password={token}\n\n"
-        )
-        subprocess.run(
-            ["git", "credential", "approve"],
-            input=credential_input,
+            ["git", "config", "--local", _extraheader_config_key(credential), header],
             check=True,
             capture_output=True,
             text=True,