scriptgini 1.2.1__tar.gz → 1.3.0__tar.gz

{scriptgini-1.2.1 → scriptgini-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scriptgini
-Version: 1.2.1
+Version: 1.3.0
 Summary: Agentic AI system that converts functional test cases into automation test scripts.
 Author: ScriptGini Team
 License: Proprietary
@@ -16,6 +16,8 @@ Description-Content-Type: text/markdown
 
 > **Enterprise-grade Agentic AI system that converts functional test cases into high-quality, review-ready automation test scripts.**
 
+Current release: v1.3.0 (Sprint 3)
+
 ---
 
 ## What is ScriptGini?
@@ -33,6 +35,7 @@ ScriptGini is an AI-powered test automation engine built for Quality Engineering
 - **Project & AUT management** — Store multiple projects, each with its own base URL and defaults
 - **Full test case history** — Every generated script is stored in SQLite with status and token usage
 - **Execution history persistence** — Every run is stored in `script_runs` with stdout/stderr, exit code, and duration
+- **Durable execution APIs** — Async execution jobs with run/status/abort endpoints and idempotency-key support
 - **Hardened execution sandbox** — Script runs use isolated Python mode, static safety validation, and restricted environment variables
 - **Bulk job orchestration** — Project-level bulk generate and bulk run with pollable job status
 - **Run analytics dashboard** — Project-level pass/fail/timeout metrics and recent failure feed

{scriptgini-1.2.1 → scriptgini-1.3.0}/README.md

@@ -2,6 +2,8 @@
 
 > **Enterprise-grade Agentic AI system that converts functional test cases into high-quality, review-ready automation test scripts.**
 
+Current release: v1.3.0 (Sprint 3)
+
 ---
 
 ## What is ScriptGini?
@@ -19,6 +21,7 @@ ScriptGini is an AI-powered test automation engine built for Quality Engineering
 - **Project & AUT management** — Store multiple projects, each with its own base URL and defaults
 - **Full test case history** — Every generated script is stored in SQLite with status and token usage
 - **Execution history persistence** — Every run is stored in `script_runs` with stdout/stderr, exit code, and duration
+- **Durable execution APIs** — Async execution jobs with run/status/abort endpoints and idempotency-key support
 - **Hardened execution sandbox** — Script runs use isolated Python mode, static safety validation, and restricted environment variables
 - **Bulk job orchestration** — Project-level bulk generate and bulk run with pollable job status
 - **Run analytics dashboard** — Project-level pass/fail/timeout metrics and recent failure feed

scriptgini-1.3.0/app/__init__.py

@@ -0,0 +1,3 @@
+__version__ = "1.3.0"
+__api_version__ = "v1.3.0"
+

{scriptgini-1.2.1 → scriptgini-1.3.0}/app/main.py

@@ -10,7 +10,7 @@ from fastapi.staticfiles import StaticFiles
 from app import __version__
 from app.config import settings
 from app.llm.provider import get_llm_diagnostics
-from app.routers import projects, test_cases, scripts, bulk_jobs, analytics, demo, auth, api_key, organizations
+from app.routers import projects, test_cases, scripts, bulk_jobs, analytics, demo, auth, api_key, organizations, execution
 
 logging.basicConfig(level=logging.DEBUG if settings.DEBUG else logging.INFO)
 logger = logging.getLogger(__name__)
@@ -58,6 +58,7 @@ app.include_router(demo.router, prefix="/api/v1")
 app.include_router(auth.router, prefix="/api/v1")
 app.include_router(api_key.router, prefix="/api/v1")
 app.include_router(organizations.router, prefix="/api/v1")
+app.include_router(execution.router, prefix="/api/v1")
 app.mount("/static", StaticFiles(directory=static_dir), name="static")
 
 

scriptgini-1.3.0/app/models/execution_job.py

@@ -0,0 +1,68 @@
+import enum
+from datetime import datetime, timezone
+
+from sqlalchemy import DateTime, Enum as SAEnum, ForeignKey, Integer, JSON, String, Text
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.database import Base
+
+
+class ExecutionJobStatus(str, enum.Enum):
+    pending = "pending"
+    running = "running"
+    completed = "completed"
+    failed = "failed"
+    cancelled = "cancelled"
+
+
+_ALLOWED_TRANSITIONS: dict[ExecutionJobStatus, set[ExecutionJobStatus]] = {
+    ExecutionJobStatus.pending: {
+        ExecutionJobStatus.running,
+        ExecutionJobStatus.completed,
+        ExecutionJobStatus.failed,
+        ExecutionJobStatus.cancelled,
+    },
+    ExecutionJobStatus.running: {
+        ExecutionJobStatus.completed,
+        ExecutionJobStatus.failed,
+        ExecutionJobStatus.cancelled,
+    },
+    ExecutionJobStatus.completed: set(),
+    ExecutionJobStatus.failed: set(),
+    ExecutionJobStatus.cancelled: set(),
+}
+
+
+class ExecutionJob(Base):
+    __tablename__ = "execution_jobs"
+
+    id: Mapped[int] = mapped_column(primary_key=True, index=True)
+    project_id: Mapped[int] = mapped_column(ForeignKey("projects.id", ondelete="CASCADE"), nullable=False, index=True)
+    script_id: Mapped[int] = mapped_column(ForeignKey("generated_scripts.id", ondelete="CASCADE"), nullable=False, index=True)
+    test_case_id: Mapped[int] = mapped_column(ForeignKey("test_cases.id", ondelete="CASCADE"), nullable=False, index=True)
+    created_by_user_id: Mapped[int] = mapped_column(ForeignKey("users.id", ondelete="CASCADE"), nullable=False, index=True)
+    status: Mapped[ExecutionJobStatus] = mapped_column(
+        SAEnum(ExecutionJobStatus), nullable=False, default=ExecutionJobStatus.pending
+    )
+    idempotency_key: Mapped[str | None] = mapped_column(String(255), nullable=True, unique=True, index=True)
+    celery_task_id: Mapped[str | None] = mapped_column(String(255), nullable=True, index=True)
+    request_payload: Mapped[dict] = mapped_column(JSON, nullable=False, default=dict)
+    result_payload: Mapped[dict | None] = mapped_column(JSON, nullable=True)
+    error_message: Mapped[str | None] = mapped_column(Text, nullable=True)
+    started_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+    completed_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+    cancelled_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), default=lambda: datetime.now(timezone.utc)
+    )
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        default=lambda: datetime.now(timezone.utc),
+        onupdate=lambda: datetime.now(timezone.utc),
+    )
+
+
+def can_transition(current: ExecutionJobStatus, new_status: ExecutionJobStatus) -> bool:
+    if current == new_status:
+        return True
+    return new_status in _ALLOWED_TRANSITIONS[current]

