kd-cli 2.2.0__tar.gz → 2.2.1__tar.gz

{kd_cli-2.2.0/kd_cli.egg-info → kd_cli-2.2.1}/PKG-INFO

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

{kd_cli-2.2.0 → kd_cli-2.2.1}/kd/cli/main.py

@@ -30,6 +30,7 @@ from kd.config import ResolvedConfig, resolve_command_defaults, resolve_config
 from kd.connection import ConnectionContext, resolve_connection
 from kd.debug import DebugLevel, DebugLog, init_debug_log
 from kd.exceptions import KdError
+from kd.operating_guide import load_guide
 
 # Global options — single source of truth for extraction, help, and reference.
 GLOBAL_OPTIONS: list[OptionDeclaration] = [
@@ -54,6 +55,13 @@ GLOBAL_OPTIONS: list[OptionDeclaration] = [
         type=bool,
         help_text="Print full command reference (LLM-friendly)",
     ),
+    OptionDeclaration(
+        name="guide",
+        short_name="G",
+        layer=OptionLayer.GLOBAL,
+        type=bool,
+        help_text="Print embedded operating guide (LLM-friendly)",
+    ),
     OptionDeclaration(
         name="debug",
         short_name="D",
@@ -158,6 +166,10 @@ def main(argv: list[str] | None = None) -> None:
         print(f"kd {__version__}")
         return
 
+    if global_opts.get("guide"):
+        print(load_guide(), end="")
+        return
+
     # Alias expansion: detect `alias <name>` and expand before parsing.
     # Config is loaded early only when needed; stored for reuse later.
     resolved: ResolvedConfig | None = None

kd_cli-2.2.1/kd/operating_guide.py

@@ -0,0 +1,20 @@
+"""Operating guide loader.
+
+Reads the bundled ``kd/resources/operating-guide.md`` for ``kd --guide``.
+The guide carries durable operating doctrine (product boundary, primer
+workflow, cost classes, YouTrack gotchas) — a complement to the
+syntax-focused ``kd --reference``.
+"""
+
+from __future__ import annotations
+
+import importlib.resources
+
+
+def load_guide() -> str:
+    """Read the bundled operating guide as text."""
+    return (
+        importlib.resources.files("kd.resources")
+        .joinpath("operating-guide.md")
+        .read_text(encoding="utf-8")
+    )

{kd_cli-2.2.0 → kd_cli-2.2.1}/kd/resources/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to kd-cli are recorded here. The project follows [Semantic V
 
 ## [Unreleased]
 
+## [2.2.1] — 2026-04-18
+
+### Added
+- `kd --guide` / `-G` prints an embedded operating guide covering kd's product boundary, primer workflow, cost classes, and YouTrack gotchas — the doctrine complement to the syntax-focused `kd --reference`. Runs without a connection or working config, so it's safe in fresh or broken-config environments (KDCLI-94).
+
 ## [2.2.0] — 2026-04-18
 
 Milestone 006 — tag discovery and taxonomy hygiene v1. Eight sequenced sessions that turn tags into a load-bearing cross-entity discovery primitive: `/issue` tag parity with `/article`, multi-tag intersection on `/tag issues`, the `/tag entities` cross-kind verb, `/tag list --prefix|--namespace` taxonomy introspection, and workspace-pinned tags on the primer consumed as an implicit OR scope.

{kd_cli-2.2.0 → kd_cli-2.2.1/kd_cli.egg-info}/PKG-INFO

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

{kd_cli-2.2.0 → kd_cli-2.2.1}/kd_cli.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ kd/connection.py
 kd/debug.py
 kd/exceptions.py
 kd/history.py
+kd/operating_guide.py
 kd/primer.py
 kd/query_parser.py
 kd/release_notes.py

{kd_cli-2.2.0 → kd_cli-2.2.1}/pyproject.toml

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