Skip to content

Hello-QM/catgo-LRG / server/catgo/workflow

catgo-workflow

Verified

Create and manage computational chemistry workflows with CatGo. Supports VASP, CP2K, ORCA, MLP, LAMMPS. Build OER/HER/CO2RR workflows, geometry optimization, frequency analysis, Gibbs energy calculations.

FileKindSize
SKILL.mdskill md3.8 KB
__init__.pyscript1.1 KB
builtins.pyscript4.7 KB
builtins_impl.pyscript21.2 KB
config.pyscript6.5 KB
db.pyscript25.3 KB
engine/__init__.pyscript615 B
engine/advancer.pyscript9.3 KB
engine/ai_diagnosis.pyscript3.8 KB
engine/batch_submitter.pyscript9.7 KB
engine/broadcast.pyscript1.8 KB
engine/collector.pyscript8.3 KB
engine/control_flow.pyscript5.7 KB
engine/engine_builtins.pyscript19.6 KB
engine/engine_registry.pyscript1.5 KB
engine/error_handler.pyscript3.6 KB
engine/hpc_utils.pyscript4.0 KB
engine/job_script.pyscript11.6 KB
engine/lifecycle.pyscript10.8 KB
engine/orca_progress.pyscript3.4 KB
engine/poller.pyscript11.7 KB
engine/resolver.pyscript2.7 KB
engine/result_collector.pyscript56.3 KB
engine/result_handler.pyscript5.6 KB
engine/scanner.pyscript52.0 KB
engine/smart_recovery.pyscript3.6 KB
engine/submitter.pyscript26.2 KB
engine/v1_monitor.pyscript2.7 KB
engine/vasp_submission.pyscript29.0 KB
graph_converter.pyscript6.5 KB
mcp_tools.pyscript7.5 KB
provenance.pyscript5.8 KB
reference.pyscript1.1 KB
service.pyscript4.0 KB
state_map.pyscript1.5 KB
states.pyscript7.5 KB
task_decorator.pyscript2.5 KB
task_ids.pyscript986 B
v1_compat.pyscript2.8 KB
workflow.pyscript12.0 KB

engine/control_flow.py

View on GitHub
"""Control-flow task handlers: Zone, While, Map.

Extracted from scanner.py to keep each file focused and under 150 lines.
"""

from __future__ import annotations

import asyncio
import json
import logging

from catgo.workflow.db import WorkflowDB
from catgo.workflow.states import TaskState
from catgo.workflow.engine.broadcast import broadcast as _broadcast

logger = logging.getLogger(__name__)