scriptgini-1.3.0/app/routers/execution.py

@@ -0,0 +1,165 @@
+from datetime import datetime, timezone
+
+from fastapi import APIRouter, Depends, Header, HTTPException, status
+from sqlalchemy.orm import Session
+
+from app.celery_app import celery_app
+from app.database import get_db
+from app.models.execution_job import ExecutionJob, ExecutionJobStatus, can_transition
+from app.models.generated_script import GeneratedScript, ScriptStatus
+from app.schemas.execution import ExecutionJobResponse, ExecutionRunRequest
+from app.services import rbac as rbac_service
+from app.services.auth_dependencies import require_auth_with_scopes
+from app.tasks import execute_script
+
+router = APIRouter(prefix="/execution", tags=["Execution"])
+
+
+def _get_job_or_404(job_id: int, db: Session) -> ExecutionJob:
+    job = db.query(ExecutionJob).filter(ExecutionJob.id == job_id).first()
+    if not job:
+        raise HTTPException(status_code=404, detail="Execution job not found")
+    return job
+
+
+def _ensure_project_access(db: Session, project_id: int, user_id: int, require_manager: bool = False) -> None:
+    rbac_service.ensure_project_exists(db, project_id)
+    existing_members = rbac_service.list_project_members(db, project_id)
+    if not existing_members:
+        return
+
+    membership = rbac_service.get_user_project_membership(db, project_id, user_id)
+    if membership is None or membership.role not in rbac_service.READ_ROLES:
+        raise HTTPException(status_code=403, detail="Insufficient project role")
+
+    if require_manager and membership.role not in rbac_service.MANAGER_ROLES:
+        raise HTTPException(status_code=403, detail="Insufficient project role")
+
+
+def _apply_status_from_celery(job: ExecutionJob, db: Session) -> None:
+    if not job.celery_task_id or job.status not in {ExecutionJobStatus.pending, ExecutionJobStatus.running}:
+        return
+
+    task_result = celery_app.AsyncResult(job.celery_task_id)
+    state = task_result.state
+
+    if state == "PENDING":
+        return
+
+    if state == "STARTED" and can_transition(job.status, ExecutionJobStatus.running):
+        job.status = ExecutionJobStatus.running
+        if job.started_at is None:
+            job.started_at = datetime.now(timezone.utc)
+        db.commit()
+        db.refresh(job)
+        return
+
+    if state == "SUCCESS" and can_transition(job.status, ExecutionJobStatus.completed):
+        job.status = ExecutionJobStatus.completed
+        job.completed_at = datetime.now(timezone.utc)
+        if job.started_at is None:
+            job.started_at = job.completed_at
+        result = task_result.result
+        job.result_payload = result if isinstance(result, dict) else {"result": str(result)}
+        db.commit()
+        db.refresh(job)
+        return
+
+    if state == "REVOKED" and can_transition(job.status, ExecutionJobStatus.cancelled):
+        job.status = ExecutionJobStatus.cancelled
+        job.cancelled_at = datetime.now(timezone.utc)
+        db.commit()
+        db.refresh(job)
+        return
+
+    if state == "FAILURE" and can_transition(job.status, ExecutionJobStatus.failed):
+        job.status = ExecutionJobStatus.failed
+        job.completed_at = datetime.now(timezone.utc)
+        job.error_message = str(task_result.result)
+        db.commit()
+        db.refresh(job)
+
+
+def _enqueue_execution_task(script_id: int, execution_env: dict[str, str], job_id: int) -> str:
+    async_result = execute_script.delay(script_id, execution_env, job_id)
+    return async_result.id
+
+
+@router.post("/run", response_model=ExecutionJobResponse, status_code=status.HTTP_202_ACCEPTED)
+def run_execution_job(
+    payload: ExecutionRunRequest,
+    idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"),
+    current_user=Depends(require_auth_with_scopes({"execution:write"})),
+    db: Session = Depends(get_db),
+):
+    script = db.query(GeneratedScript).filter(GeneratedScript.id == payload.script_id).first()
+    if not script:
+        raise HTTPException(status_code=404, detail="Script not found")
+    if script.status != ScriptStatus.completed or not script.script_content:
+        raise HTTPException(status_code=400, detail="Script is not ready to run")
+
+    _ensure_project_access(db, script.project_id, current_user.id)
+
+    if idempotency_key:
+        existing_job = (
+            db.query(ExecutionJob)
+            .filter(ExecutionJob.idempotency_key == idempotency_key, ExecutionJob.created_by_user_id == current_user.id)
+            .first()
+        )
+        if existing_job:
+            _ensure_project_access(db, existing_job.project_id, current_user.id)
+            return existing_job
+
+    job = ExecutionJob(
+        project_id=script.project_id,
+        script_id=script.id,
+        test_case_id=script.test_case_id,
+        created_by_user_id=current_user.id,
+        status=ExecutionJobStatus.pending,
+        idempotency_key=idempotency_key,
+        request_payload=payload.model_dump(),
+    )
+    db.add(job)
+    db.commit()
+    db.refresh(job)
+
+    job.celery_task_id = _enqueue_execution_task(script.id, payload.execution_env, job.id)
+    db.commit()
+    db.refresh(job)
+    return job
+
+
+@router.get("/status/{job_id}", response_model=ExecutionJobResponse)
+def get_execution_job_status(
+    job_id: int,
+    current_user=Depends(require_auth_with_scopes({"execution:read"})),
+    db: Session = Depends(get_db),
+):
+    job = _get_job_or_404(job_id, db)
+    _ensure_project_access(db, job.project_id, current_user.id)
+    _apply_status_from_celery(job, db)
+    return job
+
+
+@router.post("/abort/{job_id}", response_model=ExecutionJobResponse)
+def abort_execution_job(
+    job_id: int,
+    current_user=Depends(require_auth_with_scopes({"execution:write"})),
+    db: Session = Depends(get_db),
+):
+    job = _get_job_or_404(job_id, db)
+    _ensure_project_access(db, job.project_id, current_user.id, require_manager=True)
+
+    if job.status in {ExecutionJobStatus.completed, ExecutionJobStatus.failed, ExecutionJobStatus.cancelled}:
+        return job
+
+    if job.celery_task_id:
+        celery_app.control.revoke(job.celery_task_id, terminate=True)
+
+    if can_transition(job.status, ExecutionJobStatus.cancelled):
+        job.status = ExecutionJobStatus.cancelled
+        job.cancelled_at = datetime.now(timezone.utc)
+        db.commit()
+        db.refresh(job)
+
+    return job

