ssot-cli 0.1.10.dev1__tar.gz → 0.1.11__tar.gz

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-cli
-Version: 0.1.10.dev1
+Version: 0.1.11
 Summary: Primary CLI distribution for ssot-registry.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -24,9 +24,9 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Utilities
 Requires-Python: <3.14,>=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: ssot-contracts<0.3.0,>=0.2.16.dev1
-Requires-Dist: ssot-core<0.3.0,>=0.2.16.dev1
-Requires-Dist: ssot-conformance<0.3.0,>=0.2.16.dev1
+Requires-Dist: ssot-contracts<0.3.0,>=0.2.17
+Requires-Dist: ssot-core<0.3.0,>=0.2.17
+Requires-Dist: ssot-conformance<0.3.0,>=0.2.17
 Requires-Dist: tomli>=2.0.1; python_version < "3.11"
 
 <div align="center">

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/pyproject.toml

@@ -4,16 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssot-cli"
-version = "0.1.10.dev1"
+version = "0.1.11"
 description = "Primary CLI distribution for ssot-registry."
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 license = "Apache-2.0"
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 dependencies = [
-  "ssot-contracts>=0.2.16.dev1,<0.3.0",
-  "ssot-core>=0.2.16.dev1,<0.3.0",
-  "ssot-conformance>=0.2.16.dev1,<0.3.0",
+  "ssot-contracts>=0.2.17,<0.3.0",
+  "ssot-core>=0.2.17,<0.3.0",
+  "ssot-conformance>=0.2.17,<0.3.0",
   "tomli>=2.0.1; python_version < '3.11'",
 ]
 keywords = ["ssot", "cli", "registry", "governance", "release-management", "validation", "developer-tools"]

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/boundary_cmd.py

@@ -15,7 +15,7 @@ from ssot_registry.api import (
     run_boundary_tests,
     update_entity,
 )
-from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, compact_dict
+from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, compact_dict, load_text_argument
 
 
 def register_boundary(subparsers: argparse._SubParsersAction) -> None:
@@ -30,6 +30,8 @@ def register_boundary(subparsers: argparse._SubParsersAction) -> None:
     add_path_argument(create)
     create.add_argument("--id", required=True, help="Normalized boundary id to create.")
     create.add_argument("--title", required=True, help="Human-readable boundary title.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the boundary.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the boundary body.")
     create.add_argument("--status", choices=["draft", "active", "frozen", "retired"], default="draft", help="Current lifecycle state of the boundary.")
     add_optional_bool_argument(create, "--frozen", default=False, help_text="Record whether the boundary contents are locked against further scope edits.")
     create.add_argument("--feature-ids", nargs="*", default=[], help="Direct feature ids included in the scoped delivery unit.")
@@ -50,6 +52,8 @@ def register_boundary(subparsers: argparse._SubParsersAction) -> None:
     add_path_argument(update)
     update.add_argument("--id", required=True, help="Boundary id to update.")
     update.add_argument("--title", default=None, help="Replacement boundary title.")
+    update.add_argument("--body", default=None, help="Replacement longer-form boundary narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement boundary body.")
     update.add_argument("--status", choices=["draft", "active", "frozen", "retired"], default=None, help="Updated lifecycle state.")
     add_optional_bool_argument(update, "--frozen", default=None, help_text="Change whether the boundary is locked against scope edits.")
     update.set_defaults(func=run_update)
@@ -101,9 +105,11 @@ def register_boundary(subparsers: argparse._SubParsersAction) -> None:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="boundary")
     row = {
         "id": args.id,
         "title": args.title,
+        "body": body,
         "status": args.status,
         "frozen": args.frozen,
         "feature_ids": args.feature_ids,
@@ -121,7 +127,8 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
-    changes = compact_dict({"title": args.title, "status": args.status, "frozen": args.frozen})
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="boundary")
+    changes = compact_dict({"title": args.title, "body": body, "status": args.status, "frozen": args.frozen})
     if not changes:
         raise ValueError("At least one update field is required")
     return update_entity(args.path, "boundaries", args.id, changes)

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/claim_cmd.py

