chatgh 0.2.2__tar.gz → 0.2.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatgh
-Version: 0.2.2
+Version: 0.2.3
 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,9 @@ 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 run view`：查看 workflow run 和 jobs。
 - `chatgh run logs`：查看 job 日志，支持 tail 和落盘。
 - `chatgh repo-perms`：查看 token 权限和派生 capabilities。
@@ -99,26 +102,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 +119,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 +132,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 +151,7 @@ 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 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
-```
-
-`pr merge --check` 会在合并前拒绝以下情况：
-
-- PR 当前 `mergeable=False`。
-- `mergeable_state` 为 `dirty`、`blocked`、`behind`、`draft` 或 `unknown`。
-- combined status、check runs 或 workflow runs 存在失败、取消或未完成项。
-
-不带 `--check` 时，命令保持直接调用 GitHub merge API 的行为。
+当前版本未公开 `chatgh pr comment/merge/edit` CLI 命令。相关业务函数已保留在 `chatgh.github.commands` 中，后续恢复为稳定 CLI surface 前，建议通过项目既有流程或 GitHub API 执行写操作。
 
 ### 配置和检查 token
 
@@ -209,7 +169,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 +200,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.3}/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,9 @@ 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 run view`：查看 workflow run 和 jobs。
 - `chatgh run logs`：查看 job 日志，支持 tail 和落盘。
 - `chatgh repo-perms`：查看 token 权限和派生 capabilities。
@@ -71,26 +74,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 +91,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 +104,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 +123,7 @@ 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 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
-```
-
-`pr merge --check` 会在合并前拒绝以下情况：
-
-- PR 当前 `mergeable=False`。
-- `mergeable_state` 为 `dirty`、`blocked`、`behind`、`draft` 或 `unknown`。
-- combined status、check runs 或 workflow runs 存在失败、取消或未完成项。
-
-不带 `--check` 时，命令保持直接调用 GitHub merge API 的行为。
+当前版本未公开 `chatgh pr comment/merge/edit` CLI 命令。相关业务函数已保留在 `chatgh.github.commands` 中，后续恢复为稳定 CLI surface 前，建议通过项目既有流程或 GitHub API 执行写操作。
 
 ### 配置和检查 token
 
@@ -181,7 +141,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 +172,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.3}/src/chatgh/__init__.py

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

{chatgh-0.2.2 → chatgh-0.2.3}/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.3}/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,

{chatgh-0.2.2 → chatgh-0.2.3}/src/chatgh/github/cli.py

@@ -14,7 +14,7 @@ from chatstyle.core.interactive import is_interactive_available
 from chatstyle.tui.prompt import BACK_VALUE, ask_text
 
 from chatgh.github.api import resolve_token
-from chatgh.github.commands import repo_perms, set_token, view_job_logs, view_run
+from chatgh.github.commands import create_repo, list_repos, repo_perms, set_token, view_job_logs, view_run
 from chatgh.github.render import echo_workflow_job, echo_workflow_run, format_optional
 
 
@@ -44,6 +44,85 @@ def run_group() -> None:
     """GitHub Actions helpers."""
 
 
