plain 0.86.2__tar.gz → 0.97.0__tar.gz

{plain-0.86.2 → plain-0.97.0}/.gitignore

@@ -5,6 +5,8 @@
 __pycache__
 *.DS_Store
 
+/*.code-workspace
+
 # Test apps
 plain*/tests/.plain
 

{plain-0.86.2 → plain-0.97.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain
-Version: 0.86.2
+Version: 0.97.0
 Summary: A web framework for building products with Python.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-Expression: BSD-3-Clause

{plain-0.86.2 → plain-0.97.0}/plain/CHANGELOG.md

@@ -1,5 +1,199 @@
 # plain changelog
 
+## [0.97.0](https://github.com/dropseed/plain/releases/plain@0.97.0) (2026-01-13)
+
+### What's changed
+
+- HTTP exceptions (`NotFoundError404`, `ForbiddenError403`, `BadRequestError400`, and `SuspiciousOperationError400` variants) moved from `plain.exceptions` to `plain.http.exceptions` and are now exported from `plain.http` ([b61f909e29](https://github.com/dropseed/plain/commit/b61f909e29))
+
+### Upgrade instructions
+
+- Update imports of HTTP exceptions from `plain.exceptions` to `plain.http`:
+
+    ```python
+    # Before
+    from plain.exceptions import NotFoundError404, ForbiddenError403, BadRequestError400
+
+    # After
+    from plain.http import NotFoundError404, ForbiddenError403, BadRequestError400
+    ```
+
+## [0.96.0](https://github.com/dropseed/plain/releases/plain@0.96.0) (2026-01-13)
+
+### What's changed
+
+- Response classes renamed for consistency: `ResponseRedirect` → `RedirectResponse`, `ResponseNotModified` → `NotModifiedResponse`, `ResponseNotAllowed` → `NotAllowedResponse` ([fad5bf28b0](https://github.com/dropseed/plain/commit/fad5bf28b0))
+- Redundant response classes removed: `ResponseNotFound`, `ResponseForbidden`, `ResponseBadRequest`, `ResponseGone`, `ResponseServerError` - use `Response(status_code=X)` instead ([fad5bf28b0](https://github.com/dropseed/plain/commit/fad5bf28b0))
+- HTTP exceptions renamed to include status code suffix: `Http404` → `NotFoundError404`, `PermissionDenied` → `ForbiddenError403`, `BadRequest` → `BadRequestError400`, `SuspiciousOperation` → `SuspiciousOperationError400` ([5a1f020f52](https://github.com/dropseed/plain/commit/5a1f020f52))
+- Added `Secret[T]` type annotation for masking sensitive settings like `SECRET_KEY` in CLI output ([8713dc08b0](https://github.com/dropseed/plain/commit/8713dc08b0))
+- Added `ENV_SETTINGS_PREFIXES` setting to configure which environment variable prefixes are checked for settings (defaults to `["PLAIN_"]`) ([8713dc08b0](https://github.com/dropseed/plain/commit/8713dc08b0))
+- New `plain settings list` and `plain settings get` CLI commands for viewing settings with their sources ([8713dc08b0](https://github.com/dropseed/plain/commit/8713dc08b0))
+- Added preflight check for unused environment variables matching configured prefixes ([8713dc08b0](https://github.com/dropseed/plain/commit/8713dc08b0))
+- Renamed `request.meta` to `request.environ` for clarity ([786b95bef8](https://github.com/dropseed/plain/commit/786b95bef8))
+- Added `request.query_string` and `request.content_length` properties ([786b95bef8](https://github.com/dropseed/plain/commit/786b95bef8), [76dfd477d2](https://github.com/dropseed/plain/commit/76dfd477d2))
+- Renamed X-Forwarded settings: `USE_X_FORWARDED_HOST` → `HTTP_X_FORWARDED_HOST`, `USE_X_FORWARDED_PORT` → `HTTP_X_FORWARDED_PORT`, `USE_X_FORWARDED_FOR` → `HTTP_X_FORWARDED_FOR` ([22f241a55c](https://github.com/dropseed/plain/commit/22f241a55c))
+- Changed `HTTPS_PROXY_HEADER` from a tuple to a string format (e.g., `"X-Forwarded-Proto: https"`) ([7ac2a431b6](https://github.com/dropseed/plain/commit/7ac2a431b6))
+
+### Upgrade instructions
+
+- Replace Response class imports and usages:
+    - `ResponseRedirect` → `RedirectResponse`
+    - `ResponseNotModified` → `NotModifiedResponse`
+    - `ResponseNotAllowed` → `NotAllowedResponse`
+    - `ResponseNotFound` → `Response(status_code=404)`
+    - `ResponseForbidden` → `Response(status_code=403)`
+    - `ResponseBadRequest` → `Response(status_code=400)`
+    - `ResponseGone` → `Response(status_code=410)`
+    - `ResponseServerError` → `Response(status_code=500)`
+- Replace exception imports and usages:
+    - `Http404` → `NotFoundError404`
+    - `PermissionDenied` → `ForbiddenError403`
+    - `BadRequest` → `BadRequestError400`
+    - `SuspiciousOperation` → `SuspiciousOperationError400`
+    - `SuspiciousMultipartForm` → `SuspiciousMultipartFormError400`
+    - `SuspiciousFileOperation` → `SuspiciousFileOperationError400`
+    - `TooManyFieldsSent` → `TooManyFieldsSentError400`
+    - `TooManyFilesSent` → `TooManyFilesSentError400`
+    - `RequestDataTooBig` → `RequestDataTooBigError400`
+- Replace `request.meta` with `request.environ`
+- Rename X-Forwarded settings in your configuration:
+    - `USE_X_FORWARDED_HOST` → `HTTP_X_FORWARDED_HOST`
+    - `USE_X_FORWARDED_PORT` → `HTTP_X_FORWARDED_PORT`
+    - `USE_X_FORWARDED_FOR` → `HTTP_X_FORWARDED_FOR`
+- Update `HTTPS_PROXY_HEADER` from tuple format to string format:
+
+    ```python
+    # Before
+    HTTPS_PROXY_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
+
+    # After
+    HTTPS_PROXY_HEADER = "X-Forwarded-Proto: https"
+    ```
+
+- Replace `plain setting <name>` command with `plain settings get <name>`
+
+## [0.95.0](https://github.com/dropseed/plain/releases/plain@0.95.0) (2025-12-22)
+
+### What's changed
+
+- Improved thread worker server shutdown behavior with `cancel_futures=True` for faster and cleaner process termination ([72d0620](https://github.com/dropseed/plain/commit/72d0620094))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.94.0](https://github.com/dropseed/plain/releases/plain@0.94.0) (2025-12-12)
+
+### What's changed
+
+- `FormFieldMissingError` exceptions are now automatically converted to HTTP 400 Bad Request responses with a warning log instead of causing a 500 error ([b38f6e5](https://github.com/dropseed/plain/commit/b38f6e50db))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.93.1](https://github.com/dropseed/plain/releases/plain@0.93.1) (2025-12-09)
+
+### What's changed
+
+- Added type annotation for `request.unique_id` attribute to improve IDE support and type checking ([23af501](https://github.com/dropseed/plain/commit/23af501d09))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.93.0](https://github.com/dropseed/plain/releases/plain@0.93.0) (2025-12-04)
+
+### What's changed
+
+- Improved type annotations across forms, HTTP handling, logging, and other core modules for better IDE support and type checking ([ac1eeb0](https://github.com/dropseed/plain/commit/ac1eeb0ea0))
+- Internal refactor of `TimestampSigner` to use composition instead of inheritance from `Signer`, maintaining the same public API ([ac1eeb0](https://github.com/dropseed/plain/commit/ac1eeb0ea0))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.92.0](https://github.com/dropseed/plain/releases/plain@0.92.0) (2025-12-01)
+
+### What's changed
+
+- Added `request.client_ip` property to get the client's IP address, with support for `X-Forwarded-For` header when behind a trusted proxy ([cb0bc5d](https://github.com/dropseed/plain/commit/cb0bc5d08f))
+- Added `USE_X_FORWARDED_FOR` setting to enable reading client IP from `X-Forwarded-For` header ([cb0bc5d](https://github.com/dropseed/plain/commit/cb0bc5d08f))
+- Improved `print_event` CLI output styling with dimmed text for less visual noise ([b09edfd](https://github.com/dropseed/plain/commit/b09edfd2a1))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.91.0](https://github.com/dropseed/plain/releases/plain@0.91.0) (2025-11-24)
+
+### What's changed
+
+- Request body parsing refactored: the `request.data` attribute has been replaced with `request.json_data` and `request.form_data` for explicit content-type handling ([90332a9](https://github.com/dropseed/plain/commit/90332a9c21))
+- `QueryDict` now has proper type annotations for `get()`, `pop()`, `getlist()`, and `__getitem__()` methods that reflect string return types ([90332a9](https://github.com/dropseed/plain/commit/90332a9c21))
+- Forms now automatically select between `json_data` and `form_data` based on request content-type ([90332a9](https://github.com/dropseed/plain/commit/90332a9c21))
+- View mixins `ObjectTemplateViewMixin` removed in favor of class inheritance for better typing - `UpdateView` and `DeleteView` now inherit from `DetailView` ([569afd6](https://github.com/dropseed/plain/commit/569afd606d))
+- `AppLogger` context logging now uses a `context` dict parameter instead of `**kwargs` for better type checking ([581b406](https://github.com/dropseed/plain/commit/581b4060d3))
+- Removed erroneous `AuthViewMixin` export from `plain.views` ([334bbb6](https://github.com/dropseed/plain/commit/334bbb6e7a))
+
+### Upgrade instructions
+
+- Replace `request.data` with the appropriate method:
+    - For JSON requests: use `request.json_data` (returns a dict, raises `BadRequest` for invalid JSON)
+    - For form data: use `request.form_data` (returns a `QueryDict`)
+- Update `app_logger` calls that pass context as kwargs to use the `context` parameter:
+
+    ```python
+    # Before
+    app_logger.info("Message", user_id=123, action="login")
+
+    # After
+    app_logger.info("Message", context={"user_id": 123, "action": "login"})
+    ```
+
+## [0.90.0](https://github.com/dropseed/plain/releases/plain@0.90.0) (2025-11-20)
+
+### What's changed
+
+- Improved type annotations in `timezone.py`: `is_aware()` and `is_naive()` now accept both `datetime` and `time` objects for more flexible type checking ([a43145e](https://github.com/dropseed/plain/commit/a43145e697))
+- Enhanced type annotations in view classes: `convert_value_to_response()` and handler result variables now use more explicit type hints for better IDE support ([dc4454e](https://github.com/dropseed/plain/commit/dc4454e196))
+- Fixed type errors in forms and server workers: URL field now handles bytes properly, and worker wait_fds has explicit type annotation ([fc98d66](https://github.com/dropseed/plain/commit/fc98d666d4))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.89.0](https://github.com/dropseed/plain/releases/plain@0.89.0) (2025-11-14)
+
+### What's changed
+
+- Improved type annotations in view classes: `url_args`, `url_kwargs`, and various template/form context dictionaries now have more specific type hints for better IDE support and type checking ([83bcb95](https://github.com/dropseed/plain/commit/83bcb95b09))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.88.0](https://github.com/dropseed/plain/releases/plain@0.88.0) (2025-11-13)
+
+### What's changed
+
+- The `plain.forms` module now uses explicit imports instead of wildcard imports, improving IDE autocomplete and type checking support ([eff36f3](https://github.com/dropseed/plain/commit/eff36f31e8e15f84e11164a44c833aeab096ffbd))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.87.0](https://github.com/dropseed/plain/releases/plain@0.87.0) (2025-11-12)
+
+### What's changed
+
+- Internal classes now use abstract base classes with `@abstractmethod` decorators instead of raising `NotImplementedError`, improving type checking and IDE support ([91b329a](https://github.com/dropseed/plain/commit/91b329a8adb477031c4358e638b12f35f19bb85d), [81b5f88](https://github.com/dropseed/plain/commit/81b5f88a4bd39785f6b19c3c00c0ed23a36fb72f), [d2e2423](https://github.com/dropseed/plain/commit/d2e24235f497a92f45d5a21fc83d802897c2dec0), [61e7b5a](https://github.com/dropseed/plain/commit/61e7b5a0c8675aaaf65f0a626ff7959a786dca7f))
+- Updated to latest version of `ty` type checker and fixed type errors and warnings throughout the codebase ([f4dbcef](https://github.com/dropseed/plain/commit/f4dbcefa929058be517cb1d4ab35bd73a89f26b8))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.86.2](https://github.com/dropseed/plain/releases/plain@0.86.2) (2025-11-11)
 
 ### What's changed

{plain-0.86.2 → plain-0.97.0}/plain/assets/views.py

@@ -8,12 +8,13 @@ from io import BytesIO
 
 from plain.http import (
     FileResponse,
-    Http404,
+    NotFoundError404,
+    NotModifiedResponse,
+    RedirectResponse,
     Response,
-    ResponseNotModified,
-    ResponseRedirect,
     StreamingResponse,
 )
+from plain.http.response import ResponseHeaders
 from plain.runtime import settings
 from plain.urls import reverse
 from plain.views import View
@@ -34,12 +35,15 @@ class AssetView(View):
         # Allow a path to be passed in AssetView.as_view(path="...")
         self.asset_path = asset_path
 
-    def get_url_path(self) -> str:
+    def get_url_path(self) -> str | None:
         return self.asset_path or self.url_kwargs["path"]
 
-    def get(self) -> Response | FileResponse:
+    def get(self) -> Response | FileResponse | StreamingResponse:
         url_path = self.get_url_path()
 
+        if not url_path:
+            raise NotFoundError404("Asset path not found")
+
         # Make a trailing slash work, but we don't expect it
         url_path = url_path.rstrip("/")
 
@@ -52,7 +56,11 @@ class AssetView(View):
                 if redirect_response := self.get_redirect_response(url_path):
                     return redirect_response
 
+        # check_asset_path validates and raises if path is invalid
+        # After this point, absolute_path is guaranteed to be a valid str
         self.check_asset_path(absolute_path)
+        # Type guard: absolute_path is now str (check_asset_path raises if None/invalid)
+        assert absolute_path is not None
 
         if encoded_path := self.get_encoded_path(absolute_path):
             absolute_path = encoded_path
@@ -80,7 +88,7 @@ class AssetView(View):
 
         # Make sure we don't try to escape the compiled assests path
         if not os.path.commonpath([compiled_path, asset_path]) == compiled_path:
-            raise Http404("Asset not found")
+            raise NotFoundError404("Asset not found")
 
         return asset_path
 
@@ -93,13 +101,13 @@ class AssetView(View):
 
     def check_asset_path(self, path: str | None) -> None:
         if not path:
-            raise Http404("Asset not found")
+            raise NotFoundError404("Asset not found")
 
         if not os.path.exists(path):
-            raise Http404("Asset not found")
+            raise NotFoundError404("Asset not found")
 
         if os.path.isdir(path):
-            raise Http404("Asset is a directory")
+            raise NotFoundError404("Asset is a directory")
 
     @functools.cache
     def get_last_modified(self, path: str) -> str | None:
@@ -117,7 +125,7 @@ class AssetView(View):
         try:
             mtime = os.path.getmtime(path)
         except OSError:
-            mtime = None
+            mtime = 0.0
 
         timestamp = int(mtime)
         size = self.get_size(path)
@@ -127,7 +135,7 @@ class AssetView(View):
     def get_size(self, path: str) -> int:
         return os.path.getsize(path)
 
-    def update_headers(self, headers: dict, path: str) -> dict:
+    def update_headers(self, headers: ResponseHeaders, path: str) -> ResponseHeaders:
         headers.setdefault("Access-Control-Allow-Origin", "*")
 
         # Always vary on Accept-Encoding
@@ -206,7 +214,7 @@ class AssetView(View):
                 return gzip_path
         return None
 
-    def get_redirect_response(self, path: str) -> ResponseRedirect | None:
+    def get_redirect_response(self, path: str) -> RedirectResponse | None:
         """If the asset is not found, try to redirect to the fingerprinted path"""
         fingerprinted_url_path = get_fingerprinted_url_path(path)
 
@@ -219,19 +227,19 @@ class AssetView(View):
 
         namespace = AssetsRouter.namespace
 
-        return ResponseRedirect(
+        return RedirectResponse(
             redirect_to=reverse(f"{namespace}:asset", fingerprinted_url_path),
             headers={
                 "Cache-Control": "max-age=60",  # Can cache this for a short time, but the fingerprinted path can change
             },
         )
 
-    def get_conditional_response(self, path: str) -> ResponseNotModified | None:
+    def get_conditional_response(self, path: str) -> NotModifiedResponse | None:
         """
         Support conditional requests (HTTP 304 response) based on ETag and Last-Modified headers.
         """
         if self.request.headers.get("If-None-Match") == self.get_etag(path):
-            response = ResponseNotModified()
+            response = NotModifiedResponse()
             response.headers = self.update_headers(response.headers, path)
             return response
 
@@ -243,7 +251,7 @@ class AssetView(View):
                 and last_modified
                 and if_modified_since >= last_modified
             ):
-                response = ResponseNotModified()
+                response = NotModifiedResponse()
                 response.headers = self.update_headers(response.headers, path)
                 return response
         return None
@@ -272,7 +280,7 @@ class AssetView(View):
                 status_code=416, headers=[("Content-Range", f"bytes */{file_size}")]
             )
 
-        end = min(end, file_size - 1)
+        end = int(min(end, file_size - 1))
 
         with open(path, "rb") as f:
             f.seek(start)

{plain-0.86.2 → plain-0.97.0}/plain/cli/build.py

@@ -9,6 +9,7 @@ import click
 
 import plain.runtime
 from plain.assets.compile import compile_assets, get_compiled_path
+from plain.cli.print import print_event
 
 
 @click.command()
@@ -54,18 +55,16 @@ def build(keep_original: bool, fingerprint: bool, compress: bool) -> None:
             .get("run", {})
             .items()
         ):
-            click.secho(f"Running {name} from pyproject.toml", bold=True)
+            print_event(f"{name}...")
             result = subprocess.run(data["cmd"], shell=True)
-            print()
             if result.returncode:
                 click.secho(f"Error in {name} (exit {result.returncode})", fg="red")
                 sys.exit(result.returncode)
 
     # Then run installed package build steps (like tailwind, typically should run last...)
     for entry_point in entry_points(group="plain.build"):
-        click.secho(f"Running {entry_point.name}", bold=True)
-        result = entry_point.load()()
-        print()
+        print_event(f"{entry_point.name}...")
+        entry_point.load()()
 
     # Compile our assets
     target_dir = get_compiled_path()

{plain-0.86.2 → plain-0.97.0}/plain/cli/core.py

@@ -9,7 +9,6 @@ from click.core import Command, Context
 import plain.runtime
 from plain.exceptions import ImproperlyConfigured
 
-from .agent import agent
 from .build import build
 from .changelog import changelog
 from .chores import chores
@@ -18,10 +17,12 @@ from .formatting import PlainContext
 from .install import install
 from .preflight import preflight_cli
 from .registry import cli_registry
+from .request import request
 from .scaffold import create
 from .server import server
-from .settings import setting
+from .settings import settings
 from .shell import run, shell
+from .skills import skills
 from .upgrade import upgrade
 from .urls import urls
 from .utils import utils
@@ -32,8 +33,9 @@ def plain_cli() -> None:
     pass
 
 
-plain_cli.add_command(agent)
 plain_cli.add_command(docs)
+plain_cli.add_command(request)
+plain_cli.add_command(skills)
 plain_cli.add_command(preflight_cli)
 plain_cli.add_command(create)
 plain_cli.add_command(chores)
@@ -41,7 +43,7 @@ plain_cli.add_command(build)
 plain_cli.add_command(utils)
 plain_cli.add_command(urls)
 plain_cli.add_command(changelog)
-plain_cli.add_command(setting)
+plain_cli.add_command(settings)
 plain_cli.add_command(shell)
 plain_cli.add_command(run)
 plain_cli.add_command(install)
@@ -61,9 +63,9 @@ class CLIRegistryGroup(click.Group):
     def list_commands(self, ctx: Context) -> list[str]:
         return sorted(cli_registry.get_commands().keys())
 
-    def get_command(self, ctx: Context, name: str) -> Command | None:
+    def get_command(self, ctx: Context, cmd_name: str) -> Command | None:
         commands = cli_registry.get_commands()
-        return commands.get(name)
+        return commands.get(cmd_name)
 
 
 class PlainCommandCollection(click.CommandCollection):

plain-0.97.0/plain/cli/docs.py

@@ -0,0 +1,79 @@
+import importlib.util
+import pkgutil
+from pathlib import Path
+
+import click
+
+from .llmdocs import LLMDocs
+from .output import iterate_markdown
+
+
+@click.command()
+@click.option("--open", is_flag=True, help="Open the README in your default editor")
+@click.option("--source", is_flag=True, help="Include symbolicated source code")
+@click.option("--list", "show_list", is_flag=True, help="List available packages")
+@click.argument("module", default="")
+def docs(module: str, open: bool, source: bool, show_list: bool) -> None:
+    """Show documentation for a package"""
+    if show_list:
+        # List available packages
+        available_packages = []
+        try:
+            import plain
+
+            # Check core plain package (namespace package)
+            plain_spec = importlib.util.find_spec("plain")
+            if plain_spec and plain_spec.submodule_search_locations:
+                available_packages.append("plain")
+
+            # Check other plain.* subpackages
+            if hasattr(plain, "__path__"):
+                for importer, modname, ispkg in pkgutil.iter_modules(
+                    plain.__path__, "plain."
+                ):
+                    if ispkg:
+                        available_packages.append(modname)
+        except Exception:
+            pass
+
+        if available_packages:
+            for pkg in sorted(available_packages):
+                click.echo(f"- {pkg}")
+        else:
+            click.echo("No packages found.")
+        return
+
+    if not module:
+        raise click.UsageError(
+            "You must specify a module. Use --list to see available packages."
+        )
+
+    # Convert hyphens to dots (e.g., plain-models -> plain.models)
+    module = module.replace("-", ".")
+
+    # Automatically prefix if we need to
+    if not module.startswith("plain"):
+        module = f"plain.{module}"
+
+    # Get the module path
+    spec = importlib.util.find_spec(module)
+    if not spec or not spec.origin:
+        raise click.UsageError(f"Module {module} not found")
+
+    module_path = Path(spec.origin).parent
+
+    if source:
+        # Output with symbolicated source
+        source_docs = LLMDocs([module_path])
+        source_docs.load()
+        source_docs.print(relative_to=module_path.parent)
+    else:
+        # Human-readable README output
+        readme_path = module_path / "README.md"
+        if not readme_path.exists():
+            raise click.UsageError(f"README.md not found for {module}")
+
+        if open:
+            click.launch(str(readme_path))
+        else:
+            click.echo_via_pager(iterate_markdown(readme_path.read_text()))

{plain-0.86.2 → plain-0.97.0}/plain/cli/formatting.py

@@ -12,11 +12,13 @@ class PlainHelpFormatter(click.HelpFormatter):
         styled_heading = click.style(heading, dim=True)
         self.write(f"{'':>{self.current_indent}}{styled_heading}\n")
 
-    def write_usage(self, prog: str, args: str = "", prefix: str = "Usage: ") -> None:
+    def write_usage(  # type: ignore[override]
+        self, prog: str, args: str = "", prefix: str = "Usage: "
+    ) -> None:
         prefix_styled = click.style(prefix, dim=True)
         super().write_usage(prog, args, prefix=prefix_styled)
 
-    def write_dl(
+    def write_dl(  # type: ignore[override]
         self,
         rows: list[tuple[str, str]],
         col_max: int = 20,

plain-0.97.0/plain/cli/install.py

@@ -0,0 +1,38 @@
+import subprocess
+import sys
+
+import click
+
+
+@click.command()
+@click.argument("packages", nargs=-1, required=True)
+def install(packages: tuple[str, ...]) -> None:
+    """Install Plain packages"""
+    # Validate all package names
+    invalid_packages = [pkg for pkg in packages if not pkg.startswith("plain")]
+    if invalid_packages:
+        raise click.UsageError(
+            f"The following packages do not start with 'plain': {', '.join(invalid_packages)}\n"
+            "This command is only for Plain framework packages."
+        )
+
+    # Install all packages
+    if len(packages) == 1:
+        click.secho(f"Installing {packages[0]}...", bold=True)
+    else:
+        click.secho(f"Installing {len(packages)} packages...", bold=True)
+        for pkg in packages:
+            click.secho(f"  - {pkg}")
+        click.echo()
+
+    install_cmd = ["uv", "add"] + list(packages)
+    result = subprocess.run(install_cmd, check=False, stderr=sys.stderr)
+
+    if result.returncode != 0:
+        raise click.ClickException("Failed to install packages")
+
+    click.echo()
+    if len(packages) == 1:
+        click.secho(f"{packages[0]} installed successfully", fg="green")
+    else:
+        click.secho(f"{len(packages)} packages installed successfully", fg="green")

{plain-0.86.2/plain/cli/agent → plain-0.97.0/plain/cli}/llmdocs.py

@@ -26,7 +26,7 @@ class LLMDocs:
                 self.docs.add(path)
 
         # Exclude "migrations" code from plain apps, except for plain/models/migrations
-        # Also exclude CHANGELOG.md and AGENTS.md
+        # Also exclude CHANGELOG.md, AGENTS.md, and skills directory
         self.docs = {
             doc
             for doc in self.docs
@@ -35,6 +35,7 @@ class LLMDocs:
                 and "/plain/models/migrations/" not in str(doc)
             )
             and doc.name not in ("CHANGELOG.md", "AGENTS.md")
+            and "/skills/" not in str(doc)
         }
         self.sources = {
             source
@@ -44,6 +45,7 @@ class LLMDocs:
                 and "/plain/models/migrations/" not in str(source)
             )
             and source.name != "cli.py"
+            and "/skills/" not in str(source)
         }
 
         self.docs = sorted(self.docs)

{plain-0.86.2 → plain-0.97.0}/plain/cli/preflight.py

@@ -1,5 +1,6 @@
 import json
 import sys
+from typing import Any
 
 import click
 
@@ -125,12 +126,12 @@ def preflight_cli(deploy: bool, format: str, quiet: bool) -> None:
 
     if format == "json":
         # Build JSON output
-        results = {"passed": not has_errors, "checks": []}
+        results: dict[str, Any] = {"passed": not has_errors, "checks": []}
 
         for check_class, check_name, issues in check_results:
             visible_issues = [issue for issue in issues if not issue.is_silenced()]
 
-            check_result = {
+            check_result: dict[str, Any] = {
                 "name": check_name,
                 "passed": len(visible_issues) == 0,
                 "issues": [],

plain-0.97.0/plain/cli/print.py

@@ -0,0 +1,9 @@
+import click
+
+
+def print_event(msg: str, newline: bool = True) -> None:
+    arrow = click.style("-->", fg=214, bold=True, dim=True)
+    message = click.style(msg, dim=True)
+    if not newline:
+        message += " "
+    click.echo(f"{arrow} {message}", nl=newline)

{plain-0.86.2/plain/cli/agent → plain-0.97.0/plain/cli}/request.py

@@ -49,7 +49,7 @@ def request(
     content_type: str | None,
     headers: tuple[str, ...],
 ) -> None:
-    """Make an HTTP test request against the dev database"""
+    """Make HTTP requests against the dev database"""
 
     try:
         # Only allow in DEBUG mode for security
@@ -98,7 +98,7 @@ def request(
 
         # Make the request
         method = method.upper()
-        kwargs: dict[str, object] = {
+        kwargs: dict[str, Any] = {
             "follow": follow,
         }
         if header_dict:

{plain-0.86.2 → plain-0.97.0}/plain/cli/runtime.py

@@ -24,7 +24,7 @@ def without_runtime_setup(f: F) -> F:
         def server(**options):
             ...
     """
-    f.without_runtime_setup = True  # type: ignore[attr-defined]  # dynamic attribute for decorator
+    f.without_runtime_setup = True  # dynamic attribute for decorator
     return f
 
 
@@ -41,5 +41,5 @@ def common_command(f: F) -> F:
         def dev(**options):
             ...
     """
-    f.is_common_command = True  # type: ignore[attr-defined]  # dynamic attribute for decorator
+    f.is_common_command = True  # dynamic attribute for decorator
     return f