katalyst-taxonomy-cli 2.0.1a7__tar.gz → 2.0.1a9__tar.gz

{katalyst_taxonomy_cli-2.0.1a7 → katalyst_taxonomy_cli-2.0.1a9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: katalyst-taxonomy-cli
-Version: 2.0.1a7
+Version: 2.0.1a9
 Summary: CLI for katalyst-taxonomy — the kata command
 Author: eSimplicity
 License: Proprietary

{katalyst_taxonomy_cli-2.0.1a7 → katalyst_taxonomy_cli-2.0.1a9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "katalyst-taxonomy-cli"
-version = "2.0.1a7"
+version = "2.0.1a9"
 description = "CLI for katalyst-taxonomy — the kata command"
 license = { text = "Proprietary" }
 requires-python = ">=3.12"
@@ -41,3 +41,37 @@ packages = ["src/katalyst_taxonomy_cli"]
 
 [tool.hatch.build.targets.wheel.sources]
 "src" = ""
+
+[dependency-groups]
+dev = [
+    "katalyst-test-bundle",
+    "pytest>=8.2",
+    "pytest-cov>=5.0",
+    "ruff>=0.5",
+    "pyright>=1.1",
+]
+
+[tool.pytest.ini_options]
+addopts = ["-ra"]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+# As at the repository root, no first-party sources: every import sorts as a third-party one.
+src = []
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "B", "I"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.pyright]
+include = ["src", "tests"]
+exclude = ["**/node_modules", "**/__pycache__", "**/.*"]
+venvPath = "."
+venv = ".venv"
+pythonVersion = "3.12"
+typeCheckingMode = "strict"

katalyst_taxonomy_cli-2.0.1a9/src/Justfile

@@ -0,0 +1,2 @@
+# katalyst-taxonomy-cli: the Circuit's recipes, run from the package directory (cli/).
+import '../../scripts/package.just'

{katalyst_taxonomy_cli-2.0.1a7 → katalyst_taxonomy_cli-2.0.1a9}/src/katalyst_taxonomy_cli/_wiring.py

@@ -107,16 +107,21 @@ def load_registry(ctx: CliContext) -> BackendRegistry:
     """Load the backend registry for *ctx*, honoring the active profile."""
     from katalyst_taxonomy.config.backends import load_backends
 
-    return load_backends(ctx.cwd, profile=ctx.profile)
+    registry = load_backends(ctx.cwd, profile=ctx.profile)
+    return registry.with_variants(ctx.variants) if ctx.variants else registry
 
 
-def _registry(ctx: CliContext) -> BackendRegistry:
+def registry_for(ctx: CliContext) -> BackendRegistry:
+    """:func:`load_registry`, with a configuration error as a user error, not a traceback."""
     try:
         return load_registry(ctx)
     except Exception as exc:  # noqa: BLE001 - config errors are user errors, not tracebacks
         raise click.ClickException(str(exc)) from exc
 
 
+_registry = registry_for
+
+
 def _named(registry: BackendRegistry, target: str | None, address: str) -> tuple[str | None, str]:
     """The backend named by *address* or *target*, and the bare FQTN.
 
@@ -169,6 +174,7 @@ def resolve_backend(
             raise click.ClickException(
                 f"Name the backend to use with --backend. This profile reads: {reads}."
             )
+        registry.check_variant_write(name)
         backend = registry.get(name)
     except BackendAddressError as exc:
         raise click.ClickException(str(exc)) from exc

{katalyst_taxonomy_cli-2.0.1a7 → katalyst_taxonomy_cli-2.0.1a9}/src/katalyst_taxonomy_cli/app.py

@@ -56,6 +56,7 @@ class KataGroup(click.Group):
         from katalyst_taxonomy.config.profiles import UnknownProfileError
         from katalyst_taxonomy.domain.homes import HomeError
         from katalyst_taxonomy.domain.permissions import PermissionDeniedError
+        from katalyst_taxonomy.domain.variants import VariantError
         from katalyst_taxonomy.plugins.errors import PluginError
         from katalyst_taxonomy.ports.backend import UnsupportedCapabilityError
 
@@ -67,6 +68,10 @@ class KataGroup(click.Group):
             # "Backend 'x' does not support UPDATE": a fact about the backend the user
             # named, with the capabilities it does have — not a traceback.
             raise click.ClickException(str(exc)) from exc
+        except VariantError as exc:
+            # A variant that is not there, is stale, or a write that names several: the
+            # message says which and what to do.
+            raise click.ClickException(str(exc)) from exc
         except PluginError as exc:
             # A plugin that will not activate is a user-fixable configuration or
             # environment problem, not a bug in this process — it gets the same
@@ -413,6 +418,7 @@ def tax(
         profile=profile,
     )
     _register_source_providers(profile)
+    _report_pending_sources()
     if ctx.invoked_subcommand == "plugin":
         # `kata tax plugin remove` is how a broken source plugin is taken out; a plugin
         # that will not activate must not stop the command that removes it.
@@ -469,6 +475,24 @@ def _register_source_providers(profile: str | None) -> None:
     ensure_source_providers(True, profile=profile)
 
 
+def _report_pending_sources() -> None:
+    """Say which plugins and schema bundles a sourced profile declares that are not loaded.
+
+    Loading one runs its code, so it waits for the user to accept it
+    (:mod:`katalyst_taxonomy.services.source_consent`). This only reports, on stderr and
+    never failing the command; ``kata config sync`` is where it is accepted.
+    """
+    from katalyst_taxonomy.adapters.orchestration import pending_source_declarations
+
+    for declaration in pending_source_declarations():
+        click.echo(
+            f"{declaration.describe()}; it is not loaded, because it runs code. Run "
+            f"'{('kata config sync ' + declaration.profile).strip()}' to review and accept it, or "
+            f"'{declaration.install_command} {declaration.shown_source}' to install it yourself.",
+            err=True,
+        )
+
+
 # ---------------------------------------------------------------------------
 # Plugin activation (#219)
 # ---------------------------------------------------------------------------
@@ -547,6 +571,7 @@ def _register_core_commands() -> None:
         status,
         sync,
         update,
+        variant,
         versions,
     )
     from .commands import (
@@ -596,6 +621,7 @@ def _register_core_commands() -> None:
     tax.add_command(plugin.plugin)
     tax.add_command(export.export)
     tax.add_command(backend.backend)
+    tax.add_command(variant.variant)
     tax.add_command(remove.remove)
     tax.add_command(rescaffold.rescaffold)
 

{katalyst_taxonomy_cli-2.0.1a7 → katalyst_taxonomy_cli-2.0.1a9}/src/katalyst_taxonomy_cli/commands/bundle.py

@@ -45,13 +45,11 @@ def add_bundle(ctx: CliContext, source_uri: str, yes: bool) -> None:
     that depend solely on katalyst-engine are accepted.
     """
     from katalyst_taxonomy.services.bundle_service import install_bundle
+    from katalyst_taxonomy.services.source_consent import CONFIRM_PROMPT, consent_notice
 
     if not yes:
-        click.echo(
-            "Installing a remote bundle path-imports and executes its Python code.\n"
-            f"Source: {source_uri}"
-        )
-        if not click.confirm("Proceed?", default=False):
+        click.echo(consent_notice("schemas", source_uri))
+        if not click.confirm(CONFIRM_PROMPT, default=False):
             ctx.output.echo("Aborted.")
             raise SystemExit(1)
 
@@ -90,6 +88,10 @@ def list_bundles(ctx: CliContext) -> None:
             f"  {b.name or b.fqn or '(unnamed)'}{version}  [{shown_source(b.source)}]  "
             f"{pin}, {b.state}  kinds: {kinds}"
         )
