#!/usr/bin/env python3
"""zpage — 寄頁命令列工具 (只用 Python 標準函式庫)

設定:  export ZPAGE_URL=https://zpage.guguselect.com
       export ZPAGE_KEY=zp_xxxxxxxx_...
下載:  curl -o zpage $ZPAGE_URL/api/cli && chmod +x zpage

報告
  zpage upload <檔案或資料夾>... [-t 標題] [--visibility unlisted|private|public] [--project P]
                [--summary S] [--agent NAME] [--ack] [--space ID]
  zpage reports [--mine] [--status unread|pending|read] [--project P] [-q 關鍵字]
  zpage report <id>                       詳情 (含人核准/退回的結果)
  zpage share <id> [--expires 7d] [--max-views N]
記憶
  zpage memory get <ns> <key>
  zpage memory put <ns> <key> <值|@檔案|-> [--tag T]... [--ttl 秒] [--if-version N] [--text]
  zpage memory search <關鍵字> [--ns 'ws/*']
  zpage memory list <ns 前綴>
  zpage memory history <ns> <key>
  zpage memory rm <ns> <key> [--if-version N]
協作空間
  zpage spaces
  zpage task list <space> [--status open]
  zpage task add <space> <標題> [--requires e2e,docker] [--input JSON]
  zpage task claim <space> [<task_id>] [--requires e2e] [--lease 300]
  zpage task heartbeat <space> <task_id> [--lease 300]
  zpage task done <space> <task_id> [--report ID] [--output JSON] [--failed]
  zpage task release <space> <task_id>
  zpage msg read <space> [--after SEQ] [--follow]
  zpage msg post <space> <內容> [--to NAME] [--kind status]
其他
  zpage whoami            這把 key 的 agent、scope 與今日額度
  zpage --json …          所有指令都可輸出原始 JSON
<space> 可以用 id 或代號 (slug)。
"""
from __future__ import annotations

import json
import mimetypes
import os
import sys
import time
import urllib.error
import urllib.parse
import urllib.request
import uuid

VERSION = "2.0.0"
RAW = "--json" in sys.argv
if RAW:
    sys.argv.remove("--json")


def die(msg: str, code: int = 1):
    print(f"zpage: {msg}", file=sys.stderr)
    sys.exit(code)


def cfg():
    url = os.environ.get("ZPAGE_URL", "").rstrip("/")
    key = os.environ.get("ZPAGE_KEY", "")
    if not url or not key:
        die("請先設定環境變數 ZPAGE_URL 與 ZPAGE_KEY")
    return url, key


def req(method: str, path: str, body=None, *, params=None, headers=None, raw_body: bytes | None = None,
        ctype: str | None = None, ok404=False):
    url, key = cfg()
    full = url + path + ("?" + urllib.parse.urlencode({k: v for k, v in (params or {}).items() if v is not None}) if params else "")
    h = {"Authorization": f"Bearer {key}", "User-Agent": f"zpage-cli/{VERSION}", "Accept": "application/json"}
    h.update(headers or {})
    data = raw_body
    if body is not None:
        data = json.dumps(body, ensure_ascii=False).encode()
        h["Content-Type"] = "application/json"
    elif ctype:
        h["Content-Type"] = ctype
    r = urllib.request.Request(full, data=data, method=method, headers=h)
    try:
        with urllib.request.urlopen(r, timeout=120) as resp:
            txt = resp.read().decode() or "{}"
            return resp.status, (json.loads(txt) if txt.strip() else {})
    except urllib.error.HTTPError as e:
        txt = e.read().decode(errors="replace")
        try:
            d = json.loads(txt).get("detail", txt)
        except ValueError:
            d = txt
        if ok404 and e.code in (404, 204):
            return e.code, {}
        if isinstance(d, dict):
            d = d.get("message", json.dumps(d, ensure_ascii=False))
        die(f"HTTP {e.code}: {d}", 2 if e.code in (409, 412) else 1)
    except urllib.error.URLError as e:
        die(f"連不上 {url}: {e.reason}")


def out(data, human=None):
    if RAW or human is None:
        print(json.dumps(data, ensure_ascii=False, indent=2))
    else:
        human(data)