+@cli.group(name="repo")
+def repo_group() -> None:
+    """Repository helpers."""
+
+
+@repo_group.command(name="list")
+@click.option("--owner", required=True, help="GitHub owner or organization.")
+@click.option("--limit", default=50, type=click.IntRange(min=1), show_default=True)
+@click.option(
+    "--sort",
+    type=click.Choice(["updated", "created", "pushed", "name", "stars", "open-prs", "open-issues"]),
+    default="updated",
+    show_default=True,
+    help="Sort repositories before applying --limit.",
+)
+@click.option("--direction", type=click.Choice(["asc", "desc"]), default="desc", show_default=True)
+@click.option("--json-output", is_flag=True, help="Output JSON.")
+@click.option("--token", default=None, help="GitHub token.")
+def repo_list(owner, limit, sort, direction, json_output, token):
+    """List repositories for an owner or organization."""
+    payload = list_repos(owner, limit, sort, direction, token)
+    if json_output:
+        click.echo(json.dumps(payload, ensure_ascii=False, indent=2))
+        return
+    _echo_repo_table(payload)
+
+
+def _echo_repo_table(items: list[dict]) -> None:
+    columns = [
+        ("repo", "full_name"),
+        ("vis", "visibility"),
+        ("stars", "stars"),
+        ("prs", "open_prs"),
+        ("issues", "open_issues"),
+        ("updated", "updated_at"),
+        ("created", "created_at"),
+    ]
+    rows = []
+    for item in items:
+        row = []
+        for _, key in columns:
+            value = item.get(key)
+            if key.endswith("_at"):
+                value = str(value or "")[:10]
+            row.append(str(value if value is not None else ""))
+        rows.append(row)
+    widths = [len(label) for label, _ in columns]
+    for row in rows:
+        for index, value in enumerate(row):
+            widths[index] = min(max(widths[index], len(value)), 48)
+    header = "  ".join(label.ljust(widths[index]) for index, (label, _) in enumerate(columns))
+    click.echo(header)
+    click.echo("  ".join("-" * width for width in widths))
+    for row in rows:
+        clipped = [value[: widths[index]] for index, value in enumerate(row)]
+        click.echo("  ".join(value.ljust(widths[index]) for index, value in enumerate(clipped)))
+
+
+@repo_group.command(name="create")
+@click.option("--owner", required=True, help="GitHub owner or organization.")
+@click.option("--name", required=True, help="Repository name.")
+@click.option("--description", default=None, help="Repository description.")
+@click.option("--public", "public_repo", is_flag=True, help="Create a public repository. Defaults to private.")
+@click.option("--if-exists", type=click.Choice(["error", "use"]), default="error", show_default=True)
+@click.option("--json-output", is_flag=True, help="Output JSON.")
+@click.option("--token", default=None, help="GitHub token.")
+def repo_create(owner, name, description, public_repo, if_exists, json_output, token):
+    """Create a repository. Repositories are private by default."""
+    payload = create_repo(owner, name, not public_repo, description, if_exists, token)
+    if json_output:
+        click.echo(json.dumps(payload, ensure_ascii=False, indent=2))
+        return
+    created = "created" if payload.get("created") else "existing"
+    private = "private" if payload.get("private") else "public"
+    click.echo(f"{created}: {payload['full_name']} ({private})")
+    if payload.get("html_url"):
+        click.echo(payload["html_url"])
+
+
 @run_group.command(name="view")
 @click.option("--repo", required=False, help="Repository in owner/name form.")
 @click.option("--run-id", required=False, type=int, help="Workflow run id.")

{chatgh-0.2.2 → chatgh-0.2.3}/src/chatgh/github/commands.py

@@ -27,12 +27,14 @@ from chatgh.github.requests import (
     get_pr_checks,
     get_pr_list,
     get_pr_view,
+    get_repo_list,
     get_repo_permissions,
     get_run_view,
     patch_pr_edit,
     post_pr_comment,
     post_pr_create,
     post_pr_merge,
+    post_repo_create,
 )
 
 
