plain.observer 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

plain/observer/CHANGELOG.md

@@ -1,5 +1,27 @@
 # plain-observer changelog
 
+## [0.3.3](https://github.com/dropseed/plain/releases/plain-observer@0.3.3) (2025-07-25)
+
+### What's changed
+
+- Added `--print` option to the `plain observer diagnose` command to print prompts without running agents ([9721331](https://github.com/dropseed/plain/commit/9721331e40))
+- The `plain observer diagnose` command now uses the shared `prompt_agent` utility for better consistency ([de1fa72](https://github.com/dropseed/plain/commit/de1fa7253a))
+- Added comprehensive installation instructions to the README including package installation, URL configuration, and migration steps ([950939b](https://github.com/dropseed/plain/commit/950939b619))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.3.2](https://github.com/dropseed/plain/releases/plain-observer@0.3.2) (2025-07-25)
+
+### What's changed
+
+- The diagnose agent command now instructs the AI to examine the codebase before making suggestions ([f5ae388](https://github.com/dropseed/plain/commit/f5ae388833))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.3.1](https://github.com/dropseed/plain/releases/plain-observer@0.3.1) (2025-07-23)
 
 ### What's changed

plain/observer/README.md

@@ -1,3 +1,39 @@
 # plain.observer
 
-**Monitor.**
+**On-page telemetry and observability tools for Plain.**
+
+## Installation
+
+```bash
+uv add plain.observer
+```
+
+Add `plain.observer` to your `INSTALLED_PACKAGES`:
+
+```python
+# app/settings.py
+INSTALLED_PACKAGES = [
+    # ...
+    "plain.observer",
+]
+```
+
+Include the observer URLs in your URL configuration:
+
+```python
+# app/urls.py
+from plain.urls import Router, include
+
+class AppRouter(Router):
+    namespace = ""
+    urls = [
+        # ...
+        include("observer/", "plain.observer.urls"),
+    ]
+```
+
+Run migrations to create the necessary database tables:
+
+```bash
+plain migrate
+```

plain/observer/cli.py

@@ -1,12 +1,11 @@
 import json
-import shlex
-import subprocess
 import sys
 import urllib.request
 
 import click
 
 from plain.cli import register_cli
+from plain.cli.agent import prompt_agent
 from plain.observer.models import Span, Trace
 
 
@@ -497,7 +496,13 @@ def format_trace_output(trace):
     envvar="PLAIN_AGENT_COMMAND",
     help="Run command with generated prompt",
 )
-def diagnose(trace_id, url, json_input, agent_command):
+@click.option(
+    "--print",
+    "print_only",
+    is_flag=True,
+    help="Print the prompt without running the agent",
+)
+def diagnose(trace_id, url, json_input, agent_command, print_only):
     """Generate a diagnostic prompt for analyzing a trace.
 
     By default, provide a trace ID from the database. Use --url for a shareable
@@ -543,7 +548,7 @@ def diagnose(trace_id, url, json_input, agent_command):
     prompt_lines = [
         "I have an OpenTelemetry trace data JSON from a Plain application. Analyze it for performance issues or improvements.",
         "",
-        "Focus on easy and obvious wins first and foremost. If there is nothing obvious, that's ok! Tell me that and ask whether there are specific things we should look deeper into.",
+        "Focus on easy and obvious wins first and foremost. You have access to the codebase, so make sure you look at it before suggesting anything! If there is nothing obvious, that's ok -- tell me that and ask whether there are specific things we should look deeper into.",
         "",
         "If potential code changes are found, briefly explain them and ask whether we should implement them.",
         "",
@@ -556,21 +561,6 @@ def diagnose(trace_id, url, json_input, agent_command):
 
     prompt = "\n".join(prompt_lines)
 
-    if agent_command:
-        cmd = shlex.split(agent_command)
-        cmd.append(prompt)
-        result = subprocess.run(cmd, check=False)
-        if result.returncode != 0:
-            click.secho(
-                f"Agent command failed with exit code {result.returncode}",
-                fg="red",
-                err=True,
-            )
-    else:
-        click.echo(prompt)
-        click.secho(
-            "\nCopy the prompt above to a coding agent. To run an agent automatically, use --agent-command or set the PLAIN_AGENT_COMMAND environment variable.",
-            dim=True,
-            italic=True,
-            err=True,
-        )
+    success = prompt_agent(prompt, agent_command, print_only)
+    if not success:
+        raise click.Abort()

plain_observer-0.3.3.dist-info/METADATA

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: plain.observer
+Version: 0.3.3
+Summary: On-page telemetry and observability tools for Plain.
+Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: opentelemetry-sdk>=1.34.1
+Requires-Dist: plain-admin<1.0.0
+Requires-Dist: plain<1.0.0
+Description-Content-Type: text/markdown
+
+# plain.observer
+
+**On-page telemetry and observability tools for Plain.**
+
+## Installation
+
+```bash
+uv add plain.observer
+```
+
+Add `plain.observer` to your `INSTALLED_PACKAGES`:
+
+```python
+# app/settings.py
+INSTALLED_PACKAGES = [
+    # ...
+    "plain.observer",
+]
+```
+
+Include the observer URLs in your URL configuration:
+
+```python
+# app/urls.py
+from plain.urls import Router, include
+
+class AppRouter(Router):
+    namespace = ""
+    urls = [
+        # ...
+        include("observer/", "plain.observer.urls"),
+    ]
+```
+
+Run migrations to create the necessary database tables:
+
+```bash
+plain migrate
+```

{plain_observer-0.3.1.dist-info → plain_observer-0.3.3.dist-info}/RECORD

@@ -1,8 +1,8 @@
-plain/observer/CHANGELOG.md,sha256=AjTGgo-wwRvR3aljVmhukc-DGoAWUNyian65hSADDZI,3023
-plain/observer/README.md,sha256=5wM48-iE8i7xOjIK8KCgZ-Vmp2xpDtX73UnE5QeNnd4,31
+plain/observer/CHANGELOG.md,sha256=r0_rxaPSTqGZHICwXhYLNiApmrXqzBf_VUV-J9uFB84,4048
+plain/observer/README.md,sha256=hHpKfD75aDnQMy1bY39uNSVoXqSSIcIKcHN_JaJMEZs,606
 plain/observer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/observer/admin.py,sha256=Csvd5V9F5u0zksWpbpISY_NlBJa-0TptSX_Kn652WRc,2719
-plain/observer/cli.py,sha256=-huHPj4xkrq4xemDo8XzoNtmE53g0YWuVLW66Gr1d88,20935
+plain/observer/cli.py,sha256=oP_aeno-xYQ2YemQVNFwhmLevDdkf1uLRk-wpOUxqdU,20640
 plain/observer/config.py,sha256=FuJi1jiDSvOTcmP-6Ea4OlGZt5cRf4iTp1e0dgpJ45E,1494
 plain/observer/core.py,sha256=D9vX0GP8JBB8-NFAKrOwPSHl_wdZo1h0A5C6xKsJVjA,2245
 plain/observer/default_settings.py,sha256=JN2jT2wfa6f80EqU0p4Ox_47xyxL-Ym5-_pftY7xj2U,197
@@ -19,7 +19,7 @@ plain/observer/templates/observer/trace_share.html,sha256=HrYLti5BpX96-6Bm_37OOb
 plain/observer/templates/observer/traces.html,sha256=cFnlIuCf6XJEpHRD2_yfVmPDGZfiqMq6Cg-iMlT3CWY,22184
 plain/observer/templates/toolbar/observer.html,sha256=uaDKiWR7EYqC1kEXE-uHDlE7nfFEMR_zmOgvlKwQHJ4,1365
 plain/observer/templates/toolbar/observer_button.html,sha256=xsHJSuOjW6ddnxlPlPKek22WrWnuVYGIcBfFdkb76pk,1199
-plain_observer-0.3.1.dist-info/METADATA,sha256=iX8SwrvpuhV4JJUztd7kRoYmryHj4W5ybnckPj99mV0,429
-plain_observer-0.3.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_observer-0.3.1.dist-info/licenses/LICENSE,sha256=YZdq6Pz8ivjs97eSVLRmoGDI1hjEikX6N49DfM0DWio,1500
-plain_observer-0.3.1.dist-info/RECORD,,
+plain_observer-0.3.3.dist-info/METADATA,sha256=N34q8Ad8ad72MSkZtndP9woazPgI54Eylicz0hLT8qg,1004
+plain_observer-0.3.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_observer-0.3.3.dist-info/licenses/LICENSE,sha256=YZdq6Pz8ivjs97eSVLRmoGDI1hjEikX6N49DfM0DWio,1500
+plain_observer-0.3.3.dist-info/RECORD,,

plain_observer-0.3.1.dist-info/METADATA

@@ -1,16 +0,0 @@
-Metadata-Version: 2.4
-Name: plain.observer
-Version: 0.3.1
-Summary: On-page telemetry and observability tools for Plain.
-Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
-License-Expression: BSD-3-Clause
-License-File: LICENSE
-Requires-Python: >=3.11
-Requires-Dist: opentelemetry-sdk>=1.34.1
-Requires-Dist: plain-admin<1.0.0
-Requires-Dist: plain<1.0.0
-Description-Content-Type: text/markdown
-
-# plain.observer
-
-**Monitor.**