aicortexpy 0.1.0__py3-none-any.whl

aicortexpy/data/default_skills/test-report-generator/scripts/generate_cases.py

@@ -0,0 +1,146 @@
+# @AI_GENERATED
+"""
+生成 Excel 测试用例清单（.xlsx），按模块分 Sheet。
+
+依赖: pip install openpyxl
+
+用法:
+    python generate_cases.py --output "测试用例.xlsx"
+
+复用方式:
+    from generate_cases import build_workbook
+    build_workbook(modules, "用例.xlsx")
+
+modules 结构: {"Sheet名(模块)": [用例dict, ...], ...}
+用例 dict 字段:
+    id            用例编号（多步骤用例仅首行填，续行用 "" 表示延续）
+    name          用例名称
+    module        所属模块（路径式，如 /需求/模块/子模块/场景）
+    precondition  前置条件（可空）
+    remark        备注（可空）
+    step          步骤描述
+    expected      预期结果
+    level         用例等级 P0/P1/P2/P3
+    owner         责任人(ID)（可选）
+"""
+import argparse
+
+import openpyxl
+from openpyxl.styles import Alignment, Border, Font, PatternFill, Side
+from openpyxl.utils import get_column_letter
+
+
+HEADERS = ["ID", "用例名称", "所属模块", "前置条件", "备注",
+           "步骤描述", "预期结果", "用例等级", "责任人(ID)"]
+FIELDS = ["id", "name", "module", "precondition", "remark",
+          "step", "expected", "level", "owner"]
+# 列宽（字符数）
+WIDTHS = [10, 24, 34, 20, 16, 40, 40, 10, 14]
+
+HEADER_FILL = PatternFill("solid", fgColor="4472C4")
+HEADER_FONT = Font(bold=True, color="FFFFFF", size=11)
+BODY_FONT = Font(size=10)
+THIN = Side(style="thin", color="BFBFBF")
+BORDER = Border(left=THIN, right=THIN, top=THIN, bottom=THIN)
+WRAP_TOP = Alignment(wrap_text=True, vertical="top")
+HEADER_ALIGN = Alignment(horizontal="center", vertical="center")
+
+# Excel Sheet 名非法字符与长度限制
+_INVALID = set(r'[]:*?/\\')
+
+
+def _safe_sheet_name(name, used):
+    name = "".join("_" if c in _INVALID else c for c in str(name))[:31] or "Sheet"
+    base, i = name, 1
+    while name in used:
+        suffix = f"_{i}"
+        name = base[:31 - len(suffix)] + suffix
+        i += 1
+    used.add(name)
+    return name
+
+
+def _write_sheet(ws, cases):
+    # 表头
+    for col, title in enumerate(HEADERS, start=1):
+        c = ws.cell(row=1, column=col, value=title)
+        c.fill = HEADER_FILL
+        c.font = HEADER_FONT
+        c.alignment = HEADER_ALIGN
+        c.border = BORDER
+    # 正文
+    for r, case in enumerate(cases, start=2):
+        for col, field in enumerate(FIELDS, start=1):
+            val = case.get(field, "")
+            c = ws.cell(row=r, column=col, value=val)
+            c.font = BODY_FONT
+            c.alignment = WRAP_TOP
+            c.border = BORDER
+    # 列宽
+    for col, w in enumerate(WIDTHS, start=1):
+        ws.column_dimensions[get_column_letter(col)].width = w
+    # 冻结表头
+    ws.freeze_panes = "A2"
+
+
+def build_workbook(modules, output_path):
+    wb = openpyxl.Workbook()
+    wb.remove(wb.active)
+    used = set()
+    for sheet_name, cases in modules.items():
+        ws = wb.create_sheet(_safe_sheet_name(sheet_name, used))
+        _write_sheet(ws, cases)
+    if not wb.sheetnames:  # 防止空工作簿
+        wb.create_sheet("用例")
+    wb.save(output_path)
+    return output_path
+
+
+# ----------------------------- 示例数据 -----------------------------
+SAMPLE_MODULES = {
+    "三方登录注册和绑定": [
+        {
+            "id": 122946, "name": "取消绑定",
+            "module": "/需求/三方登录/APP端/账号绑定/功能",
+            "precondition": "", "remark": "",
+            "step": "用户进入绑定页面，选择绑定第三方账号，进入第三方账号后点击取消",
+            "expected": "返回到 app 绑定页", "level": "P1", "owner": "",
+        },
+        {
+            "id": 122944, "name": "重复绑定",
+            "module": "/需求/三方登录/APP端/账号绑定/功能",
+            "precondition": "", "remark": "",
+            "step": "用一个新的未绑定第三方账号去绑定已绑定的 app 账号",
+            "expected": "绑定失败并给出相应提示", "level": "P1", "owner": "",
+        },
+    ],
+    "电价设置": [
+        # 多步骤用例示例：首行填 ID，续行 ID/名称/模块/前置留空
+        {
+            "id": 122737, "name": "设置全时段电价为 1.99",
+            "module": "/需求/电价设置/按日期设置电价",
+            "precondition": "", "remark": "",
+            "step": "点击电价设置入口", "expected": "进入电价设置页",
+            "level": "P1", "owner": "",
+        },
+        {
+            "id": "", "name": "", "module": "", "precondition": "", "remark": "",
+            "step": "保持默认时间，只设置电价点击保存", "expected": "弹出相应提示",
+            "level": "", "owner": "",
+        },
+        {
+            "id": "", "name": "", "module": "", "precondition": "", "remark": "",
+            "step": "点击确认", "expected": "电价保存成功",
+            "level": "", "owner": "",
+        },
+    ],
+}
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="生成 Excel 测试用例清单")
+    parser.add_argument("--output", default="测试用例.xlsx", help="输出文件路径")
+    args = parser.parse_args()
+    path = build_workbook(SAMPLE_MODULES, args.output)
+    print(f"已生成测试用例清单: {path}")
+# @AI_GENERATED: end

