pipeline-service/pipeline_service/storage.py

"""Pipeline storage layer - MySQL via sqlor."""

import json
from typing import Dict, List, Optional
from sqlor.dbpools import DBPools
from appPublic.uniqueID import getID
from appPublic.log import debug

DBNAME = "pipeline"


def _get_db():
    db = DBPools()
    if not db.databases:
        from appPublic.jsonConfig import getConfig
        config = getConfig()
        if config.databases:
            db.databases = config.databases
    return db, DBNAME


def _rec_to_dict(rec):
    """sqlor 返回 DictObject，列名不暴露为实例属性(dir() 只列 dict 方法)，须用 dict(rec) 取列。"""
    if isinstance(rec, dict):
        return dict(rec)
    try:
        return dict(rec)
    except (TypeError, ValueError):
        return {k: getattr(rec, k) for k in dir(rec) if not k.startswith('_')}


async def get_pipeline_steps(pipeline_id: str) -> list:
    """Read step definitions from pipeline_steps table (defined by pipeline_core).
    
    Extracts 'deps' from step_config JSON and injects it as a top-level field
    so that build_step_graph() can find it.
    """
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.sqlExe('SELECT * FROM pipeline_steps WHERE pipeline_id=${pid}$ ORDER BY step_order', {'pid': pipeline_id})
        if not recs:
            return []
        result = []
        for rec in recs:
            d = _rec_to_dict(rec)
            # Extract deps from step_config JSON
            cfg_raw = d.get('step_config', '{}')
            try:
                cfg = json.loads(cfg_raw) if isinstance(cfg_raw, str) else cfg_raw
            except (json.JSONDecodeError, TypeError):
                cfg = {}
            d['deps'] = cfg.get('deps', [])
            result.append(d)
        return result


async def create_task(tenant_id: str, pipeline_id: str, owner_id: str, title: str, params: dict, role: str = "") -> str:
    """Create a new pipeline task. Returns task_id.

    Args:
        role: 目标角色（需求/设计/开发/测试/运维）。空串=不限角色（兼容旧任务）。
              带角色的任务由角色agent循环认领执行，不带步骤记录。
    """
    if role:
        # 归一化角色名（裸名 design/test/develop → agent.{role}），与 _claim_task 匹配口径一致，
        # 避免裸名入库导致角色agent认领时匹配不上、任务卡 submitted。
        from .agent_loop import _normalize_role
        role = _normalize_role(role)
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        task_id = getID()
        data = {
            "id": task_id,
            "tenant_id": tenant_id,
            "pipeline_id": pipeline_id,
            "owner_id": owner_id,
            "title": title,
            "state": "submitted",
            "current_version": 1,
            "params": json.dumps(params, ensure_ascii=False, default=str),
            "role": role or "",
        }
        await sor.C('pipeline_tasks', data)
        return task_id


async def init_task_steps(task_id: str, step_records: list):
    """Create step execution records from pipeline step definitions."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        for rec in step_records:
            step_id = getID()
            data = {
                "id": step_id,
                "task_id": task_id,
                "step_name": getattr(rec, 'step_name', ''),
                "step_type": getattr(rec, 'step_type', '') or getattr(rec, 'step_name', ''),
                "display_name": getattr(rec, 'display_name', '') or getattr(rec, 'step_name', ''),
                "step_order": getattr(rec, 'step_order', 0),
                "deps": getattr(rec, 'deps', '[]') if isinstance(getattr(rec, 'deps', '[]'), str) else json.dumps(getattr(rec, 'deps', [])),
                "state": "pending",
            }
            await sor.C('pipeline_task_steps', data)


async def get_task(tenant_id: str, task_id: str) -> Optional[dict]:
    """Get task record, filtered by tenant."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.R('pipeline_tasks', {'id': task_id, 'tenant_id': tenant_id})
        if not recs:
            return None
        rec = recs[0]
        return _rec_to_dict(rec)


