raztodo-web 0.1.0__py3-none-any.whl

raztodo_web/__main__.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+import os
+
+
+def web_host() -> str:
+    return os.getenv("RAZTODO_WEB_HOST", "127.0.0.1")
+
+
+def web_port() -> int:
+    return int(os.getenv("RAZTODO_WEB_PORT", "8000"))
+
+
+def main() -> None:
+    import importlib.util
+
+    if (
+        importlib.util.find_spec("fastapi") is None
+        or importlib.util.find_spec("uvicorn") is None
+    ):
+        raise SystemExit(
+            "Web dependencies are not installed. Install with: pip install 'raztodo[web]'"
+        )
+
+    import uvicorn  # type: ignore[import]
+
+    uvicorn.run(
+        "raztodo_web.app.factory:app",
+        host=web_host(),
+        port=web_port(),
+        reload=False,
+    )
+
+
+if __name__ == "__main__":
+    main()

raztodo_web/app/dependencies.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from fastapi import Depends
+from raztodo.application.factory import DefaultUseCaseFactory
+from raztodo.infrastructure.container import build_container
+from raztodo.infrastructure.sqlite.task_repository import SQLiteTaskRepository
+
+_container = build_container()
+
+
+def get_storage() -> SQLiteTaskRepository:
+    return _container.repo_singleton()
+
+
+def get_factory() -> DefaultUseCaseFactory:
+    return DefaultUseCaseFactory()
+
+
+StorageDep = Annotated[SQLiteTaskRepository, Depends(get_storage)]
+FactoryDep = Annotated[DefaultUseCaseFactory, Depends(get_factory)]
+
+
+def get_use_case(factory_method: str):
+    def _dependency(storage: StorageDep, factory: FactoryDep) -> Any:
+        return getattr(factory, factory_method)(storage)
+
+    return _dependency
+
+
+get_list_uc = get_use_case("create_list_tasks")
+get_create_uc = get_use_case("create_create_task")
+get_update_uc = get_use_case("create_update_task")
+get_delete_uc = get_use_case("create_delete_task")
+get_clear_uc = get_use_case("create_clear_tasks")
+get_mark_done_uc = get_use_case("create_mark_done")
+get_export_uc = get_use_case("create_export_tasks")
+get_import_uc = get_use_case("create_import_tasks")
+get_explain_uc = get_use_case("create_explain_task")

raztodo_web/app/factory.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from fastapi import FastAPI, Request
+from fastapi.staticfiles import StaticFiles
+from fastapi.templating import Jinja2Templates
+from raztodo.infrastructure.version import get_version
+
+from raztodo_web.features.explain.routes import router as explain_router
+from raztodo_web.features.tasks.routes import router as tasks_router
+
+_WEB_DIR = Path(__file__).resolve().parent.parent / "web"
+_STATIC_DIR = _WEB_DIR / "static"
+_TEMPLATES_DIR = _WEB_DIR / "templates"
+
+
+app = FastAPI(
+    title="RazTodo",
+    description="Local web interface for RazTodo",
+    version=get_version(),
+)
+
+app.mount(
+    "/static",
+    StaticFiles(directory=_STATIC_DIR),
+    name="static",
+)
+
+templates = Jinja2Templates(directory=_TEMPLATES_DIR)
+
+app.include_router(tasks_router)
+app.include_router(explain_router)
+
+
+@app.get("/", include_in_schema=False)
+async def index(request: Request):
+    """Serve the single-page UI, rendered from templates/index.html."""
+    return templates.TemplateResponse(request, "index.html")

raztodo_web/features/explain/routes.py