aicortexpy/data/default_skills/test-report-generator/scripts/generate_report.py

@@ -0,0 +1,275 @@
+# @AI_GENERATED
+"""
+生成 Word 测试报告（.docx）。
+
+依赖: pip install python-docx
+
+用法:
+    python generate_report.py --output "功能测试报告.docx"
+
+复用方式:
+    from generate_report import build_report
+    build_report(data, "报告.docx")
+
+data 结构见文件底部 SAMPLE_DATA。AGENT 应将真实数据填入同样结构后调用 build_report。
+关键结论字段（缺陷统计、修复率、结论）必须来自真实数据，不得编造。
+"""
+import argparse
+
+from docx import Document
+from docx.enum.text import WD_ALIGN_PARAGRAPH
+from docx.enum.table import WD_TABLE_ALIGNMENT
+from docx.shared import Pt, RGBColor
+from docx.oxml.ns import qn
+
+
+# ----------------------------- 样式辅助 -----------------------------
+def _set_cell_bg(cell, hex_color):
+    """设置单元格背景色。"""
+    tc_pr = cell._tc.get_or_add_tcPr()
+    shd = tc_pr.makeelement(qn("w:shd"), {
+        qn("w:val"): "clear",
+        qn("w:color"): "auto",
+        qn("w:fill"): hex_color,
+    })
+    tc_pr.append(shd)
+
+
+def _add_table(doc, headers, rows, header_bg="4472C4", header_color=(255, 255, 255)):
+    """通用建表：首行表头加背景与加粗。rows 为二维列表。"""
+    table = doc.add_table(rows=1, cols=len(headers))
+    table.style = "Table Grid"
+    table.alignment = WD_TABLE_ALIGNMENT.CENTER
+
+    hdr = table.rows[0].cells
+    for i, text in enumerate(headers):
+        hdr[i].text = ""
+        p = hdr[i].paragraphs[0]
+        run = p.add_run(str(text))
+        run.bold = True
+        run.font.color.rgb = RGBColor(*header_color)
+        _set_cell_bg(hdr[i], header_bg)
+
+    for row in rows:
+        cells = table.add_row().cells
+        for i, val in enumerate(row):
+            cells[i].text = "" if val is None else str(val)
+    doc.add_paragraph()
+    return table
+
+
+def _add_centered(doc, text, size=None, bold=False, space_after=6):
+    p = doc.add_paragraph()
+    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    run = p.add_run(text)
+    run.bold = bold
+    if size:
+        run.font.size = Pt(size)
+    p.paragraph_format.space_after = Pt(space_after)
+    return p
+
+
+# ----------------------------- 报告构建 -----------------------------
+def build_report(data, output_path):
+    doc = Document()
+
+    # ---------- 封面 ----------
+    for _ in range(6):
+        doc.add_paragraph()
+    _add_centered(doc, data["system_name"], size=26, bold=True, space_after=12)
+    _add_centered(doc, data.get("stage", ""), size=18, bold=True, space_after=12)
+    _add_centered(doc, "测试报告", size=22, bold=True, space_after=48)
+    for _ in range(6):
+        doc.add_paragraph()
+    _add_centered(doc, data.get("org", ""), size=14)
+    _add_centered(doc, data.get("date", ""), size=14)
+    doc.add_page_break()
+
+    # ---------- 文档修订信息 ----------
+    doc.add_heading("文档修订信息", level=1)
+    _add_table(
+        doc,
+        ["版本", "修改内容描述", "修改人", "日期", "审批人"],
+        data.get("revisions", []),
+    )
+    doc.add_page_break()
+
+    # ---------- 目录 ----------
+    doc.add_heading("目录", level=1)
+    toc = doc.add_paragraph()
+    run = toc.add_run()
+    fld = run._r.makeelement(qn("w:fldSimple"), {qn("w:instr"): r"TOC \o \"1-3\" \h \z \u"})
+    placeholder = fld.makeelement(qn("w:r"), {})
+    t = placeholder.makeelement(qn("w:t"), {})
+    t.text = "（打开文档后右键“更新域”生成目录）"
+    placeholder.append(t)
+    fld.append(placeholder)
+    run._r.append(fld)
+    doc.add_page_break()
+
+    # ---------- 1. 概述 ----------
+    doc.add_heading("1. 概述", level=1)
+    doc.add_heading("1.1 测试目的", level=2)
+    doc.add_paragraph(data["overview"]["purpose"])
+
+    doc.add_heading("1.2 测试范围", level=2)
+    _add_table(
+        doc,
+        ["#", "模块", "核心功能"],
+        [[i + 1, m["module"], m["features"]] for i, m in enumerate(data["scope"])],
+    )
+
+    doc.add_heading("1.3 参考资料", level=2)
+    for ref in data["overview"].get("references", []):
+        doc.add_paragraph(ref, style="List Bullet")
+
+    # ---------- 2. 测试内容 ----------
+    doc.add_heading("2. 测试内容", level=1)
+
+    doc.add_heading("2.1 测试版本", level=2)
+    _add_table(
+        doc,
+        ["软件名称及组织", "软件版本"],
+        [[v["name"], v["version"]] for v in data["versions"]],
+    )
+
+    doc.add_heading("2.2 测试环境", level=2)
+    doc.add_paragraph("环境地址：")
+    _add_table(
+        doc,
+        ["环境", "地址"],
+        [[e["env"], e["addr"]] for e in data["environment"].get("envs", [])],
+    )
+    doc.add_paragraph("移动端手机型号以及系统：")
+    _add_table(
+        doc,
+        ["系统", "型号", "版本"],
+        [[d["os"], d["model"], d["version"]] for d in data["environment"].get("mobile", [])],
+    )
+    doc.add_paragraph("Web端浏览器版本：")
+    _add_table(
+        doc,
+        ["浏览器", "版本"],
+        [[b["browser"], b["version"]] for b in data["environment"].get("browsers", [])],
+    )
+
+    doc.add_heading("2.3 测试执行", level=2)
+    doc.add_heading("2.3.1 功能测试及结果", level=3)
+    doc.add_paragraph("核心测试点结果如下：")
+    _add_table(
+        doc,
+        ["#", "模块", "核心功能", "测试结果"],
+        [[i + 1, r["module"], r["features"], r["result"]]
+         for i, r in enumerate(data["function_results"])],
+    )
+
+    doc.add_heading("2.3.2 集成测试及结果", level=3)
+    doc.add_paragraph("核心测试点结果如下：")
+    _add_table(
+        doc,
+        ["ID", "所属模块", "核心测试点", "测试结果"],
+        [[r["id"], r["module"], r["point"], r["result"]]
+         for r in data.get("integration_results", [])],
+    )
+
+    doc.add_heading("2.3.3 详细测试用例", level=3)
+    doc.add_paragraph(
+        data.get("detail_cases_note",
+                 "详细测试用例见配套附件 Excel 用例清单。")
+    )
+
+    # ---------- 3. 测试结论 ----------
+    doc.add_heading("3. 测试结论", level=1)
+    doc.add_heading("3.1 测试结果", level=2)
+    conclusion = data["conclusion"]
+    doc.add_paragraph(conclusion["verdict"])
+    for para in conclusion.get("summary", []):
+        doc.add_paragraph(para)
+    doc.add_paragraph("过程缺陷分析如下：")
+    d = conclusion["defects"]
+    _add_table(
+        doc,
+        ["问题总数", "严重问题数", "中等问题数", "较轻问题",
+         "未解决问题数", "问题解决率", "严重问题比率"],
+        [[d["total"], d["critical"], d["medium"], d["minor"],
+          d["unresolved"], d["resolve_rate"], d["critical_rate"]]],
+    )
+
+    doc.add_heading("3.2 遗留问题列表", level=2)
+    _add_table(
+        doc,
+        ["模块", "问题描述", "说明"],
+        [[i["module"], i["desc"], i["note"]] for i in data.get("open_issues", [])],
+    )
+
+    doc.save(output_path)
+    return output_path
+
+
+# ----------------------------- 示例数据 -----------------------------
+SAMPLE_DATA = {
+    "system_name": "示例平台",
+    "stage": "P2阶段",
+    "org": "示例科技有限公司",
+    "date": "2024年07月08日",
+    "revisions": [
+        ["V1.0", "初始编制", "张三", "2024/7/08", "李四"],
+    ],
+    "overview": {
+        "purpose": "本次报告为示例平台 P2 阶段功能测试报告。测试目的在于验证测试环境"
+                   "移动端及 web 端部分新增功能以及原有功能的正常使用。",
+        "references": ["产品规格说明书.doc", "测试计划.doc"],
+    },
+    "scope": [
+        {"module": "三方登录和绑定", "features": "绑定三方账号 / 登录 / 解绑"},
+        {"module": "消息中心", "features": "公告接收 / 已读消息"},
+    ],
+    "versions": [
+        {"name": "前端", "version": "tag_1.0.8_2024070401"},
+        {"name": "后端", "version": "tag_1.2.8_240708"},
+    ],
+    "environment": {
+        "envs": [
+            {"env": "功能测试环境", "addr": "https://example.com/#/login"},
+        ],
+        "mobile": [
+            {"os": "iOS", "model": "iPhone 14 Pro", "version": "17.5.1"},
+            {"os": "Android", "model": "Galaxy A53 5G", "version": "Android 13"},
+        ],
+        "browsers": [
+            {"browser": "Chrome", "version": "126.0.6478.127（64 位）"},
+        ],
+    },
+    "function_results": [
+        {"module": "三方登录和绑定", "features": "绑定 / 登录 / 解绑", "result": "Pass"},
+        {"module": "消息中心", "features": "公告接收 / 已读", "result": "Pass"},
+    ],
+    "integration_results": [
+        {"id": 1, "module": "公司管理", "point": "创建公司", "result": "Pass"},
+    ],
+    "detail_cases_note": "详细测试用例见配套附件《示例-测试用例.xlsx》。",
+    "conclusion": {
+        "verdict": "测试通过。",
+        "summary": [
+            "本次执行了一轮功能测试、一轮集成测试和两轮回归测试，"
+            "共执行新增用例约 730 条，回归用例约 300 条，发现缺陷 110 个。",
+            "所有严重及中等缺陷均已修复，整体修复率 98%，达到上线标准。",
+        ],
+        "defects": {
+            "total": 110, "critical": 8, "medium": 65, "minor": 37,
+            "unresolved": 2, "resolve_rate": "98%", "critical_rate": "7%",
+        },
+    },
+    "open_issues": [
+        {"module": "建站管理", "desc": "欧洲地址建站时区显示错误", "note": "下一版本修复"},
+    ],
+}
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="生成 Word 测试报告")
+    parser.add_argument("--output", default="功能测试报告.docx", help="输出文件路径")
+    args = parser.parse_args()
+    path = build_report(SAMPLE_DATA, args.output)
+    print(f"已生成测试报告: {path}")
+# @AI_GENERATED: end

