ChatLabel 0.0.1__tar.gz → 0.1.0__tar.gz

chatlabel-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: ChatLabel
+Version: 0.1.0
+Summary: ChatLabel: structured annotation tasks with auditable workbook workflows
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLabel
+Project-URL: Repository, https://github.com/ChatArch/ChatLabel
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatLabel/
+Keywords: chatlabel,chatarch,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<9.0,>=8.0
+Requires-Dist: chatstyle<0.3.0,>=0.2.0
+Requires-Dist: chatenv<0.3.0,>=0.2.10
+Requires-Dist: fastapi<1.0,>=0.110
+Requires-Dist: httpx<1.0,>=0.26
+Requires-Dist: openpyxl<4.0,>=3.1
+Requires-Dist: python-multipart<1.0,>=0.0.9
+Requires-Dist: uvicorn<1.0,>=0.27
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<10.0,>=9.5; extra == "docs"
+Requires-Dist: mkdocs-static-i18n<2.0,>=1.2; extra == "docs"
+Requires-Dist: mike<3.0,>=2.0; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLabel"><img src="https://img.shields.io/pypi/v/ChatLabel.svg" alt="PyPI 版本" /></a>
+    <a href="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml"><img src="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml/badge.svg" alt="测试状态" /></a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatLabel/"><img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="项目文档" /></a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLabel
+
+ChatLabel 是一个可审计的标注任务运行器。首个任务配置用于将印尼线路产品工作簿生成分类建议：上传 `.xlsx`、后台处理、查看进度、检查 WPS 单元格图片部件，并下载写入分类和备注的新工作簿。
+
+> 自动输出是建议结果。完成图片逐项复核、高风险审计和一致性校验前，不应作为最终业务分类。
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatLabel/>
+
+## 安装与运行
+
+```bash
+pip install ChatLabel
+chatlabel --version
+chatlabel --tree
+chatlabel serve
+```
+
+默认页面：<http://127.0.0.1:8765/>
+
+## 配置
+
+ChatLabel 从 ChatEnv 读取名为 `apple` 的既有 OpenAI profile，也可通过环境变量调整：
+
+| 变量 | 默认值 | 作用 |
+| --- | --- | --- |
+| `CHATLABEL_DATA_DIR` | `.chatlabel-data` | 上传文件与任务状态目录 |
+| `CHATLABEL_CLASSIFIER` | `rules` | `rules` 或 `openai-responses` |
+| `CHATLABEL_OPENAI_PROFILE` | `apple` | 要读取的 OpenAI profile |
+
+进程级 `OPENAI_*` 会覆盖 profile 值。网页配置接口只显示模型、API 地址和“是否有凭据”，不会返回凭据内容。
+
+## 开发验证
+
+```bash
+python -m pip install -e ".[dev,docs]"
+python -m pytest -q
+chatlabel --help
+chatlabel --tree
+python -m build
+mkdocs build --strict
+```
+
+进一步查看：[CLI 树](docs/cli-tree.md)、[能力地图](docs/capability-map.md)、[Python 接口树](docs/interface-tree.md)。

chatlabel-0.1.0/README.md