@@ -14,7 +14,7 @@ from ssot_registry.api import (
     unlink_entities,
     update_entity,
 )
-from ssot_cli.common import add_ids_argument, add_path_argument, collect_list_fields, compact_dict
+from ssot_cli.common import add_ids_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -40,6 +40,8 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     create.add_argument("--tier", choices=["T0", "T1", "T2", "T3", "T4"], default="T0", help="Assurance tier required for the claim.")
     create.add_argument("--kind", required=True, help="Operator-defined claim category.")
     create.add_argument("--description", default="", help="What the claim asserts and why it matters.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the claim.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the claim body.")
     create.add_argument("--feature-ids", nargs="*", default=[], help="Feature ids the claim is about.")
     create.add_argument("--test-ids", nargs="*", default=[], help="Test ids that support the claim.")
     create.add_argument("--evidence-ids", nargs="*", default=[], help="Evidence ids that substantiate the claim.")
@@ -61,6 +63,8 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     update.add_argument("--title", default=None, help="Replacement claim title.")
     update.add_argument("--kind", default=None, help="Updated claim category.")
     update.add_argument("--description", default=None, help="Replacement claim description.")
+    update.add_argument("--body", default=None, help="Replacement longer-form claim narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement claim body.")
     update.set_defaults(func=run_update)
 
     delete = claim_sub.add_parser("delete", help="Delete a claim.", description="Remove a claim record from the registry.")
@@ -110,6 +114,7 @@ def _build_links(args: argparse.Namespace) -> dict[str, list[str]]:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="claim")
     row = {
         "id": args.id,
         "title": args.title,
@@ -117,6 +122,7 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
         "tier": args.tier,
         "kind": args.kind,
         "description": args.description,
+        "body": body,
         "feature_ids": args.feature_ids,
         "test_ids": args.test_ids,
         "evidence_ids": args.evidence_ids,
@@ -133,7 +139,8 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
-    changes = compact_dict({"title": args.title, "kind": args.kind, "description": args.description})
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="claim")
+    changes = compact_dict({"title": args.title, "kind": args.kind, "description": args.description, "body": body})
     if not changes:
         raise ValueError("At least one update field is required")
     return update_entity(args.path, "claims", args.id, changes)

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/common.py

@@ -68,3 +68,18 @@ def load_json_object_argument(
     if not isinstance(payload, dict):
         raise ValueError(f"{label} must decode to a JSON object")
     return payload
+
+
+def load_text_argument(
+    *,
+    inline_value: str | None,
+    file_value: str | None,
+    label: str,
+) -> str | None:
+    if inline_value is None and file_value is None:
+        return None
+    if inline_value is not None and file_value is not None:
+        raise ValueError(f"{label} accepts only one of body or body_file")
+    if file_value is not None:
+        return Path(file_value).read_text(encoding="utf-8-sig")
+    return inline_value

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/evidence_cmd.py

@@ -12,7 +12,7 @@ from ssot_registry.api import (
     update_entity,
     verify_evidence_rows,
 )
-from ssot_cli.common import add_ids_argument, add_path_argument, collect_list_fields, compact_dict
+from ssot_cli.common import add_ids_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -36,6 +36,8 @@ def register_evidence(subparsers: argparse._SubParsersAction) -> None:
     create.add_argument("--status", choices=["planned", "collected", "passed", "failed", "stale"], default="planned", help="Current freshness or outcome state of the evidence artifact.")
     create.add_argument("--kind", required=True, help="Operator-defined evidence category such as report, bundle, or log.")
     create.add_argument("--tier", choices=["T0", "T1", "T2", "T3", "T4"], default="T0", help="Assurance tier the evidence contributes toward.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the evidence row.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the evidence body.")
     create.add_argument("--evidence-path", dest="evidence_path", required=True, help="Repository-relative location of the evidence artifact.")
     create.add_argument("--claim-ids", nargs="*", default=[], help="Claim ids supported by the evidence.")
     create.add_argument("--test-ids", nargs="*", default=[], help="Test ids associated with the evidence.")
@@ -58,6 +60,8 @@ def register_evidence(subparsers: argparse._SubParsersAction) -> None:
     update.add_argument("--status", choices=["planned", "collected", "passed", "failed", "stale"], default=None, help="Updated freshness or outcome state.")
     update.add_argument("--kind", default=None, help="Updated evidence category.")
     update.add_argument("--tier", choices=["T0", "T1", "T2", "T3", "T4"], default=None, help="Updated assurance tier contribution.")
+    update.add_argument("--body", default=None, help="Replacement longer-form evidence narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement evidence body.")
     update.add_argument("--evidence-path", dest="evidence_path", default=None, help="Updated repository-relative path to the artifact.")
     update.set_defaults(func=run_update)
 
@@ -94,12 +98,14 @@ def _build_links(args: argparse.Namespace) -> dict[str, list[str]]:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="evidence")
     row = {
         "id": args.id,
         "title": args.title,
         "status": args.status,
         "kind": args.kind,
         "tier": args.tier,
+        "body": body,
         "path": args.evidence_path,
         "claim_ids": args.claim_ids,
         "test_ids": args.test_ids,
@@ -116,12 +122,14 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="evidence")
     changes = compact_dict(
         {
             "title": args.title,
             "status": args.status,
             "kind": args.kind,
             "tier": args.tier,
+            "body": body,
             "path": args.evidence_path,
         }
     )

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/feature_cmd.py