@@ -0,0 +1,42 @@
+from typing import Any
+
+from fastapi import APIRouter, Depends, HTTPException
+from fastapi.responses import StreamingResponse
+from raztodo.domain.exceptions import RazTodoException
+
+from raztodo_web.app.dependencies import get_explain_uc
+
+router = APIRouter(prefix="/api/tasks", tags=["tasks"])
+
+
+@router.get("/{task_id}/explain")
+def explain_task(
+    task_id: int,
+    mode: str = "short",
+    uc: Any = Depends(get_explain_uc),  # noqa: B008
+) -> StreamingResponse:
+    """
+    Stream the LLM explanation as Server-Sent Events (SSE).
+    Each event: data: <token>\n\n
+    Final event: data: [DONE]\n\n
+    """
+    if mode not in ("short", "deep", "plan"):
+        raise HTTPException(
+            status_code=422, detail="mode must be: short, deep, or plan"
+        )
+
+    def _sse_generator():
+        try:
+            for token in uc.stream(task_id, mode=mode):
+                safe = token.replace("\n", "\\n")
+                yield f"data: {safe}\n\n"
+        except RazTodoException as _exc:
+            yield "event: error\ndata: An internal error occurred.\n\n"
+        finally:
+            yield "data: [DONE]\n\n"
+
+    return StreamingResponse(
+        _sse_generator(),
+        media_type="text/event-stream",
+        headers={"Cache-Control": "no-cache", "X-Accel-Buffering": "no"},
+    )

raztodo_web/features/tasks/helpers.py

@@ -0,0 +1,23 @@
+import os
+from typing import Any
+
+from raztodo_web.features.tasks.schemas import TaskResponse
+
+
+def remove_file(path: str) -> None:
+    if os.path.exists(path):
+        os.unlink(path)
+
+
+def task_to_response(task: Any) -> TaskResponse:
+    return TaskResponse(
+        id=task.id,
+        title=task.title,
+        description=getattr(task, "description", "") or "",
+        done=getattr(task, "done", False),
+        created_at=getattr(task, "created_at", "") or "",
+        priority=getattr(task, "priority", "") or "",
+        due_date=getattr(task, "due_date", None),
+        tags=list(getattr(task, "tags", None) or []),
+        project=getattr(task, "project", None),
+    )

raztodo_web/features/tasks/routes.py

