ssot-cli 0.1.11.dev1__tar.gz → 0.1.12.dev9__tar.gz

{ssot_cli-0.1.11.dev1 → ssot_cli-0.1.12.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-cli
-Version: 0.1.11.dev1
+Version: 0.1.12.dev9
 Summary: Primary CLI distribution for ssot-registry.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -19,14 +19,16 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Utilities
-Requires-Python: <3.14,>=3.10
+Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: ssot-contracts<0.3.0,>=0.2.17.dev1
-Requires-Dist: ssot-core<0.3.0,>=0.2.17.dev1
-Requires-Dist: ssot-conformance<0.3.0,>=0.2.17.dev1
+Requires-Dist: ssot-contracts<0.3.0,>=0.2.18.dev9
+Requires-Dist: ssot-core<0.3.0,>=0.2.18.dev9
+Requires-Dist: ssot-conformance<0.3.0,>=0.2.18.dev9
+Requires-Dist: ssot-pack-contracts<0.3.0,>=0.2.18.dev9
 Requires-Dist: tomli>=2.0.1; python_version < "3.11"
 
 <div align="center">
@@ -39,6 +41,10 @@ Requires-Dist: tomli>=2.0.1; python_version < "3.11"
   <a href="https://pypi.org/project/ssot-cli/"><img src="https://img.shields.io/pypi/pyversions/ssot-cli?label=Python" alt="Supported Python versions" /></a>
   <a href="https://pepy.tech/project/ssot-cli"><img src="https://static.pepy.tech/badge/ssot-cli" alt="Downloads" /></a>
   <a href="https://hits.sh/github.com/groupsum/ssot-registry/"><img src="https://hits.sh/github.com/groupsum/ssot-registry.svg?style=flat-square" alt="Repository hits" /></a>
+<!-- ssot-schema-badges:start -->
+  <img src="https://img.shields.io/badge/schema_version-0.5.0-blue" alt="schema_version 0.5.0" />
+  <img src="https://img.shields.io/badge/migration%20coverage-12%2F12-brightgreen" alt="Migration coverage 12/12" />
+<!-- ssot-schema-badges:end -->
 </div>
 
 `ssot-cli` is the primary command-line distribution for SSOT.

{ssot_cli-0.1.11.dev1 → ssot_cli-0.1.12.dev9}/README.md

@@ -8,6 +8,10 @@
   <a href="https://pypi.org/project/ssot-cli/"><img src="https://img.shields.io/pypi/pyversions/ssot-cli?label=Python" alt="Supported Python versions" /></a>
   <a href="https://pepy.tech/project/ssot-cli"><img src="https://static.pepy.tech/badge/ssot-cli" alt="Downloads" /></a>
   <a href="https://hits.sh/github.com/groupsum/ssot-registry/"><img src="https://hits.sh/github.com/groupsum/ssot-registry.svg?style=flat-square" alt="Repository hits" /></a>
+<!-- ssot-schema-badges:start -->
+  <img src="https://img.shields.io/badge/schema_version-0.5.0-blue" alt="schema_version 0.5.0" />
+  <img src="https://img.shields.io/badge/migration%20coverage-12%2F12-brightgreen" alt="Migration coverage 12/12" />
+<!-- ssot-schema-badges:end -->
 </div>
 
 `ssot-cli` is the primary command-line distribution for SSOT.

{ssot_cli-0.1.11.dev1 → ssot_cli-0.1.12.dev9}/pyproject.toml

@@ -4,16 +4,17 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssot-cli"
-version = "0.1.11.dev1"
+version = "0.1.12.dev9"
 description = "Primary CLI distribution for ssot-registry."
 readme = "README.md"
-requires-python = ">=3.10,<3.14"
+requires-python = ">=3.10,<3.15"
 license = "Apache-2.0"
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 dependencies = [
-  "ssot-contracts>=0.2.17.dev1,<0.3.0",
-  "ssot-core>=0.2.17.dev1,<0.3.0",
-  "ssot-conformance>=0.2.17.dev1,<0.3.0",
+  "ssot-contracts>=0.2.18.dev9,<0.3.0",
+  "ssot-core>=0.2.18.dev9,<0.3.0",
+  "ssot-conformance>=0.2.18.dev9,<0.3.0",
+  "ssot-pack-contracts>=0.2.18.dev9,<0.3.0",
   "tomli>=2.0.1; python_version < '3.11'",
 ]
 keywords = ["ssot", "cli", "registry", "governance", "release-management", "validation", "developer-tools"]
@@ -29,6 +30,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: Documentation",
   "Topic :: Software Development :: Quality Assurance",
   "Topic :: Utilities",

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

@@ -2,6 +2,7 @@
 
 import argparse
 
+from ssot_contracts.generated.python.enums import ASSURANCE_ORIGINS
 from ssot_registry.api import (
     create_entity,
     delete_entity,
@@ -14,13 +15,14 @@ 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, load_text_argument
+from ssot_cli.common import add_ids_argument, add_origin_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
     "feature_ids": "feature_ids",
     "test_ids": "test_ids",
     "evidence_ids": "evidence_ids",
+    "depends_on_claim_ids": "depends_on_claim_ids",
 }
 
 
@@ -42,9 +44,11 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(create, choices=sorted(ASSURANCE_ORIGINS), default="repo-local")
     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.")
+    create.add_argument("--depends-on-claim-ids", nargs="*", default=[], help="Lower-tier claim ids this claim builds on.")
     create.set_defaults(func=run_create)
 
     get = claim_sub.add_parser("get", help="Show one claim.", description="Fetch a single claim record by id.")
@@ -55,6 +59,7 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     list_cmd = claim_sub.add_parser("list", help="List claims.", description="List claim records currently known to the registry.")
     add_path_argument(list_cmd)
     add_ids_argument(list_cmd, help_text="Claim ids to include in the list output.")
+    add_origin_argument(list_cmd, choices=sorted(ASSURANCE_ORIGINS), default=None)
     list_cmd.set_defaults(func=run_list)
 
     update = claim_sub.add_parser("update", help="Edit claim metadata.", description="Update mutable claim fields without changing its linked support graph.")
@@ -65,6 +70,7 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(update, choices=sorted(ASSURANCE_ORIGINS), default=None)
     update.set_defaults(func=run_update)
 
     delete = claim_sub.add_parser("delete", help="Delete a claim.", description="Remove a claim record from the registry.")
@@ -78,6 +84,7 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     link.add_argument("--feature-ids", nargs="*", help="Feature ids to attach.")
     link.add_argument("--test-ids", nargs="*", help="Test ids to attach.")
     link.add_argument("--evidence-ids", nargs="*", help="Evidence ids to attach.")
+    link.add_argument("--depends-on-claim-ids", nargs="*", help="Lower-tier claim ids this claim builds on.")
     link.set_defaults(func=run_link)
 
     unlink = claim_sub.add_parser("unlink", help="Remove related records from a claim.", description="Remove links from a claim to features, tests, or evidence.")
@@ -86,11 +93,13 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     unlink.add_argument("--feature-ids", nargs="*", help="Feature ids to detach.")
     unlink.add_argument("--test-ids", nargs="*", help="Test ids to detach.")
     unlink.add_argument("--evidence-ids", nargs="*", help="Evidence ids to detach.")
+    unlink.add_argument("--depends-on-claim-ids", nargs="*", help="Lower-tier claim ids to detach.")
     unlink.set_defaults(func=run_unlink)
 
     evaluate = claim_sub.add_parser("evaluate", help="Evaluate claim support.", description="Recompute claim support and readiness for one claim or the entire registry.")
     add_path_argument(evaluate)
     evaluate.add_argument("--claim-id", default=None, help="Claim id to evaluate. Omit to evaluate every claim in the registry.")
+    evaluate.add_argument("--include-tier-gate", action="store_true", help="Include machine-actionable claim tier gate evaluation.")
     evaluate.set_defaults(func=run_evaluate)
 
     set_status = claim_sub.add_parser("set-status", help="Advance or revise claim status.", description="Change the lifecycle status of a claim without editing other fields.")
@@ -99,7 +108,11 @@ def register_claim(subparsers: argparse._SubParsersAction) -> None:
     set_status.add_argument("--status", required=True, choices=["proposed", "declared", "implemented", "asserted", "evidenced", "certified", "promoted", "published", "blocked", "retired"], help="Target lifecycle or publication state.")
     set_status.set_defaults(func=run_set_status)
 
-    set_tier = claim_sub.add_parser("set-tier", help="Change claim tier.", description="Set the assurance tier expected for a claim.")
+    set_tier = claim_sub.add_parser(
+        "set-tier",
+        help="Check claim tier immutability.",
+        description="Reject in-place claim tier changes; create a new claim row and use depends_on_claim_ids for append-only tier promotion.",
+    )
     add_path_argument(set_tier)
     set_tier.add_argument("--id", required=True, help="Claim id whose tier should change.")
     set_tier.add_argument("--tier", required=True, choices=["T0", "T1", "T2", "T3", "T4"], help="Target assurance tier to assign.")
@@ -123,9 +136,11 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
         "kind": args.kind,
         "description": args.description,
         "body": body,
+        "origin": args.origin,
         "feature_ids": args.feature_ids,
         "test_ids": args.test_ids,
         "evidence_ids": args.evidence_ids,
+        "depends_on_claim_ids": args.depends_on_claim_ids,
     }
     return create_entity(args.path, "claims", row)
 