@@ -20,7 +20,7 @@ from ssot_registry.api import (
     unlink_entities,
     update_entity,
 )
-from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict
+from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -48,6 +48,8 @@ def register_feature(subparsers: argparse._SubParsersAction) -> None:
     create.add_argument("--id", required=True, help="Normalized feature id to create.")
     create.add_argument("--title", required=True, help="Human-readable feature title.")
     create.add_argument("--description", default="", help="Operator-facing summary of the feature's purpose.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the feature.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the feature body.")
     create.add_argument("--implementation-status", choices=sorted(FEATURE_IMPLEMENTATION_STATUSES), default="absent", help="Current implementation state in the codebase.")
     create.add_argument("--lifecycle-stage", choices=sorted(FEATURE_LIFECYCLE_STAGES), default="active", help="Actual lifecycle state of the feature today.")
     create.add_argument("--replacement-feature-id", nargs="*", default=[], help="Replacement feature ids if this feature is being deprecated or removed.")
@@ -78,6 +80,8 @@ def register_feature(subparsers: argparse._SubParsersAction) -> None:
     update.add_argument("--id", required=True, help="Feature id to update.")
     update.add_argument("--title", default=None, help="Replacement feature title.")
     update.add_argument("--description", default=None, help="Replacement feature description.")
+    update.add_argument("--body", default=None, help="Replacement longer-form feature narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement feature body.")
     update.add_argument("--implementation-status", choices=sorted(FEATURE_IMPLEMENTATION_STATUSES), default=None, help="Updated implementation state in the codebase.")
     update.set_defaults(func=run_update)
 