scriptgini-1.3.0/app/schemas/execution.py

@@ -0,0 +1,31 @@
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+from app.models.execution_job import ExecutionJobStatus
+
+
+class ExecutionRunRequest(BaseModel):
+    script_id: int = Field(..., gt=0)
+    execution_env: dict[str, str] = Field(default_factory=dict)
+
+
+class ExecutionJobResponse(BaseModel):
+    id: int
+    project_id: int
+    script_id: int
+    test_case_id: int
+    created_by_user_id: int
+    status: ExecutionJobStatus
+    idempotency_key: str | None
+    celery_task_id: str | None
+    request_payload: dict
+    result_payload: dict | None
+    error_message: str | None
+    started_at: datetime | None
+    completed_at: datetime | None
+    cancelled_at: datetime | None
+    created_at: datetime
+    updated_at: datetime
+
+    model_config = {"from_attributes": True}

{scriptgini-1.2.1 → scriptgini-1.3.0}/app/tasks.py

@@ -5,11 +5,13 @@ These tasks are executed by Celery workers and should not block the API.
 Examples: Script generation, test execution, file processing, etc.
 """
 
+from datetime import datetime, timezone
+import logging
+
 from celery import shared_task
-from sqlalchemy.orm import Session
-from app.database import SessionLocal
 from app.config import settings
-import logging
+from app.database import SessionLocal
+from app.models.execution_job import ExecutionJob, ExecutionJobStatus, can_transition
 
 logger = logging.getLogger(__name__)
 
@@ -46,8 +48,40 @@ def generate_test_script(self, test_case_id: int, project_id: int):
         db.close()
 
 
+def _sync_execution_job_state(
+    db,
+    execution_job_id: int | None,
+    status: ExecutionJobStatus,
+    *,
+    result_payload: dict | None = None,
+    error_message: str | None = None,
+):
+    if execution_job_id is None:
+        return
+
+    job = db.query(ExecutionJob).filter(ExecutionJob.id == execution_job_id).first()
+    if not job or not can_transition(job.status, status):
+        return
+
+    now = datetime.now(timezone.utc)
+    job.status = status
+    if status == ExecutionJobStatus.running and job.started_at is None:
+        job.started_at = now
+    if status in {ExecutionJobStatus.completed, ExecutionJobStatus.failed}:
+        if job.started_at is None:
+            job.started_at = now
+        job.completed_at = now
+    if status == ExecutionJobStatus.cancelled:
+        job.cancelled_at = now
+    if result_payload is not None:
+        job.result_payload = result_payload
+    if error_message is not None:
+        job.error_message = error_message
+    db.commit()
+
+
 @shared_task(bind=True, max_retries=settings.CELERY_MAX_RETRIES)
-def execute_script(self, script_id: int, execution_env: dict = None):
+def execute_script(self, script_id: int, execution_env: dict | None = None, execution_job_id: int | None = None):
     """
     Async task to execute a test script (Playwright/Selenium).
     
