strictcli 0.22.0__tar.gz → 0.23.0__tar.gz

{strictcli-0.22.0 → strictcli-0.23.0}/CHANGELOG.md

@@ -2,17 +2,23 @@
 
 # Changelog
 
-## 0.22.0
+## 0.23.0
 
-Required booleans, Context type, schema project_id guard, tag contract global flags fix
+Registration-time ban on bare --force flag name and --no-* prefix
 
 <details>
 <summary>Context</summary>
 
-Breaking change: Bool flags no longer auto-default to false. BoolFlag without explicit Default(false) is now required. New Context type for structured handler communication. Schema dump now validates project_id. TagContract now checks global flags.
+Flag names 'force' (exact) and names starting with 'no-' are now rejected at registration time. Bare --force encourages agents to bypass guardrails without thinking; qualified names like --force-overwrite make the intent explicit. The no- prefix is reserved for strictcli's auto-generated negation system (--no-flag for negatable bools).
 
 </details>
 
+### Features
+
+- **New.** Registration-time ban on bare --force flag name and --no-* prefix. Flag names starting with no- are reserved for the negation system.
+
+## 0.22.0
+
 ### Breaking
 
 - **Breaking.** Bool flags no longer auto-default to false. BoolFlag without explicit Default(false) is now required — user must pass --flag or --no-flag.

{strictcli-0.22.0 → strictcli-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.22.0
+Version: 0.23.0
 Summary: A strict, zero-dependency CLI framework for Python
 Project-URL: Homepage, https://github.com/smm-h/strictcli
 Project-URL: Repository, https://github.com/smm-h/strictcli

{strictcli-0.22.0 → strictcli-0.23.0}/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "strictcli",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "strictcli",
-      "version": "0.22.0",
+      "version": "0.23.0",
       "hasInstallScript": true,
       "license": "MIT"
     }

{strictcli-0.22.0 → strictcli-0.23.0}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strictcli",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "A strict, zero-dependency CLI framework for Python (npm wrapper)",
   "main": "index.js",
   "scripts": {

{strictcli-0.22.0 → strictcli-0.23.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "strictcli"
-version = "0.22.0"
+version = "0.23.0"
 description = "A strict, zero-dependency CLI framework for Python"
 readme = "README.md"
 license = "MIT"

{strictcli-0.22.0 → strictcli-0.23.0}/strictcli/__init__.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-__version__ = "0.22.0"
+__version__ = "0.23.0"
 
 __all__ = [
     "App", "Flag", "Arg", "FlagSet", "MutexGroup", "CoRequired", "Requires",
@@ -1204,6 +1204,17 @@ class Flag:
 
     def __post_init__(self) -> None:
         _require_non_empty_str(self.help, "help", "Flag")
+        if self.name == "force":
+            raise ValueError(
+                "flag 'force' is a reserved name; use a qualified name "
+                "like 'force-overwrite' or 'force-delete'"
+            )
+        if self.name.startswith("no-"):
+            raise ValueError(
+                f"flag '{self.name}': names starting with 'no-' are "
+                f"reserved for the negation system; use a positive "
+                f"name instead"
+            )
 
         # Parse compound types (list[T], dict[str, T])
         kind, item_t, val_t = _parse_compound_type(

{strictcli-0.22.0 → strictcli-0.23.0}/tests/test_dump_schema.py

@@ -120,8 +120,8 @@ class TestSchemaCommands:
         @app.command("deploy", help="Deploy the app")
         @strictcli.flag("target", type=str, help="Deploy target", short="t",
                         choices=["prod", "staging"])
-        @strictcli.flag("force", type=bool, default=False, help="Force deploy")
-        def deploy(target, force):
+        @strictcli.flag("force-deploy", type=bool, default=False, help="Force deploy")
+        def deploy(target, force_deploy):
             pass
 
         app.test(["--dump-schema"])
@@ -141,7 +141,7 @@ class TestSchemaCommands:
         assert "hidden" not in target_flag  # hidden=False is the default, omitted
 
         force_flag = cmd["flags"][1]
-        assert force_flag["name"] == "force"
+        assert force_flag["name"] == "force-deploy"
         assert force_flag["type"] == "bool"
         assert force_flag["negatable"] is True
         assert force_flag["default"] is False
@@ -428,8 +428,8 @@ class TestSchemaFlagTypes:
         app = _make_app()
 
         @app.command("cmd", help="A command")
-        @strictcli.flag("force", type=bool, default=False, help="Force it", negatable=False)
-        def cmd(force):
+        @strictcli.flag("force-it", type=bool, default=False, help="Force it", negatable=False)
+        def cmd(force_it):
             pass
 
         app.test(["--dump-schema"])
@@ -848,10 +848,10 @@ class TestSchemaConstraints:
 
         @app.command("deploy", help="Deploy",
                      dependencies=[strictcli.Implies(
-                         flag="force", implies="yes", value=True)])
-        @strictcli.flag("force", type=bool, default=False, help="Force deploy")
+                         flag="force-deploy", implies="yes", value=True)])
+        @strictcli.flag("force-deploy", type=bool, default=False, help="Force deploy")
         @strictcli.flag("yes", type=bool, default=False, help="Skip confirmation")
-        def deploy(force, yes):
+        def deploy(force_deploy, yes):
             pass
 
         app.test(["--dump-schema"])
@@ -860,7 +860,7 @@ class TestSchemaConstraints:
         assert len(cmd["constraints"]) == 1
         c = cmd["constraints"][0]
         assert c["type"] == "implies"
-        assert c["flag"] == "force"
+        assert c["flag"] == "force-deploy"
         assert c["implies"] == "yes"
         assert c["value"] is True
 
@@ -897,17 +897,17 @@ class TestSchemaConstraints:
 
         @app.command("deploy", help="Deploy",
                      dependencies=[strictcli.CoRequired(
-                         flags=["dry-run", "no-confirm"])])
+                         flags=["dry-run", "skip-confirm"])])
         @strictcli.flag("dry-run", type=bool, default=False, help="Dry run")