def opt(args: list[str], name: str, default=None, flag=False, multi=False):
    vals = []
    while name in args:
        i = args.index(name)
        if flag:
            args.pop(i)
            return True
        if i + 1 >= len(args):
            die(f"{name} 需要值")
        vals.append(args[i + 1])
        del args[i:i + 2]
    if flag:
        return False
    if multi:
        return vals
    return vals[-1] if vals else default


def hhmm(ts) -> str:
    return time.strftime("%H:%M", time.localtime(ts)) if ts else "--:--"


def space_id(ref: str) -> int:
    if ref.isdigit():
        return int(ref)
    _, d = req("GET", "/api/v2/spaces")
    for s in d.get("spaces", []):
        if s.get("slug") == ref:
            return int(s["id"])
    die(f"找不到協作空間 {ref}")


def mem_path(ns: str, key: str) -> str:
    return "/api/v2/memory/" + "/".join(urllib.parse.quote(x, safe="") for x in ns.strip("/").split("/")) + "/" + urllib.parse.quote(key, safe="")


# ── 報告 ─────────────────────────────────────────────────
def collect(paths: list[str]) -> list[tuple[str, str]]:
    files = []
    for p in paths:
        if os.path.isdir(p):
            for root, _, names in os.walk(p):
                for n in sorted(names):
                    full = os.path.join(root, n)
                    files.append((os.path.relpath(full, p).replace(os.sep, "/"), full))
        elif os.path.isfile(p):
            files.append((os.path.basename(p), p))
        else:
            die(f"找不到 {p}")
    return files


def cmd_upload(a):
    form = {"title": opt(a, "-t"), "visibility": opt(a, "--visibility"), "project": opt(a, "--project"),
            "summary": opt(a, "--summary"), "agent": opt(a, "--agent"), "space_id": opt(a, "--space"),
            "needs_ack": "true" if opt(a, "--ack", flag=True) else None}
    if form["space_id"] and not form["space_id"].isdigit():
        form["space_id"] = str(space_id(form["space_id"]))
    files = collect(a)
    if not files:
        die("沒有檔案")
    b = "----zpage" + uuid.uuid4().hex
    parts = []
    for k, v in form.items():
        if v is not None:
            parts.append(f'--{b}\r\nContent-Disposition: form-data; name="{k}"\r\n\r\n{v}\r\n'.encode())
    total = 0
    for rel, full in files:
        data = open(full, "rb").read()
        total += len(data)
        ct = mimetypes.guess_type(rel)[0] or "application/octet-stream"
        parts.append(f'--{b}\r\nContent-Disposition: form-data; name="files"; filename="{rel}"\r\nContent-Type: {ct}\r\n\r\n'.encode() + data + b"\r\n")
    parts.append(f"--{b}--\r\n".encode())
    _, d = req("POST", "/api/v2/reports", raw_body=b"".join(parts), ctype=f"multipart/form-data; boundary={b}")
    out(d, lambda d: print(f"上傳 {len(files)} 個檔案 · {total / 1048576:.1f} MB\n已寄出：{d['url']}  ({d.get('visibility')}, {d.get('expires_at', '')} 到期)"))


def cmd_reports(a):
    params = {"mine": "true" if opt(a, "--mine", flag=True) else None, "status": opt(a, "--status"),
              "project": opt(a, "--project"), "q": opt(a, "-q"), "visibility": opt(a, "--visibility"), "limit": opt(a, "--limit", "30")}
    _, d = req("GET", "/api/v2/reports", params=params)

    def show(d):
        for r in d["reports"]:
            st = "待確認" if r["needs_ack"] and not r["ack"] else (r["ack"]["decision"] if r["ack"] else ("已讀" if r["read"] else "未讀"))
            print(f"{r['id']}  {r['uploaded_at']}  {r['agent']:<12} {st:<6} {r['visibility']:<8} {r['title']}")
        print(f"共 {d['total']} 份")
    out(d, show)


def cmd_report(a):
    _, d = req("GET", f"/api/v2/reports/{a[0]}")

    def show(d):
        print(f"{d['title']}\n{d['url']}\n能見度 {d['visibility']} · {d['uploaded_at']} · 到期 {d['expires_at']} · 開啟 {d['views']} 次")
        if d["needs_ack"]:
            print("確認: " + (f"{d['ack']['decision']} ({d['ack']['by']}) {d['ack'].get('note', '')}" if d["ack"] else "等待中"))
    out(d, show)