aicortexpy/design_seed.py

@@ -0,0 +1,59 @@
+"""Seed design example bundles into task workdirs (Go design.SeedExample*)."""
+
+from __future__ import annotations
+
+import logging
+import shutil
+from pathlib import Path
+from typing import Any
+
+log = logging.getLogger("aicortexpy.design_seed")
+
+MARKER = ".aicortex-design-example"
+
+
+def seed_example_workdir(
+    work_dir: Path,
+    example_id: str,
+    bundles: list[dict[str, Any]],
+    *,
+    design_studio: bool = False,
+) -> None:
+    example_id = (example_id or "").strip()
+    if not example_id:
+        return
+    target = work_dir / "design" if design_studio else work_dir
+    target.mkdir(parents=True, exist_ok=True)
+    marker = target / MARKER
+    if marker.is_file() and marker.read_text(encoding="utf-8").strip() == example_id:
+        log.debug("design example already seeded id=%s", example_id)
+        return
+
+    for b in bundles:
+        if not isinstance(b, dict):
+            continue
+        src = Path(str(b.get("src") or ""))
+        dest_rel = str(b.get("dest") or "").lstrip("/\\")
+        if not src.is_file() and not src.is_dir():
+            log.warning("design seed skip missing src=%s", src)
+            continue
+        if not dest_rel or ".." in dest_rel.split("/"):
+            log.warning("design seed skip unsafe dest=%s", dest_rel)
+            continue
+        dest = target / dest_rel
+        dest.parent.mkdir(parents=True, exist_ok=True)
+        try:
+            if src.is_dir():
+                if dest.exists():
+                    shutil.rmtree(dest)
+                shutil.copytree(src, dest)
+            else:
+                shutil.copy2(src, dest)
+        except OSError as e:
+            log.warning("design seed copy failed %s -> %s: %s", src, dest, e)
+
+    try:
+        marker.write_text(example_id, encoding="utf-8")
+    except OSError as e:
+        log.warning("design seed marker failed: %s", e)
+    log.info("design example seeded id=%s dest=%s", example_id, target)

