wexample-cli 0.6.1__tar.gz → 0.7.0__tar.gz

{wexample_cli-0.6.1 → wexample_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-cli
-Version: 0.6.1
+Version: 0.7.0
 Summary: Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -10,9 +10,9 @@ Classifier: Operating System :: OS Independent
 Project-URL: homepage, https://github.com/wexample/python-cli
 Requires-Python: >=3.10
 Requires-Dist: attrs>=23.1.0
-Requires-Dist: wexample-app>=17.0.0
+Requires-Dist: wexample-app>=17.1.0
 Requires-Dist: wexample-helpers>=13.1.0
-Requires-Dist: wexample-prompt>=10.2.0
+Requires-Dist: wexample-prompt>=12.0.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 
 # cli
 
-Version: 0.6.1
+Version: 0.7.0
 
 Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework.
 
@@ -100,9 +100,9 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 ## Dependencies
 
 - attrs: >=23.1.0
-- wexample-app: >=17.0.0
+- wexample-app: >=17.1.0
 - wexample-helpers: >=13.1.0
-- wexample-prompt: >=10.2.0
+- wexample-prompt: >=12.0.0
 
 ## Versioning & Compatibility Policy
 

{wexample_cli-0.6.1 → wexample_cli-0.7.0}/README.md

@@ -1,6 +1,6 @@
 # cli
 
-Version: 0.6.1
+Version: 0.7.0
 
 Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework.
 
@@ -80,9 +80,9 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 ## Dependencies
 
 - attrs: >=23.1.0
-- wexample-app: >=17.0.0
+- wexample-app: >=17.1.0
 - wexample-helpers: >=13.1.0
-- wexample-prompt: >=10.2.0
+- wexample-prompt: >=12.0.0
 
 ## Versioning & Compatibility Policy
 

{wexample_cli-0.6.1 → wexample_cli-0.7.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-cli"
-version = "0.6.1"
+version = "0.7.0"
 description = "Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -19,9 +19,9 @@ classifiers = [
 ]
 dependencies = [
     "attrs>=23.1.0",
-    "wexample-app>=17.0.0",
+    "wexample-app>=17.1.0",
     "wexample-helpers>=13.1.0",
-    "wexample-prompt>=10.2.0",
+    "wexample-prompt>=12.0.0",
 ]
 
 [project.readme]

wexample_cli-0.7.0/src/wexample_cli/const/tags.py

@@ -0,0 +1,52 @@
+"""Transverse command tags.
+
+These three axes (`effect`, `audience`, `scope`) apply to every command
+regardless of the addon defining it. Each addon declares its own
+`DomainTag` class locally for the fourth axis (`domain`), which is the
+addon's responsibility.
+
+Values are plain `str` constants so they drop straight into
+`@command(tags=[...])` without any wrapping.
+"""
+
+from __future__ import annotations
+
+
+class EffectTag:
+    """What the command does to observable state."""
+
+    READ_ONLY = "effect:read-only"
+    WRITE = "effect:write"
+    CREATE = "effect:create"
+    DELETE = "effect:delete"
+    DESTRUCTIVE = "effect:destructive"
+    IDEMPOTENT = "effect:idempotent"
+    SUBPROCESS_SPAWN = "effect:subprocess-spawn"
+    NETWORK_CALL = "effect:network-call"
+    LONG_RUNNING = "effect:long-running"
+
+
+class AudienceTag:
+    """Who can safely invoke the command."""
+
+    AGENT_SAFE = "audience:agent-safe"
+    REQUIRES_CONFIRMATION = "audience:requires-confirmation"
+    DANGEROUS = "audience:dangerous"
+    HUMAN_ONLY = "audience:human-only"
+    DEV_TOOL = "audience:dev-tool"
+
+
+class ScopeTag:
+    """Execution context the command operates in."""
+
+    LOCAL = "scope:local"
+    REMOTE = "scope:remote"
+    CONTAINER = "scope:container"
+    HOST = "scope:host"
+    PROJECT = "scope:project"
+    APP = "scope:app"
+    SUITE = "scope:suite"
+    PACKAGE = "scope:package"
+    MULTI_APP = "scope:multi-app"
+    GLOBAL = "scope:global"
+    NO_CONTEXT = "scope:no-context"