π« Toolkit to help you get started with SDD or any other process!
"""CLI adapter for ``specify event run``."""
from __future__ import annotations
from pathlib import Path
import sys
import typer
from . import event_app
@event_app.command("run")
def event_run(
command_name: str = typer.Argument(..., help="Name of the command to execute"),
event_name: str = typer.Argument(..., help="Canonical event name (e.g., session_start)"),
timeout: int = typer.Argument(
120, help="Per-handler timeout in seconds (passed through from the native hook config)"
),
):
"""Resolve and run an event-driven command script with stdin payload."""
from . import resolve_and_run_event_command
# Read payload from stdin if available (capped at 1 MiB to prevent DoS).
MAX_STDIN_BYTES = 1 * 1024 * 1024
if not sys.stdin.isatty():
# Read from the underlying binary buffer so the cap counts encoded
# bytes, not decoded characters β `sys.stdin.read()` on a text stream
# counts Unicode characters, which lets multibyte payloads (e.g. a
# few hundred thousand emoji) exceed 1 MiB on the wire while still
# passing the length check. Reading one byte past the cap tells us
# whether more data was waiting beyond it.
raw = sys.stdin.buffer.read(MAX_STDIN_BYTES + 1)
if len(raw) > MAX_STDIN_BYTES:
typer.echo(
"stdin payload exceeds 1 MiB limit; "
"truncate or pipe a smaller payload",
err=True,
)
raise typer.Exit(code=1)
try:
payload = raw.decode("utf-8")
except UnicodeDecodeError:
typer.echo("stdin payload must be valid UTF-8", err=True)
raise typer.Exit(code=1) from None
else:
payload = "{}"
# Run the event command
project_root = Path.cwd() # The agent runs events from project root
from .._project import (
ProjectResolutionError,
preflight_project_policy,
render_project_error,
)
try:
preflight_project_policy(project_root)
except ProjectResolutionError as exc:
render_project_error(exc)
exit_code = resolve_and_run_event_command(
command_name, event_name, payload, project_root, timeout=timeout
)
raise typer.Exit(code=exit_code)