Skip to content

"Vibe-Trading: Your Personal Trading Agent"

2.8 KB
Raw Blame
"""Run state persistence: creates run directories and records status."""

from __future__ import annotations

import json
import os
import uuid
from datetime import datetime
from pathlib import Path
from typing import Any, Dict


class RunStateStore:
    """Run state store: manages run directories and their lifecycle status."""

    def create_run_dir(self, workspace: Path) -> Path:
        """Create a unique run directory.

        Args:
            workspace: Parent directory (typically runs/).

        Returns:
            Newly created run directory path.
        """
        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S_%f")[:18]
        suffix = uuid.uuid4().hex[:6]
        run_dir = workspace / f"{timestamp}_{suffix}"
        run_dir.mkdir(parents=True, exist_ok=True)
        (run_dir / "code").mkdir(exist_ok=True)
        (run_dir / "logs").mkdir(exist_ok=True)
        (run_dir / "artifacts").mkdir(exist_ok=True)
        return run_dir

    def save_request(self, run_dir: Path, prompt: str, context: Dict[str, Any]) -> Dict[str, Any]:
        """Save the user request.

        Args:
            run_dir: Run directory.
            prompt: User prompt.
            context: Context metadata.

        Returns:
            Saved payload.
        """
        payload = {"prompt": prompt, "context": context}
        self._write_json(run_dir / "req.json", payload)
        return payload

    def mark_success(self, run_dir: Path) -> None:
        """Mark the run as successful.

        Args:
            run_dir: Run directory.
        """
        self._write_json(run_dir / "state.json", {"status": "success"})

    def mark_failure(self, run_dir: Path, reason: str) -> None:
        """Mark the run as failed.

        Args:
            run_dir: Run directory.
            reason: Failure reason.
        """
        self._write_json(run_dir / "state.json", {"status": "failed", "reason": reason})

    def mark_cancelled(self, run_dir: Path, reason: str = "cancelled by user") -> None:
        """Mark the run as cancelled by the user.

        Distinct from a failure so the run artifact agrees with the session
        transcript: a user stop is not an outage, and reporting it as one made
        the Reports view contradict the chat history.

        Args:
            run_dir: Run directory.
            reason: Cancellation reason.
        """
        self._write_json(run_dir / "state.json", {"status": "cancelled", "reason": reason})

    @staticmethod
    def _write_json(path: Path, data: Any) -> None:
        # Write + fsync so a crash can't leave a truncated/empty state.json.
        payload = json.dumps(data, ensure_ascii=False, indent=2).encode("utf-8")
        with open(path, "wb") as f:
            f.write(payload)
            f.flush()
            os.fsync(f.fileno())