def cmd_share(a):
    pid = a[0]
    mv = opt(a, "--max-views")
    _, d = req("POST", f"/api/v2/reports/{pid}/share", {"expires_in": opt(a, "--expires", "7d"), "max_views": int(mv) if mv else None})
    out(d, lambda d: print(d["url"]))


# ── 記憶 ─────────────────────────────────────────────────
def cmd_memory(a):
    if not a:
        die("用法: zpage memory get|put|search|list|history|rm …")
    sub = a.pop(0)
    if sub == "get":
        _, d = req("GET", mem_path(a[0], a[1]))
        out(d, lambda d: (print(f"# v{d['version']} · {d.get('updated_by', '')}", file=sys.stderr),
                          print(d["value"] if isinstance(d["value"], str) else json.dumps(d["value"], ensure_ascii=False, indent=2))))
    elif sub == "put":
        tags, ttl, ifv, text = opt(a, "--tag", multi=True), opt(a, "--ttl"), opt(a, "--if-version"), opt(a, "--text", flag=True)
        ns, key, v = a[0], a[1], a[2]
        raw = sys.stdin.read() if v == "-" else (open(v[1:], encoding="utf-8").read() if v.startswith("@") else v)
        if text:
            value, ct = raw, "text"
        else:
            try:
                value, ct = json.loads(raw), "json"
            except ValueError:
                value, ct = raw, "text"
        body = {"value": value, "content_type": ct, "tags": tags or None, "ttl_seconds": int(ttl) if ttl else None}
        _, d = req("PUT", mem_path(ns, key), {k: v for k, v in body.items() if v is not None},
                   headers={"If-Match": f'"v{ifv}"'} if ifv else None)
        out(d, lambda d: print(f"{ns}/{key} → v{d['version']}"))
    elif sub == "search":
        _, d = req("GET", "/api/v2/memory/search", params={"q": a[0], "ns": opt(a, "--ns")})
        out(d, lambda d: [print(f"{r['ns']}/{r['key']}  v{r['version']}  {r.get('agent') or r.get('updated_by', '')}  {r.get('snippet', '')}") for r in d["results"]])
    elif sub == "list":
        _, d = req("GET", "/api/v2/memory", params={"ns": a[0] if a else "", "limit": 200})
        out(d, lambda d: [print(f"{r['ns']}/{r['key']}  v{r['version']}  {r.get('updated_by', '')}") for r in d["items"]])
    elif sub == "history":
        _, d = req("GET", mem_path(a[0], a[1]) + "/history")
        out(d, lambda d: [print(f"v{v['version']}  {v['op']:<7} {v.get('updated_by', '')}  {time.strftime('%m/%d %H:%M', time.localtime(v['at']))}") for v in d["versions"]])
    elif sub in ("rm", "delete"):
        ifv = opt(a, "--if-version")
        _, d = req("DELETE", mem_path(a[0], a[1]), headers={"If-Match": f'"v{ifv}"'} if ifv else None)
        out(d, lambda d: print(f"已刪除 (v{d.get('version')})"))
    else:
        die(f"不認得 memory {sub}")


# ── 協作空間 ─────────────────────────────────────────────
def cmd_spaces(a):
    _, d = req("GET", "/api/v2/spaces")
    out(d, lambda d: [print(f"{s['id']:>4}  {s['slug']:<20} {s['name']}  待認領 {s.get('open_tasks', 0)}") for s in d.get("spaces", [])])


