runtime-narrative 1.2.1__tar.gz → 1.5.0__tar.gz

{runtime_narrative-1.2.1/runtime_narrative.egg-info → runtime_narrative-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-narrative
-Version: 1.2.1
+Version: 1.5.0
 Summary: Model execution as human-readable stories with lean/rich failure diagnostics and optional LLM analysis
 Author-email: Shashank Raj <shashank.raj28@gmail.com>
 License-Expression: MIT
@@ -211,6 +211,78 @@ Run: `uv run python examples/logging_bridge.py`, `uv run python examples/structu
 
 ---
 
+## Story outcomes: fold the access log into the story line
+
+`StoryCompleted` carries an `outcome` label. The FastAPI/Starlette and Django middlewares set it automatically from the response status, and `ConsoleRenderer` then renders a single self-contained line per request — story name, result, and HTTP status together:
+
+```
+[d7678e] ▶ Story started: GET /api/call
+[d7678e] ▶ Story ended: GET /api/call - SUCCESS (200 OK, 0.023s)
+```
+
+Since the story line now carries everything the server access log would print, you can silence the duplicate line — e.g. `uvicorn.run(app, access_log=False)`.
+
+Outside middleware, set an outcome on any story yourself:
+
+```python
+from runtime_narrative import http_outcome, story
+
+with story("GET /api/call") as runtime:
+    ...
+    runtime.set_outcome(http_outcome(200))   # or any short label, e.g. "3 rows"
+```
+
+---
+
+## Rich logs to a file, and no more flooded polling loops
+
+`ConsoleRenderer` writes its colored, human-readable output to any file-like object, not just the terminal — so the same troubleshooting-friendly narrative can land in a log file alongside the structured JSON stream:
+
+```python
+with open("narrative.log.txt", "a", encoding="utf-8") as log_file:
+    with story("Import Pipeline", renderers=[ConsoleRenderer(output=log_file), JsonRenderer("narrative.log")]):
+        ...
+```
+
+Every auto-instrumentation entry point (FastAPI/Starlette middleware, Django middleware, Celery, gRPC interceptors) picks this up automatically via two environment variables, with no code changes:
+
+```bash
+RUNTIME_NARRATIVE_RICH_LOG_FILE=/var/log/app/narrative.log.txt   # rich console output also goes here
+RUNTIME_NARRATIVE_RICH_LOG_CONSOLE=0                             # optional: stop echoing it to the terminal too
+```
+
+Long-running, poll-heavy stages (status checks every couple of seconds during a big upload or pipeline run) no longer flood the log either. `CoalescingRenderer` wraps any other renderer and collapses a run of identical back-to-back stages into one summary line — total call count and total time, not one line per poll:
+
+```python
+from runtime_narrative import ConsoleRenderer, CoalescingRenderer
+
+with story("Process Upload", renderers=[CoalescingRenderer(ConsoleRenderer())]):
+    for _ in range(45):
+        with stage("Check Pipeline Status"):
+            poll()
+```
+
+```
+[abcdef] ▶ Stage started: Check Pipeline Status
+[abcdef] ✔ Stage completed: Check Pipeline Status (2.010s)
+[abcdef] ▶ Stage started: Check Pipeline Status
+[abcdef] ✔ Stage completed: Check Pipeline Status (2.005s)
+[abcdef] 'Check Pipeline Status' repeated 43 more times (45 total) over 90.400s (avg 2.009s/call)
+```
+
+Every `ConsoleRenderer` line also carries a `YYYY-MM-DD HH:MM:SS.mmm` timestamp, and the module that opened a story or stage — auto-detected with a single cheap frame lookup, no stack walking — shown once on `Story started` and again only when a stage transitions to a different module, so multi-module workflows stay traceable without repeating the tag on every line:
+
+```
+2026-07-03 12:03:41.208 [abcdef] ▶ Story started: Process Upload (app.routes.upload)
+2026-07-03 12:03:41.209 [abcdef]   ▶ Stage started: Validate Input (app.validators)
+2026-07-03 12:03:41.210 [abcdef]   ✔ Stage completed: Validate Input (0.001s)
+2026-07-03 12:03:41.211 [abcdef]   ▶ Stage started: Insert Record (app.db)
+```
+
+Run: `uv run python examples/colorful_errors_and_emojis.py` — full reference: [WIKI §10.1](WIKI.md#101-consolerenderer), [§10.1b](WIKI.md#101b-coalescingrenderer)
+
+---
+
 ## Feature tour
 
 Everything below works the same way in every context (sync/async, decorators, auto-instrumentation, any framework middleware). One line each here; full detail and every parameter in the Wiki.
@@ -221,7 +293,7 @@ Everything below works the same way in every context (sync/async, decorators, au
 | Auto-instrumentation | `@narrative_class`, `@no_stage`, `instrument_module()`, `auto_instrument()` — instrument classes/modules with zero call-site changes | [WIKI §8](WIKI.md#8-auto-instrumentation) |
 | Failure diagnostics | Lean/rich modes, production traceback caps, secret redaction, `FailureDiagnosticsConfig` | [WIKI §9](WIKI.md#9-failure-diagnostics) |
 | Failure analyzers | `OllamaFailureAnalyzer`, `LLMFailureAnalyzer`, `AnthropicFailureAnalyzer`, `DeduplicatingAnalyzer`, `background_analysis=True` | [WIKI §9](WIKI.md#9-failure-diagnostics), [§16](WIKI.md#16-background-analysis) |
-| Renderers | `ConsoleRenderer`, `JsonRenderer`/`RotatingJsonRenderer`, `HtmlReportRenderer`, `SqliteStoryRenderer`, `OtelRenderer`/`OtelLogRenderer`/`OtelMetricsRenderer`, `PrometheusRenderer`, `AlertRoutingRenderer`, `FilteredRenderer` | [WIKI §10](WIKI.md#10-renderers) |
+| Renderers | `ConsoleRenderer` (optional file `output=`), `JsonRenderer`/`RotatingJsonRenderer`, `HtmlReportRenderer`, `SqliteStoryRenderer`, `OtelRenderer`/`OtelLogRenderer`/`OtelMetricsRenderer`, `PrometheusRenderer`, `AlertRoutingRenderer`, `FilteredRenderer`, `CoalescingRenderer` | [WIKI §10](WIKI.md#10-renderers) |
 | Framework integrations | FastAPI/Starlette middleware, Django ASGI/WSGI middleware, Celery task base class, gRPC interceptors | [WIKI §11](WIKI.md#11-framework-integrations) |
 | Async task groups | `NarrativeTaskGroup` — concurrent `asyncio` tasks under one shared story | [WIKI §12](WIKI.md#12-async-task-groups) |
 | Persistence & CLI | `SqliteStoryRenderer` + `runtime-narrative failures` / `runtime-narrative story <id>` | [WIKI §13](WIKI.md#13-sqlite-persistence-and-cli) |
@@ -302,6 +374,8 @@ Every script under `examples/` is runnable as-is: `uv run python examples/<name>
 | `RUNTIME_NARRATIVE_ALLOW_RICH_IN_PRODUCTION` | `1`, `true` | off | Bypass production safeguard; allow rich diagnostics in production |
 | `RUNTIME_NARRATIVE_MODEL` | model name string | — | Default model for `AnthropicFailureAnalyzer`; also used by example scripts for `OllamaFailureAnalyzer` / `LLMFailureAnalyzer` |
 | `ANTHROPIC_API_KEY` | API key | — | Required by `AnthropicFailureAnalyzer`; read automatically if `api_key=` is not passed |
+| `RUNTIME_NARRATIVE_RICH_LOG_FILE` | file path | — | Adds a file-backed `ConsoleRenderer` writing rich, human-readable output to this path, on top of whichever renderer TTY detection selects. Read by every auto-instrumentation entry point (FastAPI/Starlette, Django, Celery, gRPC) when `renderers=` is omitted |
+| `RUNTIME_NARRATIVE_RICH_LOG_CONSOLE` | `1`, `0` | `1` | With `RUNTIME_NARRATIVE_RICH_LOG_FILE` set and stdout a TTY, `0` suppresses the terminal copy so the narrative goes to the file only |
 
 ---
 

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/README.md

@@ -152,6 +152,78 @@ Run: `uv run python examples/logging_bridge.py`, `uv run python examples/structu
 
 ---
 
+## Story outcomes: fold the access log into the story line
+
+`StoryCompleted` carries an `outcome` label. The FastAPI/Starlette and Django middlewares set it automatically from the response status, and `ConsoleRenderer` then renders a single self-contained line per request — story name, result, and HTTP status together:
+
+```
+[d7678e] ▶ Story started: GET /api/call
+[d7678e] ▶ Story ended: GET /api/call - SUCCESS (200 OK, 0.023s)
+```
+
+Since the story line now carries everything the server access log would print, you can silence the duplicate line — e.g. `uvicorn.run(app, access_log=False)`.
+
+Outside middleware, set an outcome on any story yourself:
+
+```python
+from runtime_narrative import http_outcome, story
+
+with story("GET /api/call") as runtime:
+    ...
+    runtime.set_outcome(http_outcome(200))   # or any short label, e.g. "3 rows"
+```
+
+---
+
+## Rich logs to a file, and no more flooded polling loops
+
+`ConsoleRenderer` writes its colored, human-readable output to any file-like object, not just the terminal — so the same troubleshooting-friendly narrative can land in a log file alongside the structured JSON stream:
+
+```python
+with open("narrative.log.txt", "a", encoding="utf-8") as log_file:
+    with story("Import Pipeline", renderers=[ConsoleRenderer(output=log_file), JsonRenderer("narrative.log")]):
+        ...
+```
+
+Every auto-instrumentation entry point (FastAPI/Starlette middleware, Django middleware, Celery, gRPC interceptors) picks this up automatically via two environment variables, with no code changes:
+
+```bash
+RUNTIME_NARRATIVE_RICH_LOG_FILE=/var/log/app/narrative.log.txt   # rich console output also goes here
+RUNTIME_NARRATIVE_RICH_LOG_CONSOLE=0                             # optional: stop echoing it to the terminal too
+```
+
+Long-running, poll-heavy stages (status checks every couple of seconds during a big upload or pipeline run) no longer flood the log either. `CoalescingRenderer` wraps any other renderer and collapses a run of identical back-to-back stages into one summary line — total call count and total time, not one line per poll:
+
+```python
+from runtime_narrative import ConsoleRenderer, CoalescingRenderer
+
+with story("Process Upload", renderers=[CoalescingRenderer(ConsoleRenderer())]):
+    for _ in range(45):
+        with stage("Check Pipeline Status"):
+            poll()
+```
+
+```
+[abcdef] ▶ Stage started: Check Pipeline Status
+[abcdef] ✔ Stage completed: Check Pipeline Status (2.010s)
+[abcdef] ▶ Stage started: Check Pipeline Status
+[abcdef] ✔ Stage completed: Check Pipeline Status (2.005s)
+[abcdef] 'Check Pipeline Status' repeated 43 more times (45 total) over 90.400s (avg 2.009s/call)
+```
+
+Every `ConsoleRenderer` line also carries a `YYYY-MM-DD HH:MM:SS.mmm` timestamp, and the module that opened a story or stage — auto-detected with a single cheap frame lookup, no stack walking — shown once on `Story started` and again only when a stage transitions to a different module, so multi-module workflows stay traceable without repeating the tag on every line:
+
+```
+2026-07-03 12:03:41.208 [abcdef] ▶ Story started: Process Upload (app.routes.upload)
+2026-07-03 12:03:41.209 [abcdef]   ▶ Stage started: Validate Input (app.validators)
+2026-07-03 12:03:41.210 [abcdef]   ✔ Stage completed: Validate Input (0.001s)
+2026-07-03 12:03:41.211 [abcdef]   ▶ Stage started: Insert Record (app.db)
+```
+
+Run: `uv run python examples/colorful_errors_and_emojis.py` — full reference: [WIKI §10.1](WIKI.md#101-consolerenderer), [§10.1b](WIKI.md#101b-coalescingrenderer)
+
+---
+
 ## Feature tour
 
 Everything below works the same way in every context (sync/async, decorators, auto-instrumentation, any framework middleware). One line each here; full detail and every parameter in the Wiki.
@@ -162,7 +234,7 @@ Everything below works the same way in every context (sync/async, decorators, au
 | Auto-instrumentation | `@narrative_class`, `@no_stage`, `instrument_module()`, `auto_instrument()` — instrument classes/modules with zero call-site changes | [WIKI §8](WIKI.md#8-auto-instrumentation) |
 | Failure diagnostics | Lean/rich modes, production traceback caps, secret redaction, `FailureDiagnosticsConfig` | [WIKI §9](WIKI.md#9-failure-diagnostics) |
 | Failure analyzers | `OllamaFailureAnalyzer`, `LLMFailureAnalyzer`, `AnthropicFailureAnalyzer`, `DeduplicatingAnalyzer`, `background_analysis=True` | [WIKI §9](WIKI.md#9-failure-diagnostics), [§16](WIKI.md#16-background-analysis) |
-| Renderers | `ConsoleRenderer`, `JsonRenderer`/`RotatingJsonRenderer`, `HtmlReportRenderer`, `SqliteStoryRenderer`, `OtelRenderer`/`OtelLogRenderer`/`OtelMetricsRenderer`, `PrometheusRenderer`, `AlertRoutingRenderer`, `FilteredRenderer` | [WIKI §10](WIKI.md#10-renderers) |
+| Renderers | `ConsoleRenderer` (optional file `output=`), `JsonRenderer`/`RotatingJsonRenderer`, `HtmlReportRenderer`, `SqliteStoryRenderer`, `OtelRenderer`/`OtelLogRenderer`/`OtelMetricsRenderer`, `PrometheusRenderer`, `AlertRoutingRenderer`, `FilteredRenderer`, `CoalescingRenderer` | [WIKI §10](WIKI.md#10-renderers) |
 | Framework integrations | FastAPI/Starlette middleware, Django ASGI/WSGI middleware, Celery task base class, gRPC interceptors | [WIKI §11](WIKI.md#11-framework-integrations) |
 | Async task groups | `NarrativeTaskGroup` — concurrent `asyncio` tasks under one shared story | [WIKI §12](WIKI.md#12-async-task-groups) |
 | Persistence & CLI | `SqliteStoryRenderer` + `runtime-narrative failures` / `runtime-narrative story <id>` | [WIKI §13](WIKI.md#13-sqlite-persistence-and-cli) |
@@ -243,6 +315,8 @@ Every script under `examples/` is runnable as-is: `uv run python examples/<name>
 | `RUNTIME_NARRATIVE_ALLOW_RICH_IN_PRODUCTION` | `1`, `true` | off | Bypass production safeguard; allow rich diagnostics in production |
 | `RUNTIME_NARRATIVE_MODEL` | model name string | — | Default model for `AnthropicFailureAnalyzer`; also used by example scripts for `OllamaFailureAnalyzer` / `LLMFailureAnalyzer` |
 | `ANTHROPIC_API_KEY` | API key | — | Required by `AnthropicFailureAnalyzer`; read automatically if `api_key=` is not passed |
+| `RUNTIME_NARRATIVE_RICH_LOG_FILE` | file path | — | Adds a file-backed `ConsoleRenderer` writing rich, human-readable output to this path, on top of whichever renderer TTY detection selects. Read by every auto-instrumentation entry point (FastAPI/Starlette, Django, Celery, gRPC) when `renderers=` is omitted |
+| `RUNTIME_NARRATIVE_RICH_LOG_CONSOLE` | `1`, `0` | `1` | With `RUNTIME_NARRATIVE_RICH_LOG_FILE` set and stdout a TTY, `0` suppresses the terminal copy so the narrative goes to the file only |
 
 ---
 

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "runtime-narrative"
-version = "1.2.1"
+version = "1.5.0"
 description = "Model execution as human-readable stories with lean/rich failure diagnostics and optional LLM analysis"
 readme = "README.md"
 license = "MIT"
@@ -84,13 +84,17 @@ packages = ["runtime_narrative", "runtime_narrative.renderer", "runtime_narrativ
 [dependency-groups]
 dev = [
     "build>=1.4.0",
+    "fastapi>=0.100.0",
     "httpx>=0.27.0",
     "opentelemetry-api>=1.20.0",
     "opentelemetry-sdk>=1.20.0",
     "prometheus-client>=0.19.0",
+    "pydantic>=2.0.0",
     "pytest>=8.0.0",
     "starlette>=0.27.0",
     "twine>=6.2.0",
+    "typer>=0.9.0",
+    "uvicorn>=0.23.0",
 ]
 
 [tool.pytest.ini_options]

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/runtime_narrative/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.2.1"
+__version__ = "1.5.0"
 
 from .analyzers import FailureAnalyzer, LLMFailureAnalyzer, OllamaFailureAnalyzer, DeduplicatingAnalyzer
 from .context import has_active_story
@@ -16,8 +16,10 @@ from .events import (
 )
 from .instrumentation import auto_instrument, instrument_module, narrative_class, narrative_stage, no_stage
 from .logging_bridge import NarrativeLogHandler
+from .outcome import http_outcome
 from .renderer.console import ConsoleRenderer
 from .renderer.filter_renderer import FilteredRenderer
+from .renderer.coalescing_renderer import CoalescingRenderer
 from .renderer.json_renderer import JsonRenderer, RotatingJsonRenderer
 from .stage import stage
 from .story import story, StoryRuntime
@@ -105,6 +107,7 @@ __all__ = [
     "RuntimeNarrativeMiddleware",
     "ConsoleRenderer",
     "FilteredRenderer",
+    "CoalescingRenderer",
     "JsonRenderer",
     "RotatingJsonRenderer",
     "OtelRenderer",
@@ -120,6 +123,7 @@ __all__ = [
     "LLMAnalysisReady",
     "LogRecorded",
     "NarrativeLogHandler",
+    "http_outcome",
     "FailureDiagnosticsConfig",
     "build_enriched_failure",
     "effective_diagnostics_mode",

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/runtime_narrative/celery.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
-import sys
 from typing import Any, Sequence
 
+from .renderer_defaults import default_renderers
 from .story import story
 
 try:
@@ -15,14 +15,6 @@ except ImportError:
     _TaskBase = object
 
 
-def _default_renderers() -> tuple:
-    if getattr(sys.stdout, "isatty", lambda: False)():
-        from .renderer.console import ConsoleRenderer
-        return (ConsoleRenderer(),)
-    from .renderer.json_renderer import JsonRenderer
-    return (JsonRenderer(),)
-
-
 class NarrativeTask(_TaskBase):  # type: ignore[valid-type,misc]
     abstract = True
 
@@ -47,7 +39,7 @@ class NarrativeTask(_TaskBase):  # type: ignore[valid-type,misc]
         request = getattr(self, "request", None)
         task_id = getattr(request, "id", None) or "unknown"
         story_name = f"{self.name} [task_id={task_id}]"
-        renderers = self.narrative_renderers if self.narrative_renderers is not None else _default_renderers()
+        renderers = self.narrative_renderers if self.narrative_renderers is not None else default_renderers()
         with story(
             story_name,
             renderers=renderers,

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/runtime_narrative/decorators.py

@@ -41,6 +41,10 @@ def runtime_narrative_story(
             "failure_diagnostics": failure_diagnostics,
             "allow_rich_in_production": allow_rich_in_production,
             "app_roots": app_roots,
+            # Without this, story() would auto-detect the caller's frame as
+            # this decorator's own wrapper closure, reporting every decorated
+            # story as "runtime_narrative.decorators" instead of func's module.
+            "module": func.__module__,
         }
 
         if inspect.iscoroutinefunction(func):
@@ -72,14 +76,14 @@ def runtime_narrative_stage(name: str | None = None) -> Callable[[F], F]:
 
             @wraps(func)
             async def async_wrapper(*args: Any, **kwargs: Any):
-                async with stage(stage_name):
+                async with stage(stage_name, module=func.__module__):
                     return await func(*args, **kwargs)
 
             return async_wrapper  # type: ignore[return-value]
 
         @wraps(func)
         def sync_wrapper(*args: Any, **kwargs: Any):
-            with stage(stage_name):
+            with stage(stage_name, module=func.__module__):
                 return func(*args, **kwargs)
 
         return sync_wrapper  # type: ignore[return-value]

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/runtime_narrative/events.py

@@ -12,6 +12,7 @@ class StoryStarted:
     timestamp: datetime
     parent_story_id: str | None = None
     root_story_id: str = ""
+    module: str = ""
 
 
 @dataclass
@@ -23,6 +24,7 @@ class StageStarted:
     parent_stage_name: str | None = None
     story_name: str = ""
     root_story_id: str = ""
+    module: str = ""
 
 
 @dataclass
@@ -82,6 +84,7 @@ class StoryCompleted:
     duration_seconds: float = 0.0
     parent_story_id: str | None = None
     root_story_id: str = ""
+    outcome: str = ""
 
 
 @dataclass

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/runtime_narrative/grpc_interceptor.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
-import sys
 from typing import Any, Callable, Sequence
 
+from .renderer_defaults import default_renderers
 from .story import story
 
 try:
@@ -24,17 +24,9 @@ except ImportError:
     _AsyncBase = object
 
 
-def _default_renderers() -> tuple:
-    if getattr(sys.stdout, "isatty", lambda: False)():
-        from .renderer.console import ConsoleRenderer
-        return (ConsoleRenderer(),)
-    from .renderer.json_renderer import JsonRenderer
-    return (JsonRenderer(),)
-
-
 def _story_kwargs(interceptor: Any) -> dict:
     return {
-        "renderers": interceptor._renderers or _default_renderers(),
+        "renderers": interceptor._renderers or default_renderers(),
         "failure_analyzer": interceptor._failure_analyzer,
         "diagnostics_config": interceptor._diagnostics_config,
         "runtime_environment": interceptor._runtime_environment,

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/runtime_narrative/middleware.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import sys
 from typing import Any, Callable, Sequence
 
 from starlette.middleware.base import BaseHTTPMiddleware
@@ -8,6 +7,8 @@ from starlette.requests import Request
 from starlette.responses import Response
 
 from .diagnostics import FailureDiagnosticsConfig
+from .outcome import http_outcome
+from .renderer_defaults import default_renderers
 from .story import story
 
 try:
@@ -18,15 +19,6 @@ except ImportError:
     _OTEL_PROPAGATION_AVAILABLE = False
 
 
-def _default_middleware_renderers() -> tuple:
-    """Return ConsoleRenderer when attached to a real terminal, JsonRenderer otherwise."""
-    if getattr(sys.stdout, "isatty", lambda: False)():
-        from .renderer.console import ConsoleRenderer
-        return (ConsoleRenderer(),)
-    from .renderer.json_renderer import JsonRenderer
-    return (JsonRenderer(),)
-
-
 class RuntimeNarrativeMiddleware(BaseHTTPMiddleware):
     """
     FastAPI/Starlette middleware that wraps every HTTP request in a runtime_narrative story.
@@ -37,6 +29,8 @@ class RuntimeNarrativeMiddleware(BaseHTTPMiddleware):
     When no ``renderers`` are passed, the middleware auto-selects:
     - ``ConsoleRenderer`` if ``sys.stdout`` is a real TTY (local dev server)
     - ``JsonRenderer`` otherwise (production, Docker, CI — any non-interactive environment)
+    - Set ``RUNTIME_NARRATIVE_RICH_LOG_FILE=<path>`` to also (or instead, combined with
+      ``RUNTIME_NARRATIVE_RICH_LOG_CONSOLE=0``) write the human-readable narrative to a file.
 
     Usage::
 
@@ -76,7 +70,7 @@ class RuntimeNarrativeMiddleware(BaseHTTPMiddleware):
         skip_if: Callable[[Request], bool] | None = None,
     ):
         super().__init__(app)
-        self._renderers = tuple(renderers) if renderers is not None else _default_middleware_renderers()
+        self._renderers = tuple(renderers) if renderers is not None else default_renderers()
         self._failure_analyzer = failure_analyzer
         self._diagnostics_config = diagnostics_config
         self._runtime_environment = runtime_environment
@@ -107,8 +101,9 @@ class RuntimeNarrativeMiddleware(BaseHTTPMiddleware):
                 allow_rich_in_production=self._allow_rich_in_production,
                 app_roots=self._app_roots,
                 redact_extra=self._redact_extra,
-            ):
+            ) as runtime:
                 response = await call_next(request)
+                runtime.set_outcome(http_outcome(response.status_code))
             return response
         finally:
             if token is not None:

{runtime_narrative-1.2.1 → runtime_narrative-1.5.0}/runtime_narrative/middleware_django.py

@@ -1,9 +1,10 @@
 from __future__ import annotations
 
-import sys
 from typing import Any, Sequence
 
 from .diagnostics import FailureDiagnosticsConfig
+from .outcome import http_outcome
+from .renderer_defaults import default_renderers
 from .story import story
 
 try:
@@ -13,14 +14,6 @@ except ImportError:
     _DJANGO_AVAILABLE = False
 
 
-def _default_renderers() -> tuple:
-    if getattr(sys.stdout, "isatty", lambda: False)():
-        from .renderer.console import ConsoleRenderer
-        return (ConsoleRenderer(),)
-    from .renderer.json_renderer import JsonRenderer
-    return (JsonRenderer(),)
-
-
 class RuntimeNarrativeDjangoMiddleware:
     async_capable = True
     sync_capable = False
@@ -44,7 +37,7 @@ class RuntimeNarrativeDjangoMiddleware:
                 "Install it with: pip install django"
             )
         self.get_response = get_response
-        self._renderers = tuple(renderers) if renderers is not None else _default_renderers()
+        self._renderers = tuple(renderers) if renderers is not None else default_renderers()
         self._failure_analyzer = failure_analyzer
         self._diagnostics_config = diagnostics_config
         self._runtime_environment = runtime_environment
@@ -65,8 +58,11 @@ class RuntimeNarrativeDjangoMiddleware:
             allow_rich_in_production=self._allow_rich_in_production,
             app_roots=self._app_roots,
             redact_extra=self._redact_extra,
-        ):
+        ) as runtime:
             response = await self.get_response(request)
+            status_code = getattr(response, "status_code", None)
+            if status_code is not None:
+                runtime.set_outcome(http_outcome(status_code))
         return response
 
 
@@ -93,7 +89,7 @@ class RuntimeNarrativeDjangoSyncMiddleware:
                 "Install it with: pip install django"
             )
         self.get_response = get_response
-        self._renderers = tuple(renderers) if renderers is not None else _default_renderers()
+        self._renderers = tuple(renderers) if renderers is not None else default_renderers()
         self._failure_analyzer = failure_analyzer
         self._diagnostics_config = diagnostics_config
         self._runtime_environment = runtime_environment
@@ -114,8 +110,11 @@ class RuntimeNarrativeDjangoSyncMiddleware:
             allow_rich_in_production=self._allow_rich_in_production,
             app_roots=self._app_roots,
             redact_extra=self._redact_extra,
-        ):
+        ) as runtime:
             response = self.get_response(request)
+            status_code = getattr(response, "status_code", None)
+            if status_code is not None:
+                runtime.set_outcome(http_outcome(status_code))
         return response
 
 

runtime_narrative-1.5.0/runtime_narrative/outcome.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from http import HTTPStatus
+
+
+def http_outcome(status_code: int) -> str:
+    """Format an HTTP status code as a "200 OK"-style story outcome label.
+
+    Sync by design: pure data transformation with no I/O.
+    """
+    try:
+        return f"{status_code} {HTTPStatus(status_code).phrase}"
+    except ValueError:
+        return str(status_code)
+
+
+__all__ = ["http_outcome"]