@@ -0,0 +1,54 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLabel"><img src="https://img.shields.io/pypi/v/ChatLabel.svg" alt="PyPI 版本" /></a>
+    <a href="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml"><img src="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml/badge.svg" alt="测试状态" /></a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatLabel/"><img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="项目文档" /></a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLabel
+
+ChatLabel 是一个可审计的标注任务运行器。首个任务配置用于将印尼线路产品工作簿生成分类建议：上传 `.xlsx`、后台处理、查看进度、检查 WPS 单元格图片部件，并下载写入分类和备注的新工作簿。
+
+> 自动输出是建议结果。完成图片逐项复核、高风险审计和一致性校验前，不应作为最终业务分类。
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatLabel/>
+
+## 安装与运行
+
+```bash
+pip install ChatLabel
+chatlabel --version
+chatlabel --tree
+chatlabel serve
+```
+
+默认页面：<http://127.0.0.1:8765/>
+
+## 配置
+
+ChatLabel 从 ChatEnv 读取名为 `apple` 的既有 OpenAI profile，也可通过环境变量调整：
+
+| 变量 | 默认值 | 作用 |
+| --- | --- | --- |
+| `CHATLABEL_DATA_DIR` | `.chatlabel-data` | 上传文件与任务状态目录 |
+| `CHATLABEL_CLASSIFIER` | `rules` | `rules` 或 `openai-responses` |
+| `CHATLABEL_OPENAI_PROFILE` | `apple` | 要读取的 OpenAI profile |
+
+进程级 `OPENAI_*` 会覆盖 profile 值。网页配置接口只显示模型、API 地址和“是否有凭据”，不会返回凭据内容。
+
+## 开发验证
+
+```bash
+python -m pip install -e ".[dev,docs]"
+python -m pytest -q
+chatlabel --help
+chatlabel --tree
+python -m build
+mkdocs build --strict
+```
+
+进一步查看：[CLI 树](docs/cli-tree.md)、[能力地图](docs/capability-map.md)、[Python 接口树](docs/interface-tree.md)。

{chatlabel-0.0.1 → chatlabel-0.1.0}/pyproject.toml

@@ -5,11 +5,20 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "ChatLabel"
 dynamic = ["version"]