@@ -0,0 +1,202 @@
+from __future__ import annotations
+
+import json
+import os
+import tempfile
+from typing import Any
+
+from fastapi import APIRouter, BackgroundTasks, Depends, HTTPException
+from fastapi.responses import FileResponse
+from raztodo.domain.exceptions import RazTodoException
+
+from raztodo_web.app.dependencies import (
+    get_clear_uc,
+    get_create_uc,
+    get_delete_uc,
+    get_export_uc,
+    get_import_uc,
+    get_list_uc,
+    get_mark_done_uc,
+    get_update_uc,
+)
+from raztodo_web.features.tasks.helpers import task_to_response
+from raztodo_web.features.tasks.schemas import (
+    ClearResponse,
+    ImportResponse,
+    TaskCreate,
+    TaskResponse,
+    TaskUpdate,
+)
+
+router = APIRouter(prefix="/api/tasks", tags=["tasks"])
+
+
+def _domain_error(e: Exception) -> HTTPException:
+    return HTTPException(status_code=400, detail=str(e))
+
+
+def _remove_file(path: str) -> None:
+    if os.path.exists(path):
+        os.unlink(path)
+
+
+@router.get("", response_model=list[TaskResponse])
+def list_tasks(
+    q: str | None = None,
+    uc: Any = Depends(get_list_uc),  # noqa: B008
+) -> list[TaskResponse]:
+    try:
+        tasks = uc.execute()
+        if q:
+            q_lower = q.lower()
+            tasks = [
+                t
+                for t in tasks
+                if q_lower in t.title.lower()
+                or q_lower in (getattr(t, "description", "") or "").lower()
+            ]
+        return [task_to_response(t) for t in tasks]
+    except RazTodoException as e:
+        raise _domain_error(e) from e
+
+
+@router.post("", response_model=TaskResponse, status_code=201)
+def create_task(
+    body: TaskCreate,
+    list_uc: Any = Depends(get_list_uc),  # noqa: B008
+    create_uc: Any = Depends(get_create_uc),  # noqa: B008
+) -> TaskResponse:
+    try:
+        task_id: int = create_uc.execute(
+            title=body.title,
+            description=body.description,
+            priority=body.priority or "",
+            due_date=body.due_date,
+            tags=body.tags or [],
+            project=body.project,
+        )
+        tasks = list_uc.execute()
+        task = next((t for t in tasks if t.id == task_id), None)
+        if task is None:
+            raise HTTPException(
+                status_code=500, detail="Task created but could not be retrieved"
+            )
+        return task_to_response(task)
+    except RazTodoException as e:
+        raise _domain_error(e) from e
+
+
+@router.get("/export")
+def export_tasks(
+    background_tasks: BackgroundTasks,
+    uc: Any = Depends(get_export_uc),  # noqa: B008
+) -> FileResponse:
+    try:
+        fd, path = tempfile.mkstemp(suffix=".json")
+        os.close(fd)
+
+        uc.execute(path)
+        background_tasks.add_task(_remove_file, path)
+
+        return FileResponse(
+            path=path,
+            media_type="application/json",
+            filename="raztodo_export.json",
+        )
+    except RazTodoException as e:
+        raise _domain_error(e) from e
+
+
+@router.post("/import", response_model=ImportResponse)
+def import_tasks(
+    tasks: list[TaskCreate],
+    uc: Any = Depends(get_import_uc),  # noqa: B008
+) -> ImportResponse:
+    tmp = tempfile.NamedTemporaryFile(  # noqa: SIM115
+        suffix=".json", delete=False, mode="w", encoding="utf-8"
+    )
+    try:
+        json.dump([t.model_dump() for t in tasks], tmp, ensure_ascii=False)
+        tmp.close()
+        result = uc.execute(tmp.name, upsert=True)
+        if isinstance(result, dict):
+            return ImportResponse(
+                inserted=result.get("inserted", 0),
+                updated=result.get("updated", 0),
+            )
+        return ImportResponse(inserted=int(result), updated=0)
+    except RazTodoException as e:
+        raise _domain_error(e) from e
+    except Exception as e:
+        raise HTTPException(status_code=422, detail=f"Import failed: {e}") from e
+    finally:
+        tmp.close()
+        if os.path.exists(tmp.name):
+            os.unlink(tmp.name)
+
+
+@router.post("/clear", response_model=ClearResponse)
+def clear_tasks(uc: Any = Depends(get_clear_uc)) -> ClearResponse:  # noqa: B008
+    try:
+        deleted: int = uc.execute(confirmed=True)
+        return ClearResponse(deleted=deleted)
+    except RazTodoException as e:
+        raise _domain_error(e) from e
+
+
+@router.put("/{task_id}", response_model=TaskResponse)
+def update_task(
+    task_id: int,
+    body: TaskUpdate,
+    list_uc: Any = Depends(get_list_uc),  # noqa: B008
+    update_uc: Any = Depends(get_update_uc),  # noqa: B008
+) -> TaskResponse:
+    try:
+        update_uc.execute(
+            task_id,
+            title=body.title,
+            description=body.description,
+            priority=body.priority if body.priority is not None else "",
+            due_date=body.due_date if body.due_date is not None else "",
+            tags=body.tags if body.tags is not None else [],
+            project=body.project if body.project is not None else "",
+        )
+        tasks = list_uc.execute()
+        task = next((t for t in tasks if t.id == task_id), None)
+        if task is None:
+            raise HTTPException(status_code=404, detail=f"Task {task_id} not found")
+        return task_to_response(task)
+    except RazTodoException as e:
+        raise _domain_error(e) from e
+
+
+@router.delete("/{task_id}", status_code=204)
+def delete_task(
+    task_id: int,
+    uc: Any = Depends(get_delete_uc),  # noqa: B008
+) -> None:
+    try:
+        uc.execute(task_id)
+    except RazTodoException as e:
+        raise HTTPException(status_code=404, detail=str(e)) from e
+
+
+@router.patch("/{task_id}/done", response_model=TaskResponse)
+def toggle_done(
+    task_id: int,
+    list_uc: Any = Depends(get_list_uc),  # noqa: B008
+    mark_uc: Any = Depends(get_mark_done_uc),  # noqa: B008
+) -> TaskResponse:
+    try:
+        tasks = list_uc.execute()
+        task = next((t for t in tasks if t.id == task_id), None)
+        if task is None:
+            raise HTTPException(status_code=404, detail=f"Task {task_id} not found")
+        mark_uc.execute(task_id, done=not task.done)
+        tasks = list_uc.execute()
+        task = next((t for t in tasks if t.id == task_id), None)
+        if task is None:
+            raise HTTPException(status_code=404, detail=f"Task {task_id} not found")
+        return task_to_response(task)
+    except RazTodoException as e:
+        raise _domain_error(e) from e

