refactor: finish declutter - test_flow removal, NOT NULL schema, parametrized tests, smoke harness, docs

backend/app/auth/service.py

@@ -254,7 +254,7 @@ def _jwt_secret() -> str:
 
 
 def mint_session_token(user: User) -> str:
-    """Issue a stateless session JWT for a user (30-day expiry)."""
+    """Issue a stateless session JWT for a user (7-day expiry)."""
     now = utcnow()
     return jwt.encode(
         {

backend/app/flows/api.py

@@ -27,7 +27,6 @@ from app.middleware import limiter, run_limit
 from app.models import User
 from app.settings import settings
 
-from . import input_schema as form_schema
 from . import runner, store
 from .deploy import import_from_langflow
 from .langflow_client import LangflowClient, LangflowError, LangflowNotFound, LangflowUnavailable
@@ -363,7 +362,7 @@ def get_input_schema(
         version = store.get_latest_deployed_version(session, flow_id)
     except (store.NotFoundError, store.InvalidError) as exc:
         raise HTTPException(status_code=404, detail=str(exc)) from exc
-    cached = version.input_schema or form_schema.extract_form_schema(version.langflow_json)
+    cached = version.input_schema
     return InputSchemaRead(
         flow_id=flow_id,
         version_no=version.version_no,

backend/app/flows/runner.py

@@ -70,7 +70,7 @@ async def execute_run(
     run = store.create_run(
         session, version, input=payload, tenant_id=tenant_id, session_id=session_id
     )
-    cached = version.input_schema or form_schema.extract_form_schema(version.langflow_json)
+    cached = version.input_schema
     envelope = build_envelope(
         payload=payload,
         run_id=run.id,
@@ -119,7 +119,7 @@ async def stream_run(
     run = store.create_run(
         session, version, input=payload, tenant_id=tenant_id, session_id=session_id
     )
-    cached = version.input_schema or form_schema.extract_form_schema(version.langflow_json)
+    cached = version.input_schema
     envelope = build_envelope(
         payload=payload,
         run_id=run.id,

backend/app/flows/schemas.py

@@ -37,7 +37,7 @@ class FlowVersionRead(BaseModel):
     deployed_at: datetime | None
     author: str
     created_at: datetime
-    input_schema: dict | None = None
+    input_schema: dict
 
 
 class InputSchemaRead(BaseModel):

backend/app/models/flow.py

@@ -47,8 +47,8 @@ class FlowVersion(SQLModel, table=True):
     author: str = Field(default="", max_length=200)
     created_at: datetime = Field(default_factory=utcnow, sa_column=ts_column())
     # Cached form schema for this exact JSON (see app/flows/input_schema.py).
-    # Computed at version creation; nullable for pre-Phase-3 rows.
-    input_schema: dict | None = Field(default=None, sa_column=_json_column())
+    # Computed at version creation; backfilled NOT NULL (e8f3a1c2b4d6).
+    input_schema: dict = Field(default_factory=dict, sa_column=Column(JSON, nullable=False))
 
 
 class FlowRun(SQLModel, table=True):