-        @strictcli.flag("no-confirm", type=bool, default=False, help="Skip confirmation")
-        def deploy(dry_run, no_confirm):
+        @strictcli.flag("skip-confirm", type=bool, default=False, help="Skip confirmation")
+        def deploy(dry_run, skip_confirm):
             pass
 
         app.test(["--dump-schema"])
         data = json.loads((tmp_path / ".strictcli" / "schema.json").read_text())
         cmd = data["commands"]["deploy"]
         c = cmd["constraints"][0]
-        assert c["flags"] == ["dry-run", "no-confirm"]
+        assert c["flags"] == ["dry-run", "skip-confirm"]
 
 
 class TestSchemaTagContracts:
@@ -928,34 +928,34 @@ class TestSchemaTagContracts:
     def test_tag_contracts_serialized(self, tmp_path, monkeypatch):
         monkeypatch.chdir(tmp_path)
         app = _make_app()
-        app.tag_contract("dangerous", requires_flag="force")
+        app.tag_contract("dangerous", requires_flag="force-deploy")
 
         @app.command("deploy", help="Deploy", tags=["dangerous"])
-        @strictcli.flag("force", type=bool, default=False, help="Force it")
-        def deploy(force):
+        @strictcli.flag("force-deploy", type=bool, default=False, help="Force it")
+        def deploy(force_deploy):
             pass
 
         app.test(["--dump-schema"])
         data = json.loads((tmp_path / ".strictcli" / "schema.json").read_text())
         assert "tag_contracts" in data
-        assert data["tag_contracts"] == {"dangerous": "force"}
+        assert data["tag_contracts"] == {"dangerous": "force-deploy"}
 
     def test_multiple_tag_contracts(self, tmp_path, monkeypatch):
         monkeypatch.chdir(tmp_path)
         app = _make_app()
-        app.tag_contract("dangerous", requires_flag="force")
+        app.tag_contract("dangerous", requires_flag="force-deploy")
         app.tag_contract("slow", requires_flag="timeout")
 
         @app.command("deploy", help="Deploy", tags=["dangerous", "slow"])
-        @strictcli.flag("force", type=bool, default=False, help="Force it")
+        @strictcli.flag("force-deploy", type=bool, default=False, help="Force it")
         @strictcli.flag("timeout", type=int, help="Timeout", default=30)
-        def deploy(force, timeout):
+        def deploy(force_deploy, timeout):
             pass
 
         app.test(["--dump-schema"])
         data = json.loads((tmp_path / ".strictcli" / "schema.json").read_text())
         assert data["tag_contracts"] == {
-            "dangerous": "force",
+            "dangerous": "force-deploy",
             "slow": "timeout",
         }
 

{strictcli-0.22.0 → strictcli-0.23.0}/tests/test_e2e.py

@@ -317,7 +317,7 @@ def test_e2e_kwargs_handler_registration_no_error():
         args=[strictcli.Arg(name="name", help="a name")],
     )
     @strictcli.flag("count", type=int, help="a count", default=0)
-    @strictcli.flag("force", type=bool, default=False, help="force it")
+    @strictcli.flag("force-it", type=bool, default=False, help="force it")
     def cmd_handler(**kwargs):
         return 0
 

{strictcli-0.22.0 → strictcli-0.23.0}/tests/test_help.py

@@ -8,8 +8,8 @@ def _make_full_app():
     app = strictcli.App(name="myapp", version="2.0.0", help="a great app")
 
     @app.command("init", help="initialize the project")
-    @strictcli.flag("force", type=bool, default=False, help="overwrite existing files")
-    def init(force):
+    @strictcli.flag("force-overwrite", type=bool, default=False, help="overwrite existing files")
+    def init(force_overwrite):
         pass
 
     @app.command(
@@ -117,7 +117,7 @@ def test_help_at_command_level():
     assert r.exit_code == 0
     assert "init" in r.stdout
     assert "initialize the project" in r.stdout
-    assert "--force" in r.stdout
+    assert "--force-overwrite" in r.stdout
 
 
 def test_help_at_group_level():

{strictcli-0.22.0 → strictcli-0.23.0}/uv.lock

@@ -232,7 +232,7 @@ wheels = [
 
 [[package]]
 name = "strictcli"
-version = "0.22.0"
+version = "0.23.0"
 source = { editable = "." }
 
 [package.dev-dependencies]