raztodo_web/features/tasks/schemas.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class TaskCreate(BaseModel):
+    title: str = Field(..., min_length=1, max_length=60)
+    description: str = Field(default="")
+    priority: str | None = Field(default=None, pattern="^[LMH]$")
+    due_date: str | None = Field(default=None)
+    tags: list[str] = Field(default_factory=list)
+    project: str | None = Field(default=None)
+
+
+class TaskUpdate(BaseModel):
+    title: str | None = Field(default=None, min_length=1, max_length=60)
+    description: str | None = Field(default=None)
+    priority: str | None = Field(default=None, pattern="^[LMH]$")
+    due_date: str | None = Field(default=None)
+    tags: list[str] | None = Field(default=None)
+    project: str | None = Field(default=None)
+
+
+class TaskResponse(BaseModel):
+    id: int
+    title: str
+    description: str = ""
+    done: bool = False
+    created_at: str = ""
+    priority: str = ""
+    due_date: str | None = None
+    tags: list[str] = Field(default_factory=list)
+    project: str | None = None
+
+
+class ImportPayload(BaseModel):
+    """Raw JSON list of task dicts — validated at use-case level."""
+
+    model_config = {"arbitrary_types_allowed": True}
+
+
+class ClearResponse(BaseModel):
+    deleted: int
+
+
+class ImportResponse(BaseModel):
+    inserted: int
+    updated: int

raztodo_web/web/static/css/base.css

@@ -0,0 +1,22 @@
+/* ── Reset ─────────────────────────────────────────── */
+*,
+*::before,
+*::after {
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0;
+}
+html,
+body {
+    height: 100%;
+}
+
+/* ── Base ──────────────────────────────────────────── */
+body {
+    font-family: var(--font);
+    background: var(--bg-app);
+    color: var(--text-primary);
+    font-size: 15px;
+    line-height: 1.6;
+    -webkit-font-smoothing: antialiased;
+}

raztodo_web/web/static/css/components/forms.css

