0.3.1: catch ValueError in CLI main so size-limit errors render cleanly

Oversized title/body on `send` or `reply` raised an uncaught
ValueError from `_validate_lengths`, printing a full Python traceback
instead of a friendly "error: body exceeds 1400 chars (N)" message.
`main()` now catches ValueError alongside RuntimeError.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: jwesleye

.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Asynchronous 1-to-1 postcard messaging between AI agent sessions via a Git-backed ledger",
-    "version": "0.3.0"
+    "version": "0.3.1"
   },
   "plugins": [
     {
       "name": "postcard",
       "source": "./",
       "description": "Postcard protocol for cross-session AI agent messaging. Ships a CLI, slash commands, a model-invoked skill, a Clerk subagent for inbox triage, and SessionStart / Stop / UserPromptSubmit hooks.",
-      "version": "0.3.0",
+      "version": "0.3.1",
       "license": "MIT",
       "repository": "https://github.com/Open-Agent-Tools/Postcard",
       "keywords": ["messaging", "agents", "ledger", "git", "async", "multi-agent"]

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "postcard",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Asynchronous 1-to-1 postcard messaging between AI agent sessions via a Git-backed ledger.",
   "author": {
     "name": "Open Agent Tools"

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to oat-postcard. Dates are UTC.
 
+## [0.3.1] - 2026-04-22
+
+### Fixed
+- CLI no longer crashes with a Python traceback when `send` or `reply`
+  is called with an oversized title (>140) or body (>1400). The
+  underlying `ValueError` is now caught by `main()` and rendered as a
+  clean `error: body exceeds 1400 chars (1823)` message with exit
+  code 1. Same fix covers any other `ValueError` that bubbles up from
+  CLI commands.
+
 ## [0.3.0] - 2026-04-22
 
 ### Added

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oat-postcard"
-version = "0.3.0"
+version = "0.3.1"
 description = "Asynchronous 1-to-1 postcard messaging between AI agent sessions via a Git-backed ledger."
 readme = "README.md"
 license = { text = "MIT" }

src/oat_postcard/__init__.py

@@ -1 +1 @@
-__version__ = "0.3.0"
+__version__ = "0.3.1"

src/oat_postcard/cli.py

@@ -442,7 +442,7 @@ def main(argv: list[str] | None = None) -> int:
     args = build_parser().parse_args(argv)
     try:
         return args.func(args)
-    except RuntimeError as e:
+    except (RuntimeError, ValueError) as e:
         print(f"error: {e}", file=sys.stderr)
         return 1
 

tests/test_cli.py

@@ -111,3 +111,22 @@ def test_log_rejects_bad_time_spec(tmp_root, session_env, capsys):
     rc = cli.main(["log", "--since", "not a real duration"])
     assert rc == 2
     assert "invalid time spec" in capsys.readouterr().err
+
+
+def test_send_oversized_body_returns_clean_error(tmp_root, session_env, capsys):
+    session.init_session()
+    big = "x" * (ledger.BODY_MAX + 1)
+    rc = cli.main(["send", "peer", "short title", big])
+    assert rc == 1
+    err = capsys.readouterr().err
+    assert "body exceeds" in err
+    assert "Traceback" not in err
+
+
+def test_send_oversized_title_returns_clean_error(tmp_root, session_env, capsys):
+    session.init_session()
+    rc = cli.main(["send", "peer", "x" * (ledger.TITLE_MAX + 1), "body"])
+    assert rc == 1
+    err = capsys.readouterr().err
+    assert "title exceeds" in err
+    assert "Traceback" not in err