aicortexpy/diskusage.py

@@ -0,0 +1,209 @@
+"""Read-only workspace disk usage scan (parity with Go diskusage.go)."""
+
+from __future__ import annotations
+
+import json
+import time
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+
+
+DEFAULT_ARTIFACT_PATTERNS = ("node_modules", ".next", ".turbo", "dist", "build", "__pycache__")
+
+
+@dataclass
+class TaskDiskUsage:
+    workspace_id: str
+    workspace_short: str
+    task_short: str
+    path: str
+    kind: str
+    parent_status: str
+    age_seconds: int
+    size_bytes: int
+    artifact_size_bytes: int
+
+
+@dataclass
+class WorkspaceDiskUsage:
+    workspace_id: str
+    workspace_short: str
+    task_count: int
+    size_bytes: int
+    artifact_size_bytes: int
+    artifact_ratio: float
+    oldest_age_seconds: int
+
+
+@dataclass
+class DiskUsageReport:
+    workspaces_root: str
+    generated_at: str
+    artifact_patterns: list[str]
+    tasks: list[TaskDiskUsage] = field(default_factory=list)
+    workspaces: list[WorkspaceDiskUsage] = field(default_factory=list)
+    total_task_count: int = 0
+    total_workspace_count: int = 0
+    total_size_bytes: int = 0
+    total_artifact_size_bytes: int = 0
+    total_artifact_ratio: float = 0.0
+
+
+def scan_disk_usage(
+    workspaces_root: Path | str,
+    artifact_patterns: list[str] | None = None,
+) -> DiskUsageReport:
+    root = Path(workspaces_root)
+    patterns = _pattern_set(artifact_patterns or list(DEFAULT_ARTIFACT_PATTERNS))
+    report = DiskUsageReport(
+        workspaces_root=str(root),
+        generated_at=time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
+        artifact_patterns=sorted(patterns),
+    )
+    if not root.is_dir():
+        return report
+
+    ws_agg: dict[str, WorkspaceDiskUsage] = {}
+    now = time.time()
+
+    for ws_entry in root.iterdir():
+        if not ws_entry.is_dir() or ws_entry.name == ".repos":
+            continue
+        ws_id = ws_entry.name
+        for task_entry in ws_entry.iterdir():
+            if not task_entry.is_dir():
+                continue
+            # Skip pinned projects tree at workspace/projects/
+            if task_entry.name == "projects":
+                continue
+            usage = _task_usage(task_entry, ws_id, patterns, now)
+            report.tasks.append(usage)
+            report.total_size_bytes += usage.size_bytes
+            report.total_artifact_size_bytes += usage.artifact_size_bytes
+            agg = ws_agg.get(ws_id)
+            if agg is None:
+                agg = WorkspaceDiskUsage(
+                    workspace_id=ws_id,
+                    workspace_short=ws_id[:8],
+                    task_count=0,
+                    size_bytes=0,
+                    artifact_size_bytes=0,
+                    artifact_ratio=0.0,
+                    oldest_age_seconds=usage.age_seconds,
+                )
+                ws_agg[ws_id] = agg
+            agg.task_count += 1
+            agg.size_bytes += usage.size_bytes
+            agg.artifact_size_bytes += usage.artifact_size_bytes
+            if usage.age_seconds > agg.oldest_age_seconds:
+                agg.oldest_age_seconds = usage.age_seconds
+
+    workspaces = list(ws_agg.values())
+    for ws in workspaces:
+        ws.artifact_ratio = (
+            (ws.artifact_size_bytes / ws.size_bytes) if ws.size_bytes else 0.0
+        )
+    workspaces.sort(key=lambda w: w.size_bytes, reverse=True)
+    report.workspaces = workspaces
+    report.total_task_count = len(report.tasks)
+    report.total_workspace_count = len(workspaces)
+    report.total_artifact_ratio = (
+        (report.total_artifact_size_bytes / report.total_size_bytes)
+        if report.total_size_bytes
+        else 0.0
+    )
+    report.tasks.sort(key=lambda t: t.size_bytes, reverse=True)
+    return report
+
+
+def report_to_dict(report: DiskUsageReport) -> dict:
+    return asdict(report)
+
+
+def format_report_table(report: DiskUsageReport, *, top: int = 20) -> str:
+    lines = [
+        f"workspaces_root: {report.workspaces_root}",
+        f"total: tasks={report.total_task_count} workspaces={report.total_workspace_count} "
+        f"size={_fmt_bytes(report.total_size_bytes)} "
+        f"artifacts={_fmt_bytes(report.total_artifact_size_bytes)} "
+        f"({report.total_artifact_ratio:.0%})",
+        "",
+        f"{'SIZE':>10} {'ART':>10} {'AGE':>8}  PATH",
+    ]
+    for t in report.tasks[: max(1, top)]:
+        lines.append(
+            f"{_fmt_bytes(t.size_bytes):>10} {_fmt_bytes(t.artifact_size_bytes):>10} "
+            f"{_fmt_age(t.age_seconds):>8}  {t.path}"
+        )
+    return "\n".join(lines)
+
+
+def _pattern_set(patterns: list[str]) -> set[str]:
+    out: set[str] = set()
+    for p in patterns:
+        name = Path(str(p)).name.strip()
+        if name and "/" not in name and "\\" not in name and name not in (".", ".."):
+            out.add(name)
+    return out
+
+
+def _task_usage(task_dir: Path, ws_id: str, patterns: set[str], now: float) -> TaskDiskUsage:
+    size = 0
+    art = 0
+    for path in task_dir.rglob("*"):
+        try:
+            if path.is_symlink() or not path.is_file():
+                continue
+            if ".git" in path.parts:
+                continue
+            n = path.stat().st_size
+        except OSError:
+            continue
+        size += n
+        if any(part in patterns for part in path.parts):
+            art += n
+    kind = "unknown"
+    parent_status = ""
+    meta = task_dir / ".gc_meta.json"
+    if meta.is_file():
+        try:
+            data = json.loads(meta.read_text(encoding="utf-8"))
+            kind = str(data.get("kind") or kind)
+            parent_status = str(data.get("parent_status") or "")
+        except (OSError, json.JSONDecodeError):
+            pass
+    try:
+        mtime = task_dir.stat().st_mtime
+    except OSError:
+        mtime = now
+    age = max(0, int(now - mtime))
+    return TaskDiskUsage(
+        workspace_id=ws_id,
+        workspace_short=ws_id[:8],
+        task_short=task_dir.name[:8],
+        path=str(task_dir),
+        kind=kind,
+        parent_status=parent_status,
+        age_seconds=age,
+        size_bytes=size,
+        artifact_size_bytes=art,
+    )
+
+
+def _fmt_bytes(n: int) -> str:
+    x = float(n)
+    for unit in ("B", "KB", "MB", "GB", "TB"):
+        if abs(x) < 1024 or unit == "TB":
+            if unit == "B":
+                return f"{int(x)}{unit}"
+            return f"{x:.1f}{unit}"
+        x /= 1024
+    return f"{n}B"
+
+
+def _fmt_age(seconds: int) -> str:
+    if seconds < 3600:
+        return f"{seconds // 60}m"
+    if seconds < 86400:
+        return f"{seconds // 3600}h"
+    return f"{seconds // 86400}d"