-description = "ChatLabel: local workbook task system for Indonesia product classification"
+description = "ChatLabel: structured annotation tasks with auditable workbook workflows"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
-dependencies = ["click>=8.0", "chatstyle>=0.2.0,<0.3.0", "chatenv>=0.2.10,<0.3.0"]
+dependencies = [
+    "click>=8.0,<9.0",
+    "chatstyle>=0.2.0,<0.3.0",
+    "chatenv>=0.2.10,<0.3.0",
+    "fastapi>=0.110,<1.0",
+    "httpx>=0.26,<1.0",
+    "openpyxl>=3.1,<4.0",
+    "python-multipart>=0.0.9,<1.0",
+    "uvicorn>=0.27,<1.0",
+]
 authors = [{name = "ChatArch", email = "1073853456@qq.com"}]
 keywords = ["chatlabel", "chatarch", "cli"]
 classifiers = [
@@ -29,8 +38,8 @@ chatlabel = "chatlabel.cli:main"
 chatlabel = "chatlabel.config"
 
 [project.optional-dependencies]
-dev = ["build", "pytest", "twine"]
-docs = ["mkdocs>=1.6,<2.0", "mkdocs-material>=9.5,<9.7", "mkdocs-static-i18n>=1.2,<2.0", "mike>=2.0,<3.0"]
+dev = ["build", "pytest>=8,<10", "twine"]
+docs = ["mkdocs>=1.6,<2.0", "mkdocs-material>=9.5,<10.0", "mkdocs-static-i18n>=1.2,<2.0", "mike>=2.0,<3.0"]
 
 [tool.setuptools.dynamic]
 version = {attr = "chatlabel.__version__"}
@@ -40,3 +49,6 @@ where = ["src"]
 
 [tool.setuptools]
 include-package-data = true
+
+[tool.setuptools.package-data]
+chatlabel = ["static/*"]

chatlabel-0.1.0/src/ChatLabel.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: ChatLabel
+Version: 0.1.0
+Summary: ChatLabel: structured annotation tasks with auditable workbook workflows
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLabel
+Project-URL: Repository, https://github.com/ChatArch/ChatLabel
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatLabel/
+Keywords: chatlabel,chatarch,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<9.0,>=8.0
+Requires-Dist: chatstyle<0.3.0,>=0.2.0
+Requires-Dist: chatenv<0.3.0,>=0.2.10
+Requires-Dist: fastapi<1.0,>=0.110
+Requires-Dist: httpx<1.0,>=0.26
+Requires-Dist: openpyxl<4.0,>=3.1
+Requires-Dist: python-multipart<1.0,>=0.0.9
+Requires-Dist: uvicorn<1.0,>=0.27
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<10.0,>=9.5; extra == "docs"
+Requires-Dist: mkdocs-static-i18n<2.0,>=1.2; extra == "docs"
+Requires-Dist: mike<3.0,>=2.0; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLabel"><img src="https://img.shields.io/pypi/v/ChatLabel.svg" alt="PyPI 版本" /></a>
+    <a href="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml"><img src="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml/badge.svg" alt="测试状态" /></a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatLabel/"><img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="项目文档" /></a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLabel
+
+ChatLabel 是一个可审计的标注任务运行器。首个任务配置用于将印尼线路产品工作簿生成分类建议：上传 `.xlsx`、后台处理、查看进度、检查 WPS 单元格图片部件，并下载写入分类和备注的新工作簿。
+
+> 自动输出是建议结果。完成图片逐项复核、高风险审计和一致性校验前，不应作为最终业务分类。
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatLabel/>
+
+## 安装与运行
+
+```bash
+pip install ChatLabel
+chatlabel --version
+chatlabel --tree
+chatlabel serve
+```
+
+默认页面：<http://127.0.0.1:8765/>
+
+## 配置
+
+ChatLabel 从 ChatEnv 读取名为 `apple` 的既有 OpenAI profile，也可通过环境变量调整：
+
+| 变量 | 默认值 | 作用 |
+| --- | --- | --- |
+| `CHATLABEL_DATA_DIR` | `.chatlabel-data` | 上传文件与任务状态目录 |
+| `CHATLABEL_CLASSIFIER` | `rules` | `rules` 或 `openai-responses` |
+| `CHATLABEL_OPENAI_PROFILE` | `apple` | 要读取的 OpenAI profile |
+
+进程级 `OPENAI_*` 会覆盖 profile 值。网页配置接口只显示模型、API 地址和“是否有凭据”，不会返回凭据内容。
+
+## 开发验证
+
+```bash
+python -m pip install -e ".[dev,docs]"
+python -m pytest -q
+chatlabel --help
+chatlabel --tree
+python -m build
+mkdocs build --strict
+```
+
+进一步查看：[CLI 树](docs/cli-tree.md)、[能力地图](docs/capability-map.md)、[Python 接口树](docs/interface-tree.md)。

{chatlabel-0.0.1 → chatlabel-0.1.0}/src/ChatLabel.egg-info/SOURCES.txt

@@ -8,7 +8,17 @@ src/ChatLabel.egg-info/entry_points.txt
 src/ChatLabel.egg-info/requires.txt
 src/ChatLabel.egg-info/top_level.txt
 src/chatlabel/__init__.py
+src/chatlabel/app.py
+src/chatlabel/classifiers.py
 src/chatlabel/cli.py
 src/chatlabel/config.py
+src/chatlabel/tasks.py
+src/chatlabel/workbook.py
+src/chatlabel/static/__init__.py
+src/chatlabel/static/index.html
+tests/test_classifiers.py
 tests/test_cli.py
-tests/test_version.py
+tests/test_config.py
+tests/test_tasks.py
+tests/test_version.py
+tests/test_workbook.py

chatlabel-0.1.0/src/ChatLabel.egg-info/requires.txt

@@ -0,0 +1,19 @@
+click<9.0,>=8.0
+chatstyle<0.3.0,>=0.2.0
+chatenv<0.3.0,>=0.2.10
+fastapi<1.0,>=0.110
+httpx<1.0,>=0.26
+openpyxl<4.0,>=3.1
+python-multipart<1.0,>=0.0.9
+uvicorn<1.0,>=0.27
+
+[dev]
+build
+pytest<10,>=8
+twine
+
+[docs]
+mkdocs<2.0,>=1.6
+mkdocs-material<10.0,>=9.5
+mkdocs-static-i18n<2.0,>=1.2
+mike<3.0,>=2.0

{chatlabel-0.0.1 → chatlabel-0.1.0}/src/chatlabel/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.0.1"
+__version__ = "0.1.0"

chatlabel-0.1.0/src/chatlabel/app.py

@@ -0,0 +1,78 @@
+"""FastAPI application for the local ChatLabel console."""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from importlib import resources
+
+from fastapi import FastAPI, File, HTTPException, UploadFile
+from fastapi.responses import FileResponse, HTMLResponse
+
+from . import __version__
+from .config import AppConfig
+from .tasks import TaskStore
+
+
+@lru_cache(maxsize=1)
+def get_config() -> AppConfig:
+    return AppConfig.from_env()
+
+
+@lru_cache(maxsize=1)
+def get_store() -> TaskStore:
+    return TaskStore(get_config())
+
+
+def create_app() -> FastAPI:
+    """Create the HTTP application without starting a server process."""
+
+    application = FastAPI(title="ChatLabel", version=__version__)
+
+    @application.get("/", response_class=HTMLResponse)
+    def index() -> str:
+        return resources.files("chatlabel.static").joinpath("index.html").read_text("utf-8")
+
+    @application.get("/api/config")
+    def config() -> dict[str, object]:
+        cfg = get_config()
+        return {
+            "classifier": cfg.classifier,
+            "data_dir": str(cfg.data_dir),
+            "openai": cfg.openai.public_dict(),
+        }
+
+    @application.get("/api/tasks")
+    def list_tasks() -> list[dict[str, object]]:
+        return [task.to_dict() for task in get_store().list_tasks()]
+
+    @application.post("/api/tasks")
+    async def create_task(file: UploadFile = File(...)) -> dict[str, object]:
+        try:
+            record = get_store().create_task(file.filename or "upload.xlsx", await file.read())
+            return record.to_dict()
+        except ValueError as exc:
+            raise HTTPException(status_code=400, detail=str(exc)) from exc
+
+    @application.get("/api/tasks/{task_id}")
+    def get_task(task_id: str) -> dict[str, object]:
+        try:
+            return get_store().get_task(task_id).to_dict()
+        except FileNotFoundError as exc:
+            raise HTTPException(status_code=404, detail=str(exc)) from exc
+
+    @application.get("/api/tasks/{task_id}/download")
+    def download_task(task_id: str) -> FileResponse:
+        try:
+            path = get_store().download_path(task_id)
+        except FileNotFoundError as exc:
+            raise HTTPException(status_code=404, detail=str(exc)) from exc
+        return FileResponse(
+            path,
+            filename=path.name,
+            media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        )
+
+    return application
+
+
+app = create_app()

chatlabel-0.1.0/src/chatlabel/classifiers.py

@@ -0,0 +1,183 @@
+"""Classifier boundaries for workbook rows."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+import json
+from typing import Protocol
+
+import httpx
+
+from .config import OpenAISettings
+
+
+CATEGORIES = [
+    "普货",
+    "商检货",
+    "敏感类",
+    "A类特敏",
+    "B类特敏",
+    "纺织类",
+    "慢线半纺织",
+    "慢线纺织",
+    "不接",
+]
+
+
+@dataclass(frozen=True)
+class ProductRow:
+    row_number: int
+    sku: str = ""
+    image_formula: str = ""
+    image_id: str = ""
+    name_cn: str = ""
+    name_en: str = ""
+    spec: str = ""
+    material: str = ""
+    existing_category: str = ""
+    existing_note: str = ""
+
+    def searchable_text(self) -> str:
+        parts = [self.name_cn, self.name_en, self.spec, self.material, self.existing_note]
+        return " ".join(str(part).lower() for part in parts if part)
+
+
+@dataclass(frozen=True)
+class ClassificationDecision:
+    category: str
+    note: str = ""
+    confidence: str = "medium"
+    source: str = "rules"
+
+    def __post_init__(self) -> None:
+        if self.category not in CATEGORIES:
+            raise ValueError(f"Unsupported category: {self.category}")
+
+
+class Classifier(Protocol):
+    name: str
+
+    def classify(self, row: ProductRow) -> ClassificationDecision:
+        ...
+
+
+class RuleBasedClassifier:
+    """Generate a conservative first-pass proposal for the Indonesia profile."""
+
+    name = "rules"
+
+    def classify(self, row: ProductRow) -> ClassificationDecision:
+        text = row.searchable_text()
+
+        if self._contains(text, ["军用", "无人机", "drone", "仿真枪", "玩具枪", "迷彩", "压力罐", "白色粉末", "危险品"]):
+            return ClassificationDecision("不接", "命中明确不接规则", "high")
+        if self._contains(text, ["纯磁", "强磁", "磁铁"]) and not self._contains(text, ["弱磁", "磁吸", "带磁"]):
+            return ClassificationDecision("不接", "纯磁铁/强磁产品不接", "high")
+        if self._contains(text, ["胶水", "胶粘", "adhesive", "glue"]):
+            if self._contains(text, ["睫毛", "美甲", "化妆"]):
+                return ClassificationDecision("B类特敏", "需提供MSDS和运输鉴定报告，确认非危险品后可接", "high")
+            return ClassificationDecision("A类特敏", "需提供MSDS和运输鉴定报告，确认非危险品后可接", "high")
+        if self._contains(text, ["电池", "battery", "血氧仪", "血压仪", "助听器"]):
+            return ClassificationDecision("敏感类", "敏感品类，需复核运输资料", "high")
+        if self._contains(text, ["汽车配件", "摩托车", "汽配", "坐桶", "车厢内衬"]):
+            return ClassificationDecision("商检货", "汽配类按商检货处理", "high")
+        if self._contains(text, ["金属钥匙"]):
+            return ClassificationDecision("商检货", "金属钥匙按商检货处理", "high")
+        if self._contains(text, ["不锈钢", "五金", "铰链", "导轨", "置物架"]):
+            return ClassificationDecision("敏感类", "五金/不锈钢类按敏感类处理", "medium")
+        if self._contains(text, ["插电灯", "装饰灯", "灯串"]):
+            return ClassificationDecision("敏感类", "插电或装饰灯具按敏感类处理", "medium")
+        if self._contains(text, ["汽车灯", "手电筒", "太阳能灯"]):
+            return ClassificationDecision("普货", "灯具例外规则按普货处理", "high")
+        if self._contains(text, ["芳纶手套", "牛皮手套", "铅橡胶", "阻燃帽", "灭火毯", "防护铅衣", "舞蹈扇"]):
+            return ClassificationDecision("慢线半纺织", "含纺织/防护复合材质，按慢线半纺织初判", "medium")
+        if self._contains(text, ["乳贴", "胸贴"]):
+            return ClassificationDecision("B类特敏", "贴身内衣/护垫用途按B类特敏", "high")
+        if self._contains(text, ["穿戴甲", "甲片", "气泡柱", "腕带", "塑料手套", "丁腈手套", "tpe手套", "橡胶手套"]):
+            return ClassificationDecision("普货", "命中已确认普货样例/规则", "high")
+        if self._contains(text, ["钥匙扣"]) and self._contains(text, ["木", "榉木"]):
+            return ClassificationDecision("普货", "木质钥匙扣按普货，图片若含金属环需人工确认材质", "high")
+        if self._contains(text, ["磁吸", "带磁", "弱磁"]):
+            return ClassificationDecision("普货", "弱磁；主体分类仍需人工复核", "low")
+
+        if row.existing_category in CATEGORIES:
+            note = row.existing_note or "沿用源表已有分类，建议抽检复核"
+            return ClassificationDecision(row.existing_category, note, "low", "existing")
+
+        return ClassificationDecision("普货", "规则未明确命中，默认普货建议；必须人工复核", "low")
+
+    @staticmethod
+    def _contains(text: str, needles: list[str]) -> bool:
+        return any(needle.lower() in text for needle in needles)
+
+
+class OpenAIResponsesClassifier:
+    """Responses API implementation behind the classifier protocol."""
+
+    name = "openai-responses"
+
+    def __init__(self, config: OpenAISettings, timeout: float = 60.0) -> None:
+        self.config = config
+        self.timeout = timeout
+
+    def classify(self, row: ProductRow) -> ClassificationDecision:
+        if not self.config.has_credentials:
+            raise RuntimeError("OpenAI credentials are not configured")
+
+        token = self.config.api_key or self.config.access_token
+        headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
+        payload = {
+            "model": self.config.api_model,
+            "input": [
+                {
+                    "role": "system",
+                    "content": (
+                        "你是印尼专线产品分类助手。只能输出JSON，category必须是九个合法分类之一，"
+                        "note写必要资料要求或复核原因，confidence为high/medium/low。"
+                    ),
+                },
+                {"role": "user", "content": json.dumps(row.__dict__, ensure_ascii=False)},
+            ],
+            "text": {
+                "format": {
+                    "type": "json_schema",
+                    "name": "classification_decision",
+                    "strict": True,
+                    "schema": {
+                        "type": "object",
+                        "additionalProperties": False,
+                        "properties": {
+                            "category": {"type": "string", "enum": CATEGORIES},
+                            "note": {"type": "string"},
+                            "confidence": {"type": "string", "enum": ["high", "medium", "low"]},
+                        },
+                        "required": ["category", "note", "confidence"],
+                    },
+                }
+            },
+        }
+
+        with httpx.Client(timeout=self.timeout) as client:
+            response = client.post(f"{self.config.api_base}/responses", headers=headers, json=payload)
+            response.raise_for_status()
+            data = response.json()
+
+        parsed = json.loads(self._extract_output_text(data))
+        return ClassificationDecision(
+            category=parsed["category"],
+            note=parsed.get("note", ""),
+            confidence=parsed.get("confidence", "medium"),
+            source=self.name,
+        )
+
+    @staticmethod
+    def _extract_output_text(data: dict[str, object]) -> str:
+        if isinstance(data.get("output_text"), str):
+            return str(data["output_text"])
+        for item in data.get("output", []) if isinstance(data.get("output"), list) else []:
+            if not isinstance(item, dict):
+                continue
+            for content in item.get("content", []) if isinstance(item.get("content"), list) else []:
+                if isinstance(content, dict) and isinstance(content.get("text"), str):
+                    return content["text"]
+        raise RuntimeError("Responses API result did not contain output text")

chatlabel-0.1.0/src/chatlabel/cli.py

@@ -0,0 +1,30 @@
+"""CLI entrypoint for chatlabel."""
+
+from __future__ import annotations
+
+import click
+from chatstyle import add_tree_option
+import uvicorn
+
+from chatlabel import __version__
+
+
+@click.group(name="chatlabel", no_args_is_help=True)
+@click.version_option(__version__, prog_name="chatlabel")
+@add_tree_option(renderer_options={"root_name": "chatlabel"})
+def main() -> None:
+    """Run auditable annotation tasks from a local web console."""
+
+
+@main.command("serve")
+@click.option("--host", default="127.0.0.1", show_default=True, help="Bind host.")
+@click.option("--port", default=8765, show_default=True, type=click.IntRange(1, 65535), help="Bind port.")
+@click.option("--reload", is_flag=True, help="Reload the server when source files change.")
+def serve(host: str, port: int, reload: bool) -> None:
+    """Start the local ChatLabel web console."""
+
+    uvicorn.run("chatlabel.app:app", host=host, port=port, reload=reload)
+
+
+if __name__ == "__main__":
+    main()