@@ -149,6 +153,7 @@ def _build_links(args: argparse.Namespace) -> dict[str, list[str]]:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="feature")
     plan = {
         "horizon": args.horizon,
         "slot": args.slot,
@@ -162,6 +167,7 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
         "id": args.id,
         "title": args.title,
         "description": args.description,
+        "body": body,
         "implementation_status": args.implementation_status,
         "lifecycle": {
             "stage": args.lifecycle_stage,
@@ -186,10 +192,12 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="feature")
     changes = compact_dict(
         {
             "title": args.title,
             "description": args.description,
+            "body": body,
             "implementation_status": args.implementation_status,
         }
     )

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/issue_cmd.py

@@ -13,7 +13,7 @@ from ssot_registry.api import (
     unlink_entities,
     update_entity,
 )
-from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict
+from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -40,6 +40,8 @@ def register_issue(subparsers: argparse._SubParsersAction) -> None:
     create.add_argument("--status", choices=["open", "in_progress", "blocked", "resolved", "closed"], default="open", help="Current workflow state of the issue.")
     create.add_argument("--severity", choices=["low", "medium", "high", "critical"], default="medium", help="Operational severity of the issue.")
     create.add_argument("--description", default="", help="Operator-facing problem summary and context.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the issue.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the issue body.")
     create.add_argument("--horizon", choices=["current", "next", "future", "explicit", "backlog", "out_of_bounds"], default="backlog", help="Planning horizon used to schedule the issue.")
     create.add_argument("--slot", default=None, help="Explicit release train, sprint, or slot label when planning explicitly.")
     create.add_argument("--feature-ids", nargs="*", default=[], help="Feature ids affected by the issue.")
@@ -66,6 +68,8 @@ def register_issue(subparsers: argparse._SubParsersAction) -> None:
     update.add_argument("--title", default=None, help="Replacement issue title.")
     update.add_argument("--severity", choices=["low", "medium", "high", "critical"], default=None, help="Updated operational severity.")
     update.add_argument("--description", default=None, help="Replacement issue description.")
+    update.add_argument("--body", default=None, help="Replacement longer-form issue narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement issue body.")
     add_optional_bool_argument(update, "--release-blocking", default=None, help_text="Change whether the issue is treated as a release blocker.")
     update.set_defaults(func=run_update)
 
@@ -125,12 +129,14 @@ def _build_links(args: argparse.Namespace) -> dict[str, list[str]]:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="issue")
     row = {
         "id": args.id,
         "title": args.title,
         "status": args.status,
         "severity": args.severity,
         "description": args.description,
+        "body": body,
         "plan": {"horizon": args.horizon, "slot": args.slot},
         "feature_ids": args.feature_ids,
         "claim_ids": args.claim_ids,
@@ -151,11 +157,13 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="issue")
     changes = compact_dict(
         {
             "title": args.title,
             "severity": args.severity,
             "description": args.description,
+            "body": body,
             "release_blocking": args.release_blocking,
         }
     )

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/main.py

@@ -1,7 +1,9 @@
 from __future__ import annotations
 
 import argparse
+import re
 import sys
+from importlib.metadata import PackageNotFoundError, version as package_version
 from pathlib import Path
 from typing import Any
 
@@ -27,16 +29,51 @@ from .test_cmd import register_test
 from .upgrade_cmd import register_upgrade
 from .validate_cmd import register_validate
 
+_PACKAGE_NAME = "ssot-cli"
+_PYPROJECT_PATH = Path(__file__).resolve().parents[2] / "pyproject.toml"
+_VERSION_PATTERN = re.compile(r'^version\s*=\s*"(?P<version>[^"]+)"\s*$')
+
 
 def _default_prog() -> str:
     executable = Path(sys.argv[0]).name
-    if executable.endswith(".exe"):
-        executable = executable[:-4]
+    for suffix in (".exe", ".py"):
+        if executable.endswith(suffix):
+            executable = executable[: -len(suffix)]
+            break
     if executable in {"", "__main__", "-m"}:
         return "ssot-registry"
     return executable
 
 
+def _read_version_from_pyproject(pyproject_path: Path = _PYPROJECT_PATH) -> str:
+    in_project_section = False
+
+    for line in pyproject_path.read_text(encoding="utf-8").splitlines():
+        stripped = line.strip()
+
+        if stripped.startswith("[") and stripped.endswith("]"):
+            in_project_section = stripped == "[project]"
+            continue
+
+        if not in_project_section:
+            continue
+
+        match = _VERSION_PATTERN.match(stripped)
+        if match is not None:
+            return match.group("version")
+
+    raise RuntimeError(f"Unable to locate [project].version in {pyproject_path}")
+
+
+def _cli_version() -> str:
+    if _PYPROJECT_PATH.exists():
+        return _read_version_from_pyproject()
+    try:
+        return package_version(_PACKAGE_NAME)
+    except PackageNotFoundError:
+        return _read_version_from_pyproject()
+
+
 def build_parser(*, prog: str | None = None) -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog=prog or _default_prog(),
@@ -46,6 +83,12 @@ def build_parser(*, prog: str | None = None) -> argparse.ArgumentParser:
             "implementation features, verification artifacts, and publication-ready releases."
         ),
     )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {_cli_version()}",