async def get_task_steps(task_id: str) -> list:
    """Get all step records for a task."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.sqlExe("SELECT * FROM pipeline_task_steps WHERE task_id=${tid}$ ORDER BY step_order", {'tid': task_id})
        result = []
        for rec in (recs or []):
            result.append(_rec_to_dict(rec))
        return result


async def get_step_states(task_id: str) -> Dict[str, str]:
    """Get {step_name: state} for all steps of a task."""
    steps = await get_task_steps(task_id)
    return {s['step_name']: s['state'] for s in steps}


async def update_task_state(task_id: str, state: str):
    """Update task state."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        await sor.U('pipeline_tasks', {"id": task_id, "state": state})


async def update_task_version(task_id: str, version: int):
    """Update task current_version."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        await sor.U('pipeline_tasks', {"id": task_id, "current_version": version})


async def update_step_state(task_id: str, step_name: str, state: str, error_msg: str = None):
    """Update step state."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.R('pipeline_task_steps', {'task_id': task_id, 'step_name': step_name})
        if not recs:
            return
        rec = recs[0]
        rec_id = rec.id if hasattr(rec, 'id') else rec['id']
        data = {"id": rec_id, "state": state}
        if state == "running":
            data["started_at"] = "NOW()"
        elif state in ("completed", "failed"):
            data["completed_at"] = "NOW()"
        if error_msg:
            data["error_msg"] = error_msg
        await sor.U('pipeline_task_steps', data)


async def save_artifact(task_id: str, version: int, step_name: str, io_type: str, data: dict):
    """Save or update an artifact."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        # Check if exists
        existing = await sor.R('pipeline_artifacts', {
            'task_id': task_id, 'version': version,
            'step_name': step_name, 'io_type': io_type
        })
        data_json = json.dumps(data, ensure_ascii=False, default=str)
        if existing:
            rec = existing[0]
            rec_id = rec.id if hasattr(rec, 'id') else rec['id']
            await sor.U('pipeline_artifacts', {"id": rec_id, "data": data_json})
        else:
            await sor.C('pipeline_artifacts', {
                "id": getID(),
                "task_id": task_id,
                "version": version,
                "step_name": step_name,
                "io_type": io_type,
                "data": data_json,
            })


async def get_artifact(task_id: str, version: int, step_name: str, io_type: str) -> Optional[dict]:
    """Get artifact data."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.R('pipeline_artifacts', {
            'task_id': task_id, 'version': version,
            'step_name': step_name, 'io_type': io_type
        })
        if not recs:
            return None
        rec = recs[0]
        raw = rec.data if hasattr(rec, 'data') else rec['data']
        if isinstance(raw, str):
            return json.loads(raw)
        return raw


async def get_all_artifacts(task_id: str, version: int) -> Dict[str, dict]:
    """Get all artifacts for a task version. Returns {step_name_io_type: data}."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.R('pipeline_artifacts', {'task_id': task_id, 'version': version})
        result = {}
        for rec in (recs or []):
            sn = rec.step_name if hasattr(rec, 'step_name') else rec['step_name']
            io = rec.io_type if hasattr(rec, 'io_type') else rec['io_type']
            raw = rec.data if hasattr(rec, 'data') else rec['data']
            key = f"{sn}_{io}"
            result[key] = json.loads(raw) if isinstance(raw, str) else raw
        return result


async def list_tasks(tenant_id: str, pipeline_id: str = None, limit: int = 100) -> list:
    """List tasks for a tenant."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        if pipeline_id:
            sql = "SELECT * FROM pipeline_tasks WHERE tenant_id=${tenant_id}$ AND pipeline_id=${pipeline_id}$ ORDER BY created_at DESC"
            recs = await sor.sqlExe(sql, {'tenant_id': tenant_id, 'pipeline_id': pipeline_id})
        else:
            sql = "SELECT * FROM pipeline_tasks WHERE tenant_id=${tenant_id}$ ORDER BY created_at DESC"
            recs = await sor.sqlExe(sql, {'tenant_id': tenant_id})
        result = []
        for rec in (recs or [])[:limit]:
            result.append(_rec_to_dict(rec))
        return result