@@ -43,6 +45,34 @@ def resolve_repo_and_credential_path(repo: Optional[str]) -> tuple[str, Credenti
     return resolve_repo_from_git_remote()
 
 
+def list_repos(
+    owner: str,
+    limit: int,
+    sort: str,
+    direction: str,
+    token: Optional[str],
+) -> list[dict]:
+    credential_path = credential_path_from_repo(f"{owner}/_")
+    client = get_client(token, require_token=True, credential_path=credential_path)
+    return get_repo_list(client, owner, limit, sort, direction)
+
+
+def create_repo(
+    owner: str,
+    name: str,
+    private: bool,
+    description: Optional[str],
+    if_exists: str,
+    token: Optional[str],
+) -> dict:
+    credential_path = credential_path_from_repo(f"{owner}/{name}")
+    client = get_client(token, require_token=True, credential_path=credential_path)
+    try:
+        return post_repo_create(client, owner, name, private, description, if_exists)
+    except ValueError as exc:
+        raise click.ClickException(str(exc)) from exc
+
+
 def create_pr(
     repo: Optional[str],
     base: str,

{chatgh-0.2.2 → chatgh-0.2.3}/src/chatgh/github/requests.py

@@ -1,10 +1,61 @@
 from __future__ import annotations
 
+from datetime import datetime, timezone
 from typing import Optional
 
 from chatgh.github.api import github_api_get_json, github_api_get_text
 
 
+def get_repo_list(
+    client,
+    owner: str,
+    limit: int,
+    sort: str,
+    direction: str,
+) -> list[dict]:
+    owner_obj = _get_owner(client, owner)
+    items: list[dict] = []
+    for repo in owner_obj.get_repos():
+        items.append(_build_repo_payload(repo))
+    items.sort(
+        key=lambda item: _repo_sort_key(item, sort),
+        reverse=(direction == "desc"),
+    )
+    return items[:limit]
+
+
+def post_repo_create(
+    client,
+    owner: str,
+    name: str,
+    private: bool,
+    description: Optional[str],
+    if_exists: str,
+) -> dict:
+    full_name = f"{owner}/{name}"
+    try:
+        existing = client.get_repo(full_name)
+    except Exception as exc:
+        if getattr(exc, "status", None) != 404:
+            raise
+    else:
+        if if_exists == "use":
+            payload = _build_repo_payload(existing)
+            payload["created"] = False
+            return payload
+        raise ValueError(f"Repository already exists: {full_name}")
+
+    owner_obj = _get_owner(client, owner)
+    repo = owner_obj.create_repo(
+        name=name,
+        private=private,
+        description=description or "",
+    )
+    payload = _build_repo_payload(repo)
+    payload["created"] = True
+    return payload
+
+
 def get_pr_list(client, repo: str, state: str, limit: int) -> list[dict]:
     repo_obj = client.get_repo(repo)
     items: list[dict] = []
@@ -21,6 +72,70 @@ def get_pr_view(client, repo: str, number: int) -> dict:
     return _build_pr_view_payload(pr)
 
 
+def _get_owner(client, owner: str):
+    try:
+        return client.get_organization(owner)
+    except Exception as exc:
+        if getattr(exc, "status", None) not in {403, 404}:
+            raise
+    return client.get_user(owner)
+
+
+def _build_repo_payload(repo) -> dict:
+    open_prs = _safe_count(lambda: repo.get_pulls(state="open"))
+    open_issues_reported = int(getattr(repo, "open_issues_count", 0) or 0)
+    open_issues = max(open_issues_reported - open_prs, 0) if open_prs is not None else None
+    return {
+        "name": repo.name,
+        "full_name": repo.full_name,
+        "private": repo.private,
+        "visibility": getattr(repo, "visibility", None) or ("private" if repo.private else "public"),
+        "stars": int(getattr(repo, "stargazers_count", 0) or 0),
+        "forks": int(getattr(repo, "forks_count", 0) or 0),
+        "open_prs": open_prs,
+        "open_issues": open_issues,
+        "open_issues_reported": open_issues_reported,
+        "archived": bool(getattr(repo, "archived", False)),
+        "fork": bool(getattr(repo, "fork", False)),
+        "created_at": _isoformat(getattr(repo, "created_at", None)),
+        "updated_at": _isoformat(getattr(repo, "updated_at", None)),
+        "pushed_at": _isoformat(getattr(repo, "pushed_at", None)),
+        "html_url": repo.html_url,
+        "clone_url": getattr(repo, "clone_url", None),
+        "ssh_url": getattr(repo, "ssh_url", None),
+        "default_branch": getattr(repo, "default_branch", None),
+        "description": getattr(repo, "description", None),
+    }
+
+
+def _safe_count(factory) -> Optional[int]:
+    try:
+        return int(factory().totalCount)
+    except Exception:
+        return None
+
+
+def _repo_sort_key(item: dict, sort: str):
+    if sort in {"updated", "created", "pushed"}:
+        return _parse_time(item.get(f"{sort}_at"))
+    if sort == "stars":
+        return int(item.get("stars") or 0)
+    if sort == "open-prs":
+        return int(item.get("open_prs") or 0)
+    if sort == "open-issues":
+        return int(item.get("open_issues") or 0)
+    return str(item.get("name") or item.get("full_name") or "").lower()
+
+
+def _parse_time(value: Optional[str]) -> datetime:
+    if not value:
+        return datetime.min.replace(tzinfo=timezone.utc)
+    parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
+    if parsed.tzinfo is None:
+        return parsed.replace(tzinfo=timezone.utc)
+    return parsed
+
+
 def get_pr_checks(
     client,
     repo: str,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatgh
-Version: 0.2.2
+Version: 0.2.3
 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,9 @@ 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 run view`：查看 workflow run 和 jobs。
 - `chatgh run logs`：查看 job 日志，支持 tail 和落盘。
 - `chatgh repo-perms`：查看 token 权限和派生 capabilities。
@@ -99,26 +102,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 +119,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 +132,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 +151,7 @@ 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 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
-```
-
-`pr merge --check` 会在合并前拒绝以下情况：
-
-- PR 当前 `mergeable=False`。
-- `mergeable_state` 为 `dirty`、`blocked`、`behind`、`draft` 或 `unknown`。
-- combined status、check runs 或 workflow runs 存在失败、取消或未完成项。
-
-不带 `--check` 时，命令保持直接调用 GitHub merge API 的行为。
+当前版本未公开 `chatgh pr comment/merge/edit` CLI 命令。相关业务函数已保留在 `chatgh.github.commands` 中，后续恢复为稳定 CLI surface 前，建议通过项目既有流程或 GitHub API 执行写操作。
 
 ### 配置和检查 token
 
@@ -209,7 +169,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 +200,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.3}/tests/test_version.py

@@ -2,4 +2,4 @@ from chatgh import __version__
 
 
 def test_version_present():
-    assert __version__ == "0.2.2"
+    assert __version__ == "0.2.3"