+        if b.error:
+            ctx.output.echo(f"    error: {b.error}")
+    if any(b.state == "failed" for b in bundles):
+        ctx.output.echo("A failed bundle is skipped. `kata tax bundle remove <name>` drops it.")
 
 
 @bundle.command("remove")

{katalyst_taxonomy_cli-2.0.1a7 → katalyst_taxonomy_cli-2.0.1a9}/src/katalyst_taxonomy_cli/commands/config_profile.py

@@ -8,21 +8,22 @@ MCP ``config_profile_*`` tools and REST ``/config/profiles`` call::
 
     kata config profile list | show NAME
     kata config profile create NAME [--copy-from P | --source URI [--source-profile P]
-                                     [--token-env VAR]] [--use]
+                                     [--token-env VAR] [--sync-every D]] [--use]
     kata config profile delete NAME [--force]
     kata config profile rename NAME NEW_NAME
     kata config profile use NAME
     kata config profile set-list PROFILE {schemas|plugins|templates} [NAMES...] [--all]
     kata config profile set-source-options NAME [--source-profile P] [--token-env VAR]
-                                     [--unset profile|token_env]
+                                     [--sync-every D] [--unset profile|token_env|sync]
     kata config profile backend list PROFILE | show PROFILE NAME
     kata config profile backend add PROFILE NAME --type TYPE [settings]
     kata config profile backend set PROFILE NAME [settings] [--unset KEY]
     kata config profile backend remove PROFILE NAME [--force]
 
 Every change is saved as a whole-document save is: validated, the previous file kept