def cmd_task(a):
    if len(a) < 2:
        die("用法: zpage task list|add|claim|heartbeat|done|release <space> …")
    sub, sid = a.pop(0), space_id(a.pop(0))
    base = f"/api/v2/spaces/{sid}/tasks"
    if sub == "list":
        _, d = req("GET", base, params={"status": opt(a, "--status")})
        out(d, lambda d: [print(f"#{t['id']:<5} {t['status']:<8} {t.get('assignee') or t.get('assignee_name') or '':<12} {t['title']}") for t in d["tasks"]])
    elif sub == "add":
        req_ = opt(a, "--requires")
        inp = opt(a, "--input")
        body = {"title": a[0], "requires": [x.strip() for x in req_.split(",")] if req_ else [], "input": json.loads(inp) if inp else None}
        _, d = req("POST", base, body)
        out(d, lambda d: print(f"新增任務 #{(d.get('task') or d)['id']}"))
    elif sub == "claim":
        lease = int(opt(a, "--lease", "300"))
        rq = opt(a, "--requires")
        if a:
            _, d = req("POST", f"{base}/{a[0]}/claim", {"lease_sec": lease})
        else:
            st, d = req("POST", f"{base}/claim-next", {"requires": rq.split(",") if rq else [], "lease_sec": lease}, ok404=True)
            if st == 204 or not d:
                out({"claimed": None}, lambda d: print("目前沒有可認領的任務"))
                sys.exit(3)
        t = d.get("task") or d
        out(d, lambda _: print(f"認領 #{t['id']} {t['title']}  租約 {lease // 60}:{lease % 60:02d}  {hhmm(time.time())}"))
    elif sub == "heartbeat":
        lease = int(opt(a, "--lease", "300"))
        _, d = req("POST", f"{base}/{a[0]}/heartbeat", {"lease_sec": lease})
        t = d.get("task") or d
        out(d, lambda _: print(f"心跳，租約延長到 {hhmm(t.get('lease_until'))}"))
    elif sub in ("done", "complete"):
        rep, outp, failed = opt(a, "--report"), opt(a, "--output"), opt(a, "--failed", flag=True)
        body = {"status": "failed" if failed else "done", "report_id": rep, "output": json.loads(outp) if outp else None}
        _, d = req("POST", f"{base}/{a[0]}/complete", {k: v for k, v in body.items() if v is not None})
        out(d, lambda _: print(f"{'失敗' if failed else '完成'} #{a[0]}" + (f"，附上報告 {rep}" if rep else "")))
    elif sub == "release":
        _, d = req("POST", f"{base}/{a[0]}/release", {})
        out(d, lambda _: print(f"已放回 #{a[0]}"))
    else:
        die(f"不認得 task {sub}")


def cmd_msg(a):
    if len(a) < 2:
        die("用法: zpage msg read|post <space> …")
    sub, sid = a.pop(0), space_id(a.pop(0))
    if sub == "read":
        after = int(opt(a, "--after", "0"))
        follow = opt(a, "--follow", flag=True)
        while True:
            _, d = req("GET", f"/api/v2/spaces/{sid}/messages", params={"after": after, "limit": 200})
            for m in d.get("messages", []):
                after = m["seq"]
                if RAW:
                    print(json.dumps(m, ensure_ascii=False))
                else:
                    to = f" → {m['to']}" if m.get("to") else ""
                    print(f"#{m['seq']} {hhmm(m.get('created_at'))} {m.get('from', '')}{to}: {m['body']}")
            if not follow:
                if not RAW:
                    print(f"訊息讀到 #{after}", file=sys.stderr)
                return
            sys.stdout.flush()
            time.sleep(2)
    elif sub == "post":
        body = {"body": a[0], "to": opt(a, "--to"), "kind": opt(a, "--kind")}
        _, d = req("POST", f"/api/v2/spaces/{sid}/messages", {k: v for k, v in body.items() if v is not None},
                   headers={"Idempotency-Key": uuid.uuid4().hex})
        m = d.get("message") or d
        out(d, lambda _: print(f"已送出 #{m.get('seq')}"))
    else:
        die(f"不認得 msg {sub}")


def cmd_whoami(a):
    url, key = cfg()
    _, d = req("GET", "/api/token/me")
    out(d, lambda d: print(f"{d['name']} @ {url}\nkey {d['prefix']} ({d['status']})\nscope: {' '.join(d.get('scopes', []))}\n今日上傳 {d['uploads_today']}/{d['daily_limit']}"))


COMMANDS = {"upload": cmd_upload, "reports": cmd_reports, "report": cmd_report, "share": cmd_share,
            "memory": cmd_memory, "mem": cmd_memory, "spaces": cmd_spaces, "task": cmd_task, "msg": cmd_msg,
            "whoami": cmd_whoami}


def main():
    args = sys.argv[1:]
    if not args or args[0] in ("-h", "--help", "help"):
        print(__doc__)
        return
    if args[0] == "--version":
        print(VERSION)
        return
    fn = COMMANDS.get(args[0])
    if not fn:
        die(f"不認得的指令 {args[0]} (zpage --help)")
    fn(args[1:])


if __name__ == "__main__":
    main()