@@ -62,6 +96,7 @@ def execute_script(self, script_id: int, execution_env: dict = None):
     try:
         execution_env = execution_env or {}
         logger.info(f"Executing script {script_id} with env: {execution_env}")
+        _sync_execution_job_state(db, execution_job_id, ExecutionJobStatus.running)
         
         # TODO: Implement actual script execution logic
         # This would:
@@ -71,14 +106,27 @@ def execute_script(self, script_id: int, execution_env: dict = None):
         # 4. Capture results and logs
         # 5. Store execution record in database
         
-        return {
+        result = {
             "status": "success",
             "script_id": script_id,
             "execution_id": None,  # Will be populated after execution
             "duration_seconds": 0,
         }
+        _sync_execution_job_state(
+            db,
+            execution_job_id,
+            ExecutionJobStatus.completed,
+            result_payload=result,
+        )
+        return result
     except Exception as exc:
         logger.error(f"Error executing script: {exc}")
+        _sync_execution_job_state(
+            db,
+            execution_job_id,
+            ExecutionJobStatus.failed,
+            error_message=str(exc),
+        )
         raise self.retry(exc=exc, countdown=5 ** self.request.retries)
     finally:
         db.close()

{scriptgini-1.2.1 → scriptgini-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "scriptgini"
-version = "1.2.1"
+version = "1.3.0"
 description = "Agentic AI system that converts functional test cases into automation test scripts."
 readme = "README.md"
 requires-python = ">=3.11"

{scriptgini-1.2.1 → scriptgini-1.3.0}/scriptgini.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scriptgini
-Version: 1.2.1
+Version: 1.3.0
 Summary: Agentic AI system that converts functional test cases into automation test scripts.
 Author: ScriptGini Team
 License: Proprietary
@@ -16,6 +16,8 @@ Description-Content-Type: text/markdown
 
 > **Enterprise-grade Agentic AI system that converts functional test cases into high-quality, review-ready automation test scripts.**
 
+Current release: v1.3.0 (Sprint 3)
+
 ---
 
 ## What is ScriptGini?
@@ -33,6 +35,7 @@ ScriptGini is an AI-powered test automation engine built for Quality Engineering
 - **Project & AUT management** — Store multiple projects, each with its own base URL and defaults
 - **Full test case history** — Every generated script is stored in SQLite with status and token usage
 - **Execution history persistence** — Every run is stored in `script_runs` with stdout/stderr, exit code, and duration
+- **Durable execution APIs** — Async execution jobs with run/status/abort endpoints and idempotency-key support
 - **Hardened execution sandbox** — Script runs use isolated Python mode, static safety validation, and restricted environment variables
 - **Bulk job orchestration** — Project-level bulk generate and bulk run with pollable job status
 - **Run analytics dashboard** — Project-level pass/fail/timeout metrics and recent failure feed

{scriptgini-1.2.1 → scriptgini-1.3.0}/scriptgini.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ app/llm/provider.py
 app/models/__init__.py
 app/models/api_key.py
 app/models/bulk_job.py
+app/models/execution_job.py
 app/models/generated_script.py
 app/models/membership.py
 app/models/organization.py
@@ -28,6 +29,7 @@ app/routers/api_key.py
 app/routers/auth.py
 app/routers/bulk_jobs.py
 app/routers/demo.py
+app/routers/execution.py
 app/routers/organizations.py
 app/routers/projects.py
 app/routers/scripts.py
@@ -37,6 +39,7 @@ app/schemas/analytics.py
 app/schemas/api_key.py
 app/schemas/auth.py
 app/schemas/bulk_job.py
+app/schemas/execution.py
 app/schemas/generated_script.py
 app/schemas/membership.py
 app/schemas/organization.py
@@ -55,4 +58,5 @@ tests/test_api.py
 tests/test_auth.py
 tests/test_coverage.py
 tests/test_infra_services_coverage.py
-tests/test_sprint2_rbac.py
+tests/test_sprint2_rbac.py
+tests/test_sprint3_execution.py