-as ``config.yaml.bak``, and the profile's repositories made to match (declared
-templates installed into a new filesystem backend; nothing deleted on removing one).
+as ``config.yaml.bak``, and its plugin and schema sources fetched and every source
+pinned. A change writes to no repository: a repository that lacks a template its profile
+uses is named, with the ``kata tax add`` command that installs it.
 
 A profile created with ``--source`` is read from elsewhere (see ``kata config sync``):
 its backends and lists are refused here, naming the source to change instead. Which
@@ -185,6 +186,9 @@ def _report(out: OutputPort, change: ProfileChange, message: str, fmt: str) -> N
     if payload["backupPath"]:
         out.info(f"Previous file kept as {payload['backupPath']}")
     for step in payload["synced"]:
+        if step["action"] == "missing":
+            out.info(f"{step['backend']}: {step['detail']}")
+            continue
         where = f" in {step['backend']}" if step["backend"] else ""
         line = f"{step['action']} {step['kind']} {step['name']}{where}"
         detail = f": {step['detail']}" if step["detail"] else ""
@@ -260,6 +264,10 @@ def profile_list(selected: str | None, fmt: str) -> None:
             ("config file", payload["configFile"]),
         ]
     )
+    if payload.get("sharedConfiguration"):
+        out.info(f"Using the shared configuration {payload['sharedConfiguration']}.")
+    if payload.get("activeProblem"):
+        out.warning(payload["activeProblem"])
 
 
 @profile.command("show")
@@ -334,6 +342,12 @@ def profile_show(name: str, fmt: str) -> None:
     metavar="VAR",
     help="A kata API source: the environment variable holding its bearer token.",
 )
+@click.option(
+    "--sync-every",
+    default=None,
+    metavar="DURATION",
+    help="Update a sourced profile by itself: 30m, 1h, 1d (not for a commit).",
+)
 @click.option("--use", "activate", is_flag=True, help="Make it the active profile.")
 @click.option("--format", "fmt", type=_FORMAT_CHOICE, default="text")
 def profile_create(
@@ -342,6 +356,7 @@ def profile_create(
     source: str | None,
     source_profile: str | None,
     token_env: str | None,
+    sync_every: str | None,
     activate: bool,
     fmt: str,
 ) -> None:
@@ -359,6 +374,7 @@ def profile_create(
             source=source,
             source_profile=source_profile,
             token_env=token_env,
+            sync_every=sync_every,
         )
     )
     out = _output()
@@ -435,30 +451,41 @@ def profile_set_list(
     metavar="VAR",
     help="A kata API source: the environment variable holding its bearer token.",
 )
+@click.option(
+    "--sync-every",
+    default=None,
+    metavar="DURATION",
+    help="Update the profile by itself: 30m, 1h, 1d (not for a commit).",
+)
 @click.option(
     "--unset",
     "unset",
     multiple=True,
-    type=click.Choice(["profile", "token_env"]),
-    help="Remove an option: profile (then the source's profile named NAME) or token_env.",
+    type=click.Choice(["profile", "token_env", "sync"]),
+    help="Remove an option: profile (then the source's profile named NAME), token_env or sync.",
 )
 @click.option("--format", "fmt", type=_FORMAT_CHOICE, default="text")
 def profile_set_source_options(
     name: str,
     source_profile: str | None,
     token_env: str | None,
+    sync_every: str | None,
     unset: tuple[str, ...],
     fmt: str,
 ) -> None:
-    """Change which profile of its source sourced profile NAME is, or its token variable.
+    """Change which profile of its source sourced profile NAME is, its token variable, or how often it updates itself.
 
     Only this file's reference changes; 'kata config sync NAME' fetches what it names.
     """
-    if source_profile is None and token_env is None and not unset:
-        raise click.UsageError("Give --source-profile, --token-env or --unset.")
+    if source_profile is None and token_env is None and sync_every is None and not unset:
+        raise click.UsageError("Give --source-profile, --token-env, --sync-every or --unset.")
     change: ProfileChange = _run(
         lambda: _service().set_source_options(
-            name, source_profile=source_profile, token_env=token_env, unset=unset
+            name,
+            source_profile=source_profile,
+            token_env=token_env,
+            sync_every=sync_every,
+            unset=unset,
         )
     )
     out = _output()
@@ -540,8 +567,9 @@ def backend_add(
 ) -> None:
     """Add backend NAME of --type to PROFILE, with its settings as flags.
 
-    Only the settings the type reads are accepted. A filesystem backend added to a
-    profile gets the declared templates that profile uses installed into it.
+    Only the settings the type reads are accepted. Adding a backend writes to no
+    repository: one that lacks a declared template its profile uses is named, with the
+    ``kata tax add --bundle`` command that installs it.
     """
     from katalyst_taxonomy.services.profiles import backend_entry