def handle_while_task(db: WorkflowDB, task: dict, workflow_id: str) -> bool:
    """Handle a __while__ loop task. Returns True if handled."""
    task_id = task["id"]
    children = db.get_children_of(task_id)

    if not children:
        # Empty loop -- mark completed immediately
        db.update_task(task_id, status=TaskState.COMPLETED.value)
        asyncio.get_event_loop().create_task(
            _broadcast(workflow_id, {"type": "task_status", "task_id": task_id, "status": "COMPLETED"})
        )
        db.store_result(task_id, workflow_id, outputs_json=json.dumps({"iterations": 0, "converged": True}))
        logger.info("Task %s (__while__): completed (no children)", task_id)
        return True

    params = json.loads(task.get("params_json", "{}") or "{}")
    max_iter = params.get("max_iterations", 10)
    condition_key = params.get("condition_key", "converged")
    condition_value = params.get("condition_value", True)
    iteration = task.get("retry_count", 0) or 0

    child_statuses = [c["status"] for c in children]

    # If children still running, wait
    if not all(
        s in (TaskState.COMPLETED.value, TaskState.FAILED.value, TaskState.SKIPPED.value)
        for s in child_statuses
    ):
        db.update_task(task_id, status=TaskState.WAITING.value)
        return True

    # If any child failed, loop fails
    if any(s == TaskState.FAILED.value for s in child_statuses):
        db.update_task(task_id, status=TaskState.FAILED.value)
        asyncio.get_event_loop().create_task(
            _broadcast(workflow_id, {"type": "task_status", "task_id": task_id, "status": "FAILED"})
        )
        logger.info("Task %s (__while__): failed (child failed)", task_id)
        return True

    # Check convergence condition from last child's result
    last_child = children[-1]
    result = db.get_result(last_child["id"])
    converged = False
    if result:
        outputs = {}
        if result.get("outputs_json"):
            try:
                outputs = json.loads(result["outputs_json"]) if isinstance(result["outputs_json"], str) else result["outputs_json"]
            except (json.JSONDecodeError, TypeError):
                pass
        if condition_key in outputs:
            actual = outputs[condition_key]
        else:
            actual = result.get(condition_key)
        converged = (actual == condition_value)

    if converged:
        db.update_task(task_id, status=TaskState.COMPLETED.value)
        db.store_result(
            task_id, workflow_id,
            outputs_json=json.dumps({"iterations": iteration + 1, "converged": True}),
        )
        asyncio.get_event_loop().create_task(
            _broadcast(workflow_id, {"type": "task_status", "task_id": task_id, "status": "COMPLETED"})
        )
        logger.info("Task %s (__while__): converged after %d iteration(s)", task_id, iteration + 1)
        return True

    # Check max iterations
    if iteration + 1 >= max_iter:
        db.update_task(task_id, status=TaskState.COMPLETED.value)
        db.store_result(
            task_id, workflow_id,
            outputs_json=json.dumps({"iterations": iteration + 1, "converged": False}),
        )
        asyncio.get_event_loop().create_task(
            _broadcast(workflow_id, {"type": "task_status", "task_id": task_id, "status": "COMPLETED"})
        )
        logger.info("Task %s (__while__): max iterations (%d) reached", task_id, max_iter)
        return True

    # Not converged: reset children for next iteration
    for child in children:
        db.update_task(child["id"], status=TaskState.WAITING.value, error_message=None)
    db.update_task(task_id, status=TaskState.WAITING.value, retry_count=iteration + 1)
    logger.info("Task %s (__while__): iteration %d/%d, resetting children", task_id, iteration + 1, max_iter)
    return True


def handle_zone_task(db: WorkflowDB, task: dict, workflow_id: str) -> bool:
    """Handle a __zone__ group task. Returns True if handled."""
    task_id = task["id"]
    children = db.get_children_of(task_id)

    if not children:
        # Empty zone -- mark completed immediately
        db.update_task(task_id, status=TaskState.COMPLETED.value)
        asyncio.get_event_loop().create_task(
            _broadcast(workflow_id, {"type": "task_status", "task_id": task_id, "status": "COMPLETED"})
        )
        logger.info("Task %s (__zone__): completed (no children)", task_id)
        return True

    child_statuses = [c["status"] for c in children]
    if all(s == TaskState.COMPLETED.value for s in child_statuses):
        db.update_task(task_id, status=TaskState.COMPLETED.value)
        asyncio.get_event_loop().create_task(
            _broadcast(workflow_id, {"type": "task_status", "task_id": task_id, "status": "COMPLETED"})
        )
        logger.info("Task %s (__zone__): completed (all children done)", task_id)
    elif any(s == TaskState.FAILED.value for s in child_statuses):
        db.update_task(task_id, status=TaskState.FAILED.value)
        asyncio.get_event_loop().create_task(
            _broadcast(workflow_id, {"type": "task_status", "task_id": task_id, "status": "FAILED"})
        )
        logger.info("Task %s (__zone__): failed (child failed)", task_id)
    else:
        # Children still running -- keep zone WAITING so it gets
        # re-evaluated in the next cycle.
        db.update_task(task_id, status=TaskState.WAITING.value)

    return True
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall