Merge branch 'feat/v2.18.1-mcp-slug-docs' for v2.18.1 release
Build Container / build (push) Successful in 9m29s

This commit is contained in:
Phil committed 2026-11-12 13:18:52 -07:00
commit 7158713a2a
4 files changed
+22 -5

No files matched your search

+6
View File
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased] ## [Unreleased]
## [2.18.1] - 2026-11-12
### Changed
- The MCP `create_note` tool says that articles live at `/article/<slug>` with a slug made from the title, so AI clients leave `slug` out unless they want a specific one
## [2.18.0] - 2026-11-12 ## [2.18.0] - 2026-11-12
A tidier admin area. A tidier admin area.
@@ -0,0 +1,9 @@
# v2.18.1: MCP create_note describes article URLs and slugs
Documentation-only follow-up to ADR-077 (v2.17.x). The MCP `create_note`
tool description now says that a title makes the post an article at
`/article/<slug>`, that articles get their slug from the title and other
notes from the time, and that `slug` is only needed for a specific slug.
AI clients read tool descriptions to decide which arguments to send, so
this keeps them from making up a slug the title would already give.
No behaviour change.
+2 -2
View File
@@ -468,5 +468,5 @@ def create_app(config=None):
# Package version (Semantic Versioning 2.0.0) # Package version (Semantic Versioning 2.0.0)
# See docs/standards/versioning-strategy.md for details # See docs/standards/versioning-strategy.md for details
__version__ = "2.18.0" __version__ = "2.18.1"
__version_info__ = (2, 18, 0) __version_info__ = (2, 18, 1)
+5 -3
View File
@@ -232,9 +232,11 @@ def register_tools(server: MCPServer, app: Flask) -> None:
) -> dict: ) -> dict:
"""Create a note (Markdown). It is a draft unless draft is false; """Create a note (Markdown). It is a draft unless draft is false;
publishing makes it public and crossposts it to the syndicate_to publishing makes it public and crossposts it to the syndicate_to
targets. A title makes it an article; summary is its short summary, targets. A title makes it an article, at /article/<slug>; summary is its
shown on the homepage and in feeds and crossposts. At most one of like_of, short summary, shown on the homepage and in feeds and crossposts. The
repost_of and bookmark_of. published_at is an ISO 8601 date.""" slug is made from the title for articles and from the time for other
notes, so leave slug out unless a specific one is wanted. At most one of
like_of, repost_of and bookmark_of. published_at is an ISO 8601 date."""
info = _token_info() info = _token_info()
_require(info, "create", "draft") _require(info, "create", "draft")