kd-cli 2.7.0__tar.gz → 2.7.1__tar.gz

{kd_cli-2.7.0/kd_cli.egg-info → kd_cli-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kd-cli
-Version: 2.7.0
+Version: 2.7.1
 Summary: Knowledge Dispatcher for issue trackers and knowledge bases
 Author: Sergiy Gladkyy
 License-Expression: MIT

{kd_cli-2.7.0 → kd_cli-2.7.1}/kd/cli/namespaces/article/__init__.py

@@ -141,6 +141,7 @@ class ArticleSearchCommand(Command):
             examples=[
                 'kd /article search "project: {Code OnTime} {wix}"',
                 'kd /article search "project: {Intellect Solutions} content: HKEY_LOCAL_MACHINE"',
+                'kd /article search "project: {COT} tag: {kind:proposal}"',
                 'kd /article search "summary: timeout" --limit 10',
             ],
             see_also=["/article list", "/search", "/tag articles"],

{kd_cli-2.7.0 → kd_cli-2.7.1}/kd/client.py

@@ -20,6 +20,7 @@ from __future__ import annotations
 
 import builtins
 import difflib
+import re
 import shlex
 from collections import OrderedDict
 from collections.abc import Callable
@@ -1345,6 +1346,36 @@ def _is_unknown_query_param(exc: APIError) -> bool:
     return ("parameter" in body) and ("unknown" in body or "unrecognized" in body)
 
 
+_TAG_BARE_COLON_LITERAL_RE = re.compile(r"\btag\s*:\s*(?!\{)\S*:\S*")
+
+
+def _is_tag_literal_misparse(exc: APIError, query: str) -> bool:
+    """Heuristic: did YT's article query DSL parse a colon inside a
+    bare ``tag:`` literal as a field separator?
+
+    Two gates, both required:
+
+    1. The 400 body matches the observed phrasing — *"... isn't used
+       for the tag field"* or its non-curly variant.
+    2. The user's *input query* contains a ``tag:`` clause followed
+       by a non-brace token that itself contains a colon. Without
+       this the same upstream phrase fires for legitimate unknown-tag
+       errors (e.g. ``tag: NOPE``), where the brace-wrapping hint
+       would be misleading.
+
+    The regex is intentionally conservative — it does not understand
+    quoted strings or full YT-DSL grammar; that is what the M012
+    verbatim-passthrough contract trades away. False negatives prefer
+    the no-hint path (raw YT message still surfaces) over the noisy
+    false positive of suggesting braces when no colon was typed.
+    """
+    body = (exc.response_body or "").lower()
+    body_match = "isn't used for the tag field" in body or "is not used for the tag field" in body
+    if not body_match:
+        return False
+    return _TAG_BARE_COLON_LITERAL_RE.search(query) is not None
+
+
 class ArticleOperations:
     """High-level knowledge base article operations."""
 
@@ -1392,6 +1423,13 @@ class ArticleOperations:
         except APIError as exc:
             if exc.status_code == 400 and _is_unknown_query_param(exc):
                 raise ValidationError(_CAPABILITY_MISSING_MSG) from exc
+            if exc.status_code == 400 and _is_tag_literal_misparse(exc, query):
+                raise ValidationError(
+                    f"{exc}\n"
+                    "Hint: tag names with colons need brace wrapping in YouTrack "
+                    "query syntax — use `tag: {kind:proposal}`, not "
+                    "`tag: kind:proposal`. See `kd --guide` §YouTrack Gotchas."
+                ) from exc
             if exc.status_code == 400:
                 raise ValidationError(str(exc)) from exc
             raise

{kd_cli-2.7.0 → kd_cli-2.7.1}/kd/resources/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to kd-cli are recorded here. The project follows [Semantic V
 
 ## [Unreleased]
 
+## [2.7.1] — 2026-05-02
+
+### Fixed
+- `kd /article search` now appends a brace-wrapping hint when YouTrack returns
+  the *"… isn't used for the tag field"* 400 caused by a bare colon-bearing
+  `tag:` literal (e.g. `tag: kind:proposal`). The upstream message stays
+  visible; kd points to the fix — `tag: {kind:proposal}` — and references
+  `kd --guide` §YouTrack Gotchas. Docs and `kd /article search --help` now
+  show the brace form (KDCLI-186).
+
 ## [2.7.0] — 2026-05-02
 
 This release adds server-backed full-text search for knowledge-base

{kd_cli-2.7.0 → kd_cli-2.7.1}/kd/resources/operating-guide.md

@@ -112,7 +112,7 @@ YouTrack's article query API is undocumented but supported on the YT tiers kd ta
 
 Saved queries are YouTrack issue-search objects. `/query issues` executes them directly. `/query articles` only translates supported `project:` and `tag:` fields into article scans; issue-specific fields such as state or assignee are rejected for articles.
 
-Tag names with colons or spaces need YouTrack query literal handling. `tag: type:case` is wrong; YouTrack reads `type` as the tag value and `case` as another field. Use `tag: {type:case}` in hand-written queries. kd command paths that compose tag queries use the shared literal helper.
+Tag names with colons or spaces need YouTrack query literal handling in both issue and article queries (the article query DSL is the same syntax family). `tag: type:case` is wrong; YouTrack reads `type` as the tag value and `case` as another field. Use `tag: {type:case}` in hand-written queries — for `/issue list --query` and `/article search` alike. kd command paths that compose tag queries use the shared literal helper; `/article search` preserves the YouTrack 400 and appends a brace-wrapping hint when a bare colon-bearing `tag:` literal trips the misparse.
 
 Repeated same-field clauses in YouTrack query syntax default to OR. `tag: A tag: B` matches either tag. kd multi-tag issue operations join tag clauses with explicit `and` when intersection is required.
 

{kd_cli-2.7.0 → kd_cli-2.7.1/kd_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kd-cli
-Version: 2.7.0
+Version: 2.7.1
 Summary: Knowledge Dispatcher for issue trackers and knowledge bases
 Author: Sergiy Gladkyy
 License-Expression: MIT

{kd_cli-2.7.0 → kd_cli-2.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kd-cli"
-version = "2.7.0"
+version = "2.7.1"
 description = "Knowledge Dispatcher for issue trackers and knowledge bases"
 readme = "README.md"
 requires-python = ">=3.11"