adding json flag

src/nskit/cli/app.py

@@ -117,7 +117,7 @@
             _print_tree(entry, console, prefix + ("    " if is_last else "│   "))
 
 
 def create_cli(
     recipe_entrypoint: str,
     app_name: str = "nskit",
     app_help: str = "CLI for managing nskit recipes.",
@@ -150,8 +150,12 @@
         backend = None
 
     @app.command(name="list", help="List available recipes.")
-    def list_recipes():
+    def list_recipes(
+        json_output: Annotated[bool, typer.Option("--json", help="Output as JSON array of recipe names.")] = False,
+    ):
         """List available recipes from backend or installed entry points."""
+        import json as json_mod
+
         if client:
             recipes = client.list_recipes()
         else:
@@ -161,6 +165,10 @@
             names = get_extension_names(recipe_entrypoint)
             recipes = [RecipeInfo(name=n, versions=["local"]) for n in names]
 
+        if json_output:
+            print(json_mod.dumps(sorted(r.name for r in recipes)))
+            return
+
         if not recipes:
             rich_print("[yellow]No recipes found[/yellow]")
             return

tests/unit/test_cli/test_app.py

@@ -229,3 +229,46 @@ def test_no_push_when_declined(self, tmp_path):
         _commit_and_maybe_push(project, "proj", "", False, mock_vcs, console)
 
         mock_vcs.create.assert_not_called()
+
+
+class TestListJsonFlag:
+    """``list --json`` outputs a machine-readable JSON array."""
+
+    def test_list_json_exits_zero(self, runner):
+        app = create_cli(recipe_entrypoint="nskit.recipes")
+        result = runner.invoke(app, ["list", "--json"])
+        assert result.exit_code == 0, result.output
+
+    def test_list_json_outputs_valid_json(self, runner):
+        import json
+
+        app = create_cli(recipe_entrypoint="nskit.recipes")
+        result = runner.invoke(app, ["list", "--json"])
+        data = json.loads(result.output)
+        assert isinstance(data, list)
+
+    def test_list_json_contains_registered_recipes(self, runner):
+        import json
+
+        app = create_cli(recipe_entrypoint="nskit.recipes")
+        result = runner.invoke(app, ["list", "--json"])
+        data = json.loads(result.output)
+        assert "python_package" in data
+
+    def test_list_json_is_sorted(self, runner):
+        import json
+
+        app = create_cli(recipe_entrypoint="nskit.recipes")
+        result = runner.invoke(app, ["list", "--json"])
+        data = json.loads(result.output)
+        assert data == sorted(data)
+
+    def test_list_without_json_shows_table(self, runner):
+        """Without --json, output is a rich table (not JSON)."""
+        import json
+
+        app = create_cli(recipe_entrypoint="nskit.recipes")
+        result = runner.invoke(app, ["list"])
+        assert result.exit_code == 0
+        with pytest.raises(json.JSONDecodeError):
+            json.loads(result.output)