+        help="Print the installed CLI package version and exit.",
+    )
     parser.add_argument(
         "--output-format",
         default="json",

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/profile_cmd.py

@@ -12,7 +12,7 @@ from ssot_registry.api import (
     unlink_entities,
     update_entity,
 )
-from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict
+from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 _LINK_MAPPING = {
     "feature_ids": "feature_ids",
@@ -33,6 +33,8 @@ def register_profile(subparsers: argparse._SubParsersAction) -> None:
     create.add_argument("--id", required=True, help="Normalized profile id to create.")
     create.add_argument("--title", required=True, help="Human-readable profile title.")
     create.add_argument("--description", default="", help="Operator-facing summary of the profile's scope.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the profile.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the profile body.")
     create.add_argument("--status", choices=["draft", "active", "retired"], default="draft", help="Current lifecycle state of the profile.")
     create.add_argument("--kind", choices=["capability", "certification", "deployment", "interoperability"], default="capability", help="Why the profile exists operationally.")
     create.add_argument("--feature-ids", nargs="*", default=[], help="Feature ids directly included in the profile.")
@@ -61,6 +63,8 @@ def register_profile(subparsers: argparse._SubParsersAction) -> None:
     update.add_argument("--id", required=True, help="Profile id to update.")
     update.add_argument("--title", default=None, help="Replacement profile title.")
     update.add_argument("--description", default=None, help="Replacement profile description.")
+    update.add_argument("--body", default=None, help="Replacement longer-form profile narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement profile body.")
     update.add_argument("--status", choices=["draft", "active", "retired"], default=None, help="New lifecycle state.")
     update.add_argument("--kind", choices=["capability", "certification", "deployment", "interoperability"], default=None, help="New operational role for the profile.")
     update.add_argument("--claim-tier", choices=["T0", "T1", "T2", "T3", "T4"], default=None, help="Updated default claim tier for evaluation.")
@@ -104,6 +108,7 @@ def _build_links(args: argparse.Namespace) -> dict[str, list[str]]:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="profile")
     return create_entity(
         args.path,
         "profiles",
@@ -111,6 +116,7 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
             "id": args.id,
             "title": args.title,
             "description": args.description,
+            "body": body,
             "status": args.status,
             "kind": args.kind,
             "feature_ids": args.feature_ids,
@@ -133,10 +139,12 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="profile")
     changes = compact_dict(
         {
             "title": args.title,
             "description": args.description,
+            "body": body,
             "status": args.status,
             "kind": args.kind,
             "claim_tier": args.claim_tier,

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/release_cmd.py

@@ -19,7 +19,7 @@ from ssot_registry.api import (
     revoke_release,
     update_entity,
 )
-from ssot_cli.common import add_ids_argument, add_path_argument, compact_dict
+from ssot_cli.common import add_ids_argument, add_path_argument, compact_dict, load_text_argument
 
 
 def register_release(subparsers: argparse._SubParsersAction) -> None:
@@ -33,6 +33,8 @@ def register_release(subparsers: argparse._SubParsersAction) -> None:
     create = release_sub.add_parser("create", help="Create a release candidate.", description="Create a release record tied to a frozen boundary and optional supporting claims and evidence.")
     add_path_argument(create)
     create.add_argument("--id", required=True, help="Normalized release id to create.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the release.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the release body.")
     create.add_argument("--version", required=True, help="Semantic or operator-defined version string for the release.")
     create.add_argument("--status", choices=["draft", "candidate", "certified", "promoted", "published", "revoked"], default="draft", help="Current publication stage of the release.")
     create.add_argument("--boundary-id", required=True, help="Primary frozen boundary id that defines the release scope.")
@@ -54,6 +56,8 @@ def register_release(subparsers: argparse._SubParsersAction) -> None:
     update = release_sub.add_parser("update", help="Edit release metadata.", description="Update mutable release fields without changing its claim or evidence membership lists.")
     add_path_argument(update)
     update.add_argument("--id", required=True, help="Release id to update.")
+    update.add_argument("--body", default=None, help="Replacement longer-form release narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement release body.")
     update.add_argument("--version", default=None, help="Replacement release version string.")
     update.add_argument("--status", choices=["draft", "candidate", "certified", "promoted", "published", "revoked"], default=None, help="Updated publication stage.")
     update.add_argument("--boundary-id", default=None, help="Replacement primary boundary id that defines the release scope.")
@@ -125,10 +129,12 @@ def register_release(subparsers: argparse._SubParsersAction) -> None:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="release")
     boundary_ids = [args.boundary_id, *(args.boundary_ids or [])]
     boundary_ids = list(dict.fromkeys(boundary_ids))
     row = {
         "id": args.id,
+        "body": body,
         "version": args.version,
         "status": args.status,
         "boundary_id": args.boundary_id,
@@ -148,6 +154,7 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="release")
     boundary_ids = args.boundary_ids
     if boundary_ids is not None:
         boundary_ids = list(dict.fromkeys(([args.boundary_id] if args.boundary_id else []) + boundary_ids))
@@ -156,6 +163,7 @@ def run_update(args: argparse.Namespace) -> dict[str, object]:
     elif args.boundary_id is not None:
         boundary_ids = [args.boundary_id]
     changes = compact_dict({
+        "body": body,
         "version": args.version,
         "status": args.status,
         "boundary_id": args.boundary_id or (boundary_ids[0] if boundary_ids else None),

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/risk_cmd.py

@@ -12,7 +12,7 @@ from ssot_registry.api import (
     unlink_entities,
     update_entity,
 )
-from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict
+from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -39,6 +39,8 @@ def register_risk(subparsers: argparse._SubParsersAction) -> None:
     create.add_argument("--status", choices=["active", "mitigated", "accepted", "retired"], default="active", help="Current treatment state of the risk.")
     create.add_argument("--severity", choices=["low", "medium", "high", "critical"], default="medium", help="Operational severity of the exposure.")
     create.add_argument("--description", default="", help="Operator-facing description of the exposure and context.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the risk.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the risk body.")
     create.add_argument("--feature-ids", nargs="*", default=[], help="Feature ids exposed by the risk.")
     create.add_argument("--claim-ids", nargs="*", default=[], help="Claim ids affected by the risk.")
     create.add_argument("--test-ids", nargs="*", default=[], help="Test ids related to the risk.")
@@ -63,6 +65,8 @@ def register_risk(subparsers: argparse._SubParsersAction) -> None:
     update.add_argument("--title", default=None, help="Replacement risk title.")
     update.add_argument("--severity", choices=["low", "medium", "high", "critical"], default=None, help="Updated operational severity.")
     update.add_argument("--description", default=None, help="Replacement risk description.")
+    update.add_argument("--body", default=None, help="Replacement longer-form risk narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement risk body.")
     add_optional_bool_argument(update, "--release-blocking", default=None, help_text="Change whether the risk is treated as a release blocker.")
     update.set_defaults(func=run_update)
 
@@ -115,12 +119,14 @@ def _build_links(args: argparse.Namespace) -> dict[str, list[str]]:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="risk")
     row = {
         "id": args.id,
         "title": args.title,
         "status": args.status,
         "severity": args.severity,
         "description": args.description,
+        "body": body,
         "feature_ids": args.feature_ids,
         "claim_ids": args.claim_ids,
         "test_ids": args.test_ids,
@@ -140,11 +146,13 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="risk")
     changes = compact_dict(
         {
             "title": args.title,
             "severity": args.severity,
             "description": args.description,
+            "body": body,
             "release_blocking": args.release_blocking,
         }
     )

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli/test_cmd.py

@@ -3,7 +3,7 @@
 import argparse
 
 from ssot_registry.api import create_entity, delete_entity, get_entity, link_entities, list_entities, run_tests, unlink_entities, update_entity
-from ssot_cli.common import add_ids_argument, add_path_argument, collect_list_fields, compact_dict, load_json_object_argument
+from ssot_cli.common import add_ids_argument, add_path_argument, collect_list_fields, compact_dict, load_json_object_argument, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -25,6 +25,8 @@ def register_test(subparsers: argparse._SubParsersAction) -> None:
     add_path_argument(create)
     create.add_argument("--id", required=True, help="Normalized test id to create.")
     create.add_argument("--title", required=True, help="Human-readable test title.")
+    create.add_argument("--body", default=None, help="Optional longer-form narrative for the test.")
+    create.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the test body.")
     create.add_argument("--status", choices=["planned", "passing", "failing", "blocked", "skipped"], default="planned", help="Current execution or readiness state of the test.")
     create.add_argument("--kind", required=True, help="Operator-defined test category such as unit, integration, or manual.")
     create.add_argument("--test-path", dest="test_path", required=True, help="Repository-relative location of the executable test or test specification.")
@@ -49,6 +51,8 @@ def register_test(subparsers: argparse._SubParsersAction) -> None:
     add_path_argument(update)
     update.add_argument("--id", required=True, help="Test id to update.")
     update.add_argument("--title", default=None, help="Replacement test title.")
+    update.add_argument("--body", default=None, help="Replacement longer-form test narrative.")
+    update.add_argument("--body-file", default=None, help="Path to a UTF-8 text file containing the replacement test body.")
     update.add_argument("--status", choices=["planned", "passing", "failing", "blocked", "skipped"], default=None, help="Updated execution or readiness state.")
     update.add_argument("--kind", default=None, help="Updated test category.")
     update.add_argument("--test-path", dest="test_path", default=None, help="Updated repository-relative path to the test or procedure.")
@@ -99,6 +103,7 @@ def _build_links(args: argparse.Namespace) -> dict[str, list[str]]:
 
 
 def run_create(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="test")
     execution = load_json_object_argument(
         inline_value=args.execution_json,
         file_value=args.execution_file,
@@ -107,6 +112,7 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
     row = {
         "id": args.id,
         "title": args.title,
+        "body": body,
         "status": args.status,
         "kind": args.kind,
         "path": args.test_path,
@@ -127,6 +133,7 @@ def run_list(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
+    body = load_text_argument(inline_value=args.body, file_value=args.body_file, label="test")
     execution = load_json_object_argument(
         inline_value=args.execution_json,
         file_value=args.execution_file,
@@ -135,6 +142,7 @@ def run_update(args: argparse.Namespace) -> dict[str, object]:
     changes = compact_dict(
         {
             "title": args.title,
+            "body": body,
             "status": args.status,
             "kind": args.kind,
             "path": args.test_path,

{ssot_cli-0.1.10.dev1 → ssot_cli-0.1.11}/src/ssot_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-cli
-Version: 0.1.10.dev1
+Version: 0.1.11
 Summary: Primary CLI distribution for ssot-registry.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -24,9 +24,9 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Utilities
 Requires-Python: <3.14,>=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: ssot-contracts<0.3.0,>=0.2.16.dev1
-Requires-Dist: ssot-core<0.3.0,>=0.2.16.dev1
-Requires-Dist: ssot-conformance<0.3.0,>=0.2.16.dev1
+Requires-Dist: ssot-contracts<0.3.0,>=0.2.17
+Requires-Dist: ssot-core<0.3.0,>=0.2.17
+Requires-Dist: ssot-conformance<0.3.0,>=0.2.17
 Requires-Dist: tomli>=2.0.1; python_version < "3.11"
 
 <div align="center">

ssot_cli-0.1.11/src/ssot_cli.egg-info/requires.txt

@@ -0,0 +1,6 @@
+ssot-contracts<0.3.0,>=0.2.17
+ssot-core<0.3.0,>=0.2.17
+ssot-conformance<0.3.0,>=0.2.17
+
+[:python_version < "3.11"]
+tomli>=2.0.1

ssot_cli-0.1.10.dev1/src/ssot_cli.egg-info/requires.txt

@@ -1,6 +0,0 @@
-ssot-contracts<0.3.0,>=0.2.16.dev1
-ssot-core<0.3.0,>=0.2.16.dev1
-ssot-conformance<0.3.0,>=0.2.16.dev1
-
-[:python_version < "3.11"]
-tomli>=2.0.1