async def reset_steps(task_id: str, step_names: list):
    """Reset specified steps to pending state."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        for sn in step_names:
            recs = await sor.R('pipeline_task_steps', {'task_id': task_id, 'step_name': sn})
            if recs:
                rec = recs[0]
                rec_id = rec.id if hasattr(rec, 'id') else rec['id']
                await sor.U('pipeline_task_steps', {
                    "id": rec_id, "state": "pending",
                    "error_msg": None, "started_at": None, "completed_at": None
                })


# ── Human tasks storage ──

async def create_human_task(task_id, step_name, version, task_type, assignee_role=None,
                            assignee_id=None, form_schema=None, timeout_hours=None):
    """Create a pipeline_human_tasks record."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        data = {
            "id": getID(),
            "task_id": task_id,
            "step_name": step_name,
            "version": version,
            "task_type": task_type,
            "assignee_role": assignee_role or "",
            "assignee_id": assignee_id or "",
            "form_schema": json.dumps(form_schema, ensure_ascii=False) if form_schema else None,
            "status": "pending",
        }
        if timeout_hours:
            from datetime import datetime, timedelta
            expired = datetime.now() + timedelta(hours=timeout_hours)
            data["expired_at"] = expired.strftime("%Y-%m-%d %H:%M:%S")
        await sor.C('pipeline_human_tasks', data)
        return data["id"]


async def update_human_task_record(task_id, step_name, status, result_data=None, operator_id=None):
    """Update a human_tasks record."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.R('pipeline_human_tasks', {'task_id': task_id, 'step_name': step_name})
        if not recs:
            return
        rec = recs[0]
        rec_id = rec.id if hasattr(rec, 'id') else rec['id']
        data = {"id": rec_id, "status": status}
        if result_data is not None:
            data["result_data"] = json.dumps(result_data, ensure_ascii=False, default=str)
        if operator_id:
            data["submitted_by"] = operator_id
            data["submitted_at"] = "NOW()"
        await sor.U('pipeline_human_tasks', data)


async def list_human_tasks(tenant_id=None, assignee_role=None, assignee_id=None, status=None):
    """List human tasks with optional filters."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        conditions = []
        params = {}
        if assignee_role:
            conditions.append("assignee_role=${assignee_role}$")
            params["assignee_role"] = assignee_role
        if assignee_id:
            conditions.append("assignee_id=${assignee_id}$")
            params["assignee_id"] = assignee_id
        if status:
            conditions.append("status=${status}$")
            params["status"] = status

        if tenant_id:
            # Join with pipeline_tasks to filter by tenant
            conditions.append("task_id IN (SELECT id FROM pipeline_tasks WHERE tenant_id=${tenant_id}$)")
            params["tenant_id"] = tenant_id

        where = " AND ".join(conditions) if conditions else "1=1"
        sql = f"SELECT * FROM pipeline_human_tasks WHERE {where} ORDER BY created_at DESC"
        recs = await sor.sqlExe(sql, params)
        result = []
        for rec in (recs or []):
            d = _rec_to_dict(rec)
            # Parse JSON fields
            for field in ('form_schema', 'result_data'):
                if d.get(field) and isinstance(d[field], str):
                    try:
                        d[field] = json.loads(d[field])
                    except (json.JSONDecodeError, TypeError):
                        pass
            result.append(d)
        return result


async def get_human_task(task_id, step_name):
    """Get a specific human task record."""
    db, dbname = _get_db()
    async with db.sqlorContext(dbname) as sor:
        recs = await sor.R('pipeline_human_tasks', {'task_id': task_id, 'step_name': step_name})
        if not recs:
            return None
        rec = recs[0]
        d = _rec_to_dict(rec)
        for field in ('form_schema', 'result_data'):
            if d.get(field) and isinstance(d[field], str):
                try:
                    d[field] = json.loads(d[field])
                except (json.JSONDecodeError, TypeError):
                    pass
        return d