@@ -0,0 +1,216 @@
+/* ── Form elements ─────────────────────────────────── */
+.form-stack {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.form-row {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 8px;
+}
+
+.field {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+}
+
+.field label {
+    font-size: 11px;
+    color: var(--text-label);
+    font-weight: 500;
+}
+
+input,
+select {
+    width: 100%;
+    padding: 9px 11px;
+    border-radius: var(--r-sm);
+    border: 1px solid var(--border-input);
+    background: var(--bg-input);
+    color: var(--text-primary);
+    font-family: var(--font);
+    font-size: 14px;
+    transition:
+        border-color var(--t),
+        box-shadow var(--t);
+}
+
+input:hover,
+select:hover {
+    border-color: var(--border-focus);
+}
+
+
+input::placeholder {
+    color: var(--text-muted);
+}
+
+
+input:focus,
+select:focus {
+    outline: none;
+    border-color: var(--border-focus);
+    box-shadow: 0 0 0 3px rgba(255, 255, 255, 0.04);
+}
+
+input.input-primary {
+    font-size: 15px;
+    padding: 11px 12px;
+    border-color: var(--border-input);
+}
+
+select option {
+    background: var(--bg-panel);
+}
+
+input.input-primary:hover {
+    border-color: var(--border-focus);
+}
+
+/* ── Buttons ───────────────────────────────────────── */
+.btn-primary {
+    width: 100%;
+    padding: 11px 16px;
+    border-radius: var(--r-sm);
+    border: none;
+    background: var(--accent);
+    color: #fff;
+    font-family: var(--font);
+    font-size: 14px;
+    font-weight: 500;
+    cursor: pointer;
+    transition:
+        background var(--t),
+        transform var(--t);
+    letter-spacing: 0.01em;
+    margin-top: 4px;
+}
+.btn-primary:hover {
+    background: var(--accent-hover);
+}
+.btn-primary:active {
+    transform: scale(0.98);
+}
+
+.btn-ghost {
+    display: flex;
+    align-items: center;
+    gap: 9px;
+    width: 100%;
+    padding: 9px 11px;
+    border-radius: var(--r-sm);
+    border: none;
+    background: transparent;
+    color: var(--text-secondary);
+    font-family: var(--font);
+    font-size: 14px;
+    cursor: pointer;
+    transition:
+        background var(--t),
+        color var(--t);
+    text-align: left;
+}
+.btn-ghost svg {
+    width: 17px;
+    height: 17px;
+    flex-shrink: 0;
+}
+.btn-ghost:hover {
+    background: var(--bg-hover);
+    color: var(--text-primary);
+}
+
+.btn-danger-ghost:hover {
+    background: var(--bg-hover);
+}
+
+.tool-buttons {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+}
+
+/* ── Search ────────────────────────────────────────── */
+.search-wrap {
+    position: relative;
+}
+.search-icon {
+    position: absolute;
+    left: 9px;
+    top: 50%;
+    transform: translateY(-50%);
+    width: 15px;
+    height: 15px;
+    color: var(--text-muted);
+    pointer-events: none;
+}
+.search-wrap input {
+    padding-left: 32px;
+    background: var(--bg-input);
+}
+
+/* ── Priority picker ───────────────────────────────── */
+.priority-picker {
+    display: flex;
+    align-items: stretch;
+    width: 100%;
+    height: 39px;
+    border-radius: var(--r-sm);
+    border: 1px solid var(--border-input);
+    background: var(--bg-input);
+    overflow: hidden;
+    transition: border-color var(--t), box-shadow var(--t);
+}
+.priority-picker:focus-within {
+    border-color: var(--border-focus);
+    box-shadow: 0 0 0 3px rgba(255, 255, 255, 0.04);
+}
+
+.priority-arrow {
+    flex-shrink: 0;
+    width: 36px;
+    border: none;
+    background: transparent;
+    color: var(--text-secondary);
+    font-size: 22px;
+    line-height: 1;
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: background var(--t), color var(--t);
+    padding: 0;
+}
+.priority-arrow:hover:not(:disabled) {
+    background: var(--bg-hover);
+    color: var(--text-primary);
+}
+.priority-arrow:disabled {
+    opacity: 0.25;
+    cursor: default;
+}
+
+.priority-label {
+    flex: 1;
+    text-align: center;
+    font-size: 14px;
+    font-weight: 500;
+    color: var(--text-primary);
+    user-select: none;
+    pointer-events: none;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+}
+
+/* Light theme */
+[data-theme="light"] .priority-picker {
+    background: var(--bg-input);
+    border-color: var(--border-input);
+}
+[data-theme="light"] .priority-arrow:hover:not(:disabled) {
+    background: var(--bg-hover);
+}