@@ -135,12 +150,12 @@ def run_get(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_list(args: argparse.Namespace) -> dict[str, object]:
-    return list_entities(args.path, "claims", ids=args.ids)
+    return list_entities(args.path, "claims", ids=args.ids, origin=args.origin)
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
     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})
+    changes = compact_dict({"title": args.title, "kind": args.kind, "description": args.description, "body": body, "origin": args.origin})
     if not changes:
         raise ValueError("At least one update field is required")
     return update_entity(args.path, "claims", args.id, changes)
@@ -159,7 +174,7 @@ def run_unlink(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_evaluate(args: argparse.Namespace) -> dict[str, object]:
-    return evaluate_claims(path=args.path, claim_id=args.claim_id)
+    return evaluate_claims(path=args.path, claim_id=args.claim_id, include_tier_gate=args.include_tier_gate)
 
 
 def run_set_status(args: argparse.Namespace) -> dict[str, object]:

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

@@ -23,6 +23,16 @@ def add_ids_argument(parser: argparse.ArgumentParser, flag: str = "--ids", *, de
     parser.add_argument(flag, dest=dest, nargs="+", default=None, help=help_text)
 
 
+def add_origin_argument(parser: argparse.ArgumentParser, *, choices: list[str], required: bool = False, default: str | None = None) -> None:
+    parser.add_argument(
+        "--origin",
+        choices=choices,
+        required=required,
+        default=default,
+        help="Assurance row origin owner.",
+    )
+
+
 def add_optional_bool_argument(
     parser: argparse.ArgumentParser,
     name: str,
@@ -81,5 +91,5 @@ def load_text_argument(
     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")
+        return Path(file_value).read_text(encoding="utf-8-sig")
     return inline_value

ssot_cli-0.1.12.dev9/src/ssot_cli/config_cmd.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+import argparse
+
+from ssot_registry.api import ensure_repo_config, load_repo_config, validate_repo_config
+
+from .common import add_path_argument
+
+
+def register_config(subparsers: argparse._SubParsersAction) -> None:
+    config = subparsers.add_parser(
+        "config",
+        help="Manage repo-local SSOT policy configuration.",
+        description="Create, inspect, and validate the repo-local `.ssot/ssot.toml` policy file.",
+    )
+    config_sub = config.add_subparsers(dest="config_command", required=True)
+
+    init = config_sub.add_parser(
+        "init",
+        help="Create or refresh the repo-local config file.",
+        description="Ensure that `.ssot/ssot.toml` exists and contains a valid default template.",
+    )
+    add_path_argument(init)
+    init.add_argument("--force", action="store_true", help="Overwrite an existing repo-local config file.")
+    init.set_defaults(func=run_init)
+
+    show = config_sub.add_parser(
+        "show",
+        help="Show the effective repo-local config.",
+        description="Load and display the validated repo-local SSOT config.",
+    )
+    add_path_argument(show)
+    show.set_defaults(func=run_show)
+
+    validate = config_sub.add_parser(
+        "validate",
+        help="Validate the repo-local config.",
+        description="Parse and validate the repo-local SSOT config file without mutating the repository.",
+    )
+    add_path_argument(validate)
+    validate.set_defaults(func=run_validate)
+
+
+def run_init(args: argparse.Namespace) -> dict[str, object]:
+    return ensure_repo_config(args.path, overwrite=args.force)
+
+
+def run_show(args: argparse.Namespace) -> dict[str, object]:
+    return load_repo_config(args.path)
+
+
+def run_validate(args: argparse.Namespace) -> dict[str, object]:
+    return validate_repo_config(args.path)

{ssot_cli-0.1.11.dev1 → ssot_cli-0.1.12.dev9}/src/ssot_cli/conformance_cmd.py

@@ -44,6 +44,20 @@ def register_conformance(subparsers: argparse._SubParsersAction) -> None:
     run.add_argument("--evidence-output", default=None, help="Optional JSON output path for machine-readable evidence.")
     run.set_defaults(func=run_run)
 
+    origin = conformance_sub.add_parser(
+        "origin",
+        help="Generate downstream ssot-origin compliance tests.",
+        description="Plan or apply generated downstream conformance tests and SSOT rows for synchronized ssot-origin ADR and SPEC obligations.",
+    )
+    add_path_argument(origin)
+    origin.add_argument("--kinds", nargs="*", choices=["adr", "spec"], default=None, help="Limit generation to ADR or SPEC origin obligations.")
+    origin.add_argument("--apply", action="store_true", help="Write generated tests and registry rows instead of only reporting the plan.")
+    origin.add_argument("--include-claims", action="store_true", help="Generate claim rows and links.")
+    origin.add_argument("--include-evidence", action="store_true", help="Generate evidence rows and a machine-readable report.")
+    origin.add_argument("--overwrite", action="store_true", help="Allow replacing previously generated files.")
+    origin.add_argument("--report-output", default=None, help="Optional output path for the generated origin conformance report.")
+    origin.set_defaults(func=run_origin)
+
 
 def run_profile_list(args: argparse.Namespace) -> dict[str, object]:
     from ssot_conformance import list_profiles
@@ -86,3 +100,23 @@ def run_run(args: argparse.Namespace) -> dict[str, object]:
         evidence_output=args.evidence_output,
         dry_run=args.dry_run,
     )
+
+
+def run_origin(args: argparse.Namespace) -> dict[str, object]:
+    from ssot_conformance import apply_origin_conformance, plan_origin_conformance
+
+    if args.apply:
+        return apply_origin_conformance(
+            args.path,
+            kinds=args.kinds,
+            include_claims=args.include_claims,
+            include_evidence=args.include_evidence,
+            overwrite=args.overwrite,
+            report_output=args.report_output,
+        )
+    return plan_origin_conformance(
+        args.path,
+        kinds=args.kinds,
+        include_claims=args.include_claims,
+        include_evidence=args.include_evidence,
+    )

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

@@ -2,6 +2,7 @@
 
 import argparse
 
+from ssot_contracts.generated.python.enums import ASSURANCE_ORIGINS
 from ssot_registry.api import (
     create_entity,
     delete_entity,
@@ -12,7 +13,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, load_text_argument
+from ssot_cli.common import add_ids_argument, add_origin_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -38,6 +39,7 @@ def register_evidence(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(create, choices=sorted(ASSURANCE_ORIGINS), default="repo-local")
     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.")
@@ -51,6 +53,7 @@ def register_evidence(subparsers: argparse._SubParsersAction) -> None:
     list_cmd = evidence_sub.add_parser("list", help="List evidence rows.", description="List evidence artifacts currently known to the registry.")
     add_path_argument(list_cmd)
     add_ids_argument(list_cmd, help_text="Evidence ids to include in the list output.")
+    add_origin_argument(list_cmd, choices=sorted(ASSURANCE_ORIGINS), default=None)
     list_cmd.set_defaults(func=run_list)
 
     update = evidence_sub.add_parser("update", help="Edit evidence metadata.", description="Update mutable evidence fields without changing its link graph.")
@@ -62,6 +65,7 @@ def register_evidence(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(update, choices=sorted(ASSURANCE_ORIGINS), default=None)
     update.add_argument("--evidence-path", dest="evidence_path", default=None, help="Updated repository-relative path to the artifact.")
     update.set_defaults(func=run_update)
 
@@ -106,6 +110,7 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
         "kind": args.kind,
         "tier": args.tier,
         "body": body,
+        "origin": args.origin,
         "path": args.evidence_path,
         "claim_ids": args.claim_ids,
         "test_ids": args.test_ids,
@@ -118,7 +123,7 @@ def run_get(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_list(args: argparse.Namespace) -> dict[str, object]:
-    return list_entities(args.path, "evidence", ids=args.ids)
+    return list_entities(args.path, "evidence", ids=args.ids, origin=args.origin)
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
@@ -130,6 +135,7 @@ def run_update(args: argparse.Namespace) -> dict[str, object]:
             "kind": args.kind,
             "tier": args.tier,
             "body": body,
+            "origin": args.origin,
             "path": args.evidence_path,
         }
     )

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

@@ -3,6 +3,7 @@
 import argparse
 
 from ssot_contracts.generated.python.enums import (
+    ASSURANCE_ORIGINS,
     CLAIM_TIERS,
     FEATURE_IMPLEMENTATION_STATUSES,
     FEATURE_LIFECYCLE_STAGES,
@@ -20,7 +21,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, load_text_argument
+from ssot_cli.common import add_ids_argument, add_optional_bool_argument, add_origin_argument, add_path_argument, collect_list_fields, compact_dict, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -50,6 +51,7 @@ def register_feature(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(create, choices=sorted(ASSURANCE_ORIGINS), default="repo-local")
     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.")
@@ -73,6 +75,7 @@ def register_feature(subparsers: argparse._SubParsersAction) -> None:
     list_cmd = feature_sub.add_parser("list", help="List features.", description="List feature records currently known to the registry.")
     add_path_argument(list_cmd)
     add_ids_argument(list_cmd, help_text="Feature ids to include in the list output.")
+    add_origin_argument(list_cmd, choices=sorted(ASSURANCE_ORIGINS), default=None)
     list_cmd.set_defaults(func=run_list)
 
     update = feature_sub.add_parser("update", help="Edit feature metadata.", description="Update mutable feature fields without changing links or planning state.")
@@ -82,6 +85,7 @@ def register_feature(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(update, choices=sorted(ASSURANCE_ORIGINS), default=None)
     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)
 
@@ -168,6 +172,7 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
         "title": args.title,
         "description": args.description,
         "body": body,
+        "origin": args.origin,
         "implementation_status": args.implementation_status,
         "lifecycle": {
             "stage": args.lifecycle_stage,
@@ -188,7 +193,7 @@ def run_get(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_list(args: argparse.Namespace) -> dict[str, object]:
-    return list_entities(args.path, "features", ids=args.ids)
+    return list_entities(args.path, "features", ids=args.ids, origin=args.origin)
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
@@ -198,6 +203,7 @@ def run_update(args: argparse.Namespace) -> dict[str, object]:
             "title": args.title,
             "description": args.description,
             "body": body,
+            "origin": args.origin,
             "implementation_status": args.implementation_status,
         }
     )

{ssot_cli-0.1.11.dev1 → ssot_cli-0.1.12.dev9}/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
 
@@ -13,11 +15,13 @@ from .adr_cmd import register_adr
 from .boundary_cmd import register_boundary
 from .claim_cmd import register_claim
 from .conformance_cmd import register_conformance
+from .config_cmd import register_config
 from .evidence_cmd import register_evidence
 from .feature_cmd import register_feature
 from .graph_cmd import register_graph
 from .init_cmd import register_init
 from .issue_cmd import register_issue
+from .pack_cmd import register_pack
 from .profile_cmd import register_profile
 from .registry_cmd import register_registry
 from .release_cmd import register_release
@@ -27,16 +31,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 +85,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",
@@ -62,12 +107,14 @@ def build_parser(*, prog: str | None = None) -> argparse.ArgumentParser:
     register_init(subparsers)
     register_validate(subparsers)
     register_upgrade(subparsers)
+    register_config(subparsers)
     register_adr(subparsers)
     register_spec(subparsers)
     register_feature(subparsers)
     register_profile(subparsers)
     register_test(subparsers)
     register_issue(subparsers)
+    register_pack(subparsers)
     register_claim(subparsers)
     register_conformance(subparsers)
     register_evidence(subparsers)

ssot_cli-0.1.12.dev9/src/ssot_cli/pack_cmd.py

@@ -0,0 +1,92 @@
+from __future__ import annotations
+
+import argparse
+
+from ssot_registry.api import inspect_pack, preflight_pack, sync_pack
+
+from .common import add_path_argument
+
+
+def register_pack(subparsers: argparse._SubParsersAction) -> None:
+    pack = subparsers.add_parser(
+        "pack",
+        help="Inspect, preflight, and sync governance packs.",
+        description="Operate on self-describing SSOT governance packs that expose the shared pack contract.",
+    )
+    pack_sub = pack.add_subparsers(dest="pack_command", required=True)
+
+    inspect = pack_sub.add_parser("inspect", help="Inspect packaged governance-pack metadata and manifests.")
+    inspect.add_argument("package", help="Import package name for the governance pack.")
+    inspect.add_argument("--manifest", action="store_true", help="Include the full packaged manifest in the response.")
+    inspect.set_defaults(func=run_inspect)
+
+    preflight = pack_sub.add_parser("preflight", help="Validate a governance pack before repository mutation.")
+    add_path_argument(preflight)
+    preflight.add_argument("package", help="Import package name for the governance pack.")
+    preflight.add_argument("--kind", choices=["adr", "adrs", "spec", "specs"], default=None)
+    preflight.add_argument("--all", action="store_true", help="Check all document kinds declared by the pack.")
+    preflight.add_argument("--manifest", action="store_true", help="Include the full packaged manifest in the response.")
+    preflight.add_argument("--pin", default=None, help="Require the pack version to match this exact value.")
+    preflight.add_argument("--resolved", action="store_true", help="Include resolved manifest document entries in the response.")
+    preflight.add_argument("--trusted-only", action="store_true", help="Require the pack to be trusted by default.")
+    preflight.set_defaults(func=run_preflight)
+
+    sync = pack_sub.add_parser("sync", help="Sync declared governance-pack documents into a repository.")
+    add_path_argument(sync)
+    sync.add_argument("package", help="Import package name for the governance pack.")
+    sync.add_argument("--kind", choices=["adr", "adrs", "spec", "specs"], default=None)
+    sync.add_argument("--all", action="store_true", help="Sync all document kinds declared by the pack.")
+    sync.add_argument("--trusted-only", action="store_true", help="Require the pack to be trusted by default.")
+    sync.add_argument("--trust", action="store_true", help="Record explicit operator approval for syncing the selected pack.")
+    sync.add_argument("--dry-run", action="store_true", help="Report sync changes without writing files or registry rows.")
+    sync.add_argument("--manifest", action="store_true", help="Include the full packaged manifest in the response.")
+    sync.add_argument("--no-sync", action="store_true", help="Run preflight and return without writing files or registry rows.")
+    sync.add_argument("--pin", default=None, help="Require the pack version to match this exact value.")
+    sync.add_argument("--preflight-only", action="store_true", help="Run only preflight checks through the sync command surface.")
+    sync.add_argument("--prune-stale", action="store_true", help="Remove stale extension-pack rows for this pack after successful sync.")
+    sync.add_argument("--reservations", action="store_true", help="Include reservation changes in the response.")
+    sync.add_argument("--resolved", action="store_true", help="Include resolved manifest document entries in the response.")
+    sync.add_argument("--yes", action="store_true", help="Acknowledge noninteractive operator approval for the requested sync.")
+    sync.set_defaults(func=run_sync)
+
+
+def run_inspect(args: argparse.Namespace) -> dict[str, object]:
+    payload = inspect_pack(args.package)
+    if not args.manifest:
+        payload.pop("documents", None)
+    return payload
+
+
+def run_preflight(args: argparse.Namespace) -> dict[str, object]:
+    if args.all and args.kind is not None:
+        raise ValueError("--all cannot be combined with --kind")
+    return preflight_pack(
+        args.path,
+        args.package,
+        kind=None if args.all else args.kind,
+        trusted_only=args.trusted_only,
+        pin=args.pin,
+        include_manifest=args.manifest,
+        include_resolved=args.resolved,
+    )
+
+
+def run_sync(args: argparse.Namespace) -> dict[str, object]:
+    if args.all and args.kind is not None:
+        raise ValueError("--all cannot be combined with --kind")
+    return sync_pack(
+        args.path,
+        args.package,
+        kind=None if args.all else args.kind,
+        trusted_only=args.trusted_only,
+        dry_run=args.dry_run,
+        pin=args.pin,
+        preflight_only=args.preflight_only,
+        no_sync=args.no_sync,
+        prune_stale=args.prune_stale,
+        include_manifest=args.manifest,
+        include_resolved=args.resolved,
+        include_reservations=args.reservations,
+        trust=args.trust,
+        yes=args.yes,
+    )

{ssot_cli-0.1.11.dev1 → ssot_cli-0.1.12.dev9}/src/ssot_cli/registry_cmd.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import argparse
 
-from ssot_registry.api import export_registry, sync_automated_statuses
+from ssot_registry.api import export_registry, repair_document_hashes, sync_automated_statuses
 
 
 def register_registry(subparsers: argparse._SubParsersAction) -> None:
@@ -32,6 +32,18 @@ def register_registry(subparsers: argparse._SubParsersAction) -> None:
     sync_statuses.add_argument("--dry-run", action="store_true", help="Report proposed status changes without saving them.")
     sync_statuses.set_defaults(func=run_sync_statuses)
 
+    repair_doc_hashes = registry_sub.add_parser(
+        "repair-doc-hashes",
+        help="Refresh mutable repo-local ADR/SPEC content hashes.",
+        description=(
+            "Repair explicitly selected repo-local ADR and SPEC content_sha256 values after validating each "
+            "document at its registered path, then run full registry validation before saving."
+        ),
+    )
+    repair_doc_hashes.add_argument("path", nargs="?", default=".", help="Repository root or registry file to repair.")
+    repair_doc_hashes.add_argument("--ids", nargs="+", required=True, help="ADR and SPEC ids whose document hashes should be repaired.")
+    repair_doc_hashes.set_defaults(func=run_repair_doc_hashes)
+
 
 def run_export(args: argparse.Namespace) -> dict[str, object]:
     return export_registry(path=args.path, output_format=args.format, output=args.output)
@@ -39,3 +51,7 @@ def run_export(args: argparse.Namespace) -> dict[str, object]:
 
 def run_sync_statuses(args: argparse.Namespace) -> dict[str, object]:
     return sync_automated_statuses(path=args.path, dry_run=args.dry_run)
+
+
+def run_repair_doc_hashes(args: argparse.Namespace) -> dict[str, object]:
+    return repair_document_hashes(path=args.path, ids=args.ids)

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

@@ -18,6 +18,7 @@ from ssot_registry.api import (
     remove_release_evidence,
     revoke_release,
     update_entity,
+    verify_local_release,
 )
 from ssot_cli.common import add_ids_argument, add_path_argument, compact_dict, load_text_argument
 
@@ -121,6 +122,18 @@ def register_release(subparsers: argparse._SubParsersAction) -> None:
     publish.add_argument("--release-id", default=None, help="Release id to publish. Omit to use the active release.")
     publish.set_defaults(func=run_publish)
 
+    verify_local = release_sub.add_parser(
+        "verify-local",
+        help="Run local release assurance verification.",
+        description="Generate governed source snapshots, artifact manifests, evidence bundles, and a local verification report for a release.",
+    )
+    add_path_argument(verify_local)
+    verify_local.add_argument("--release-id", default=None, help="Release id to verify. Omit to use the active release.")
+    verify_local.add_argument("--path-policy", choices=["ssot-only", "declared", "full-repo"], default="ssot-only", help="Source snapshot path policy.")
+    verify_local.add_argument("--no-write-artifacts", action="store_true", help="Return the report without writing the verification report artifact.")
+    verify_local.add_argument("--blocking", action="store_true", help="Mark the report as intended for blocking release gates.")
+    verify_local.set_defaults(func=run_verify_local)
+
     revoke = release_sub.add_parser("revoke", help="Revoke a release.", description="Mark a release revoked and record the reason for operators and auditors.")
     add_path_argument(revoke)
     revoke.add_argument("--release-id", required=True, help="Release id to revoke.")
@@ -214,6 +227,16 @@ def run_publish(args: argparse.Namespace) -> dict[str, object]:
     return publish_release(path=args.path, release_id=args.release_id)
 
 
+def run_verify_local(args: argparse.Namespace) -> dict[str, object]:
+    return verify_local_release(
+        path=args.path,
+        release_id=args.release_id,
+        path_policy=args.path_policy,
+        write_artifacts=not args.no_write_artifacts,
+        blocking=args.blocking,
+    )
+
+
 def run_revoke(args: argparse.Namespace) -> dict[str, object]:
     return revoke_release(path=args.path, release_id=args.release_id, reason=args.reason)
 

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

@@ -2,8 +2,9 @@
 
 import argparse
 
+from ssot_contracts.generated.python.enums import ASSURANCE_ORIGINS
 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, load_text_argument
+from ssot_cli.common import add_ids_argument, add_origin_argument, add_path_argument, collect_list_fields, compact_dict, load_json_object_argument, load_text_argument
 
 
 _LINK_MAPPING = {
@@ -27,6 +28,7 @@ def register_test(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(create, choices=sorted(ASSURANCE_ORIGINS), default="repo-local")
     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.")
@@ -45,6 +47,7 @@ def register_test(subparsers: argparse._SubParsersAction) -> None:
     list_cmd = test_sub.add_parser("list", help="List tests.", description="List test records currently known to the registry.")
     add_path_argument(list_cmd)
     add_ids_argument(list_cmd, help_text="Test ids to include in the list output.")
+    add_origin_argument(list_cmd, choices=sorted(ASSURANCE_ORIGINS), default=None)
     list_cmd.set_defaults(func=run_list)
 
     update = test_sub.add_parser("update", help="Edit test metadata.", description="Update mutable test fields without changing link relationships.")
@@ -53,6 +56,7 @@ def register_test(subparsers: argparse._SubParsersAction) -> None:
     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.")
+    add_origin_argument(update, choices=sorted(ASSURANCE_ORIGINS), default=None)
     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.")
@@ -113,6 +117,7 @@ def run_create(args: argparse.Namespace) -> dict[str, object]:
         "id": args.id,
         "title": args.title,
         "body": body,
+        "origin": args.origin,
         "status": args.status,
         "kind": args.kind,
         "path": args.test_path,
@@ -129,7 +134,7 @@ def run_get(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_list(args: argparse.Namespace) -> dict[str, object]:
-    return list_entities(args.path, "tests", ids=args.ids)
+    return list_entities(args.path, "tests", ids=args.ids, origin=args.origin)
 
 
 def run_update(args: argparse.Namespace) -> dict[str, object]:
@@ -143,6 +148,7 @@ def run_update(args: argparse.Namespace) -> dict[str, object]:
         {
             "title": args.title,
             "body": body,
+            "origin": args.origin,
             "status": args.status,
             "kind": args.kind,
             "path": args.test_path,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-cli
-Version: 0.1.11.dev1
+Version: 0.1.12.dev9
 Summary: Primary CLI distribution for ssot-registry.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -19,14 +19,16 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Utilities
-Requires-Python: <3.14,>=3.10
+Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: ssot-contracts<0.3.0,>=0.2.17.dev1
-Requires-Dist: ssot-core<0.3.0,>=0.2.17.dev1
-Requires-Dist: ssot-conformance<0.3.0,>=0.2.17.dev1
+Requires-Dist: ssot-contracts<0.3.0,>=0.2.18.dev9
+Requires-Dist: ssot-core<0.3.0,>=0.2.18.dev9
+Requires-Dist: ssot-conformance<0.3.0,>=0.2.18.dev9
+Requires-Dist: ssot-pack-contracts<0.3.0,>=0.2.18.dev9
 Requires-Dist: tomli>=2.0.1; python_version < "3.11"
 
 <div align="center">
@@ -39,6 +41,10 @@ Requires-Dist: tomli>=2.0.1; python_version < "3.11"
   <a href="https://pypi.org/project/ssot-cli/"><img src="https://img.shields.io/pypi/pyversions/ssot-cli?label=Python" alt="Supported Python versions" /></a>
   <a href="https://pepy.tech/project/ssot-cli"><img src="https://static.pepy.tech/badge/ssot-cli" alt="Downloads" /></a>
   <a href="https://hits.sh/github.com/groupsum/ssot-registry/"><img src="https://hits.sh/github.com/groupsum/ssot-registry.svg?style=flat-square" alt="Repository hits" /></a>
+<!-- ssot-schema-badges:start -->
+  <img src="https://img.shields.io/badge/schema_version-0.5.0-blue" alt="schema_version 0.5.0" />
+  <img src="https://img.shields.io/badge/migration%20coverage-12%2F12-brightgreen" alt="Migration coverage 12/12" />
+<!-- ssot-schema-badges:end -->
 </div>
 
 `ssot-cli` is the primary command-line distribution for SSOT.

{ssot_cli-0.1.11.dev1 → ssot_cli-0.1.12.dev9}/src/ssot_cli.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ src/ssot_cli/adr_cmd.py
 src/ssot_cli/boundary_cmd.py
 src/ssot_cli/claim_cmd.py
 src/ssot_cli/common.py
+src/ssot_cli/config_cmd.py
 src/ssot_cli/conformance_cmd.py
 src/ssot_cli/evidence_cmd.py
 src/ssot_cli/feature_cmd.py
@@ -12,6 +13,7 @@ src/ssot_cli/graph_cmd.py
 src/ssot_cli/init_cmd.py
 src/ssot_cli/issue_cmd.py
 src/ssot_cli/main.py
+src/ssot_cli/pack_cmd.py
 src/ssot_cli/profile_cmd.py
 src/ssot_cli/registry_cmd.py
 src/ssot_cli/release_cmd.py

ssot_cli-0.1.12.dev9/src/ssot_cli.egg-info/requires.txt

@@ -0,0 +1,7 @@
+ssot-contracts<0.3.0,>=0.2.18.dev9
+ssot-core<0.3.0,>=0.2.18.dev9
+ssot-conformance<0.3.0,>=0.2.18.dev9
+ssot-pack-contracts<0.3.0,>=0.2.18.dev9
+
+[:python_version < "3.11"]
+tomli>=2.0.1

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

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