TFG Integration

.env.example

@@ -2,4 +2,6 @@ WORKING_DIR=/workspace
 GITHUB_USER=
 GITHUB_TOKEN=
 TWINE_USERNAME=__token__
-TWINE_PASSWORD=
+TWINE_PASSWORD=
+SPLENT_API_URL=http://host.docker.internal:5000
+SPLENT_API_TOKEN=

.githooks/commit-msg

@@ -0,0 +1,29 @@
+#!/bin/sh
+#
+# Hook commit-msg para validar el formato de los mensajes de commit
+# Se ejecuta automáticamente durante un `git commit`
+
+set -eu
+
+# Obtener el mensaje del commit
+commit_subject=$(sed -n '1p' "$1")
+
+# Ignorar ciertos tipos de commits automáticos
+case "$commit_subject" in
+  Merge\ *|Revert\ *|Pull\ *|fixup\!*|squash\!*)
+    exit 0
+    ;;
+esac
+
+# Expresión regular para el formato esperado en los mensajes
+commit_regex='^(feat|fix|docs|style|refactor|test|chore|build|ci|perf|revert)(\([a-z0-9._/-]+\))?: .{5,}$'
+
+# Comprobar si el mensaje de commit cumple con el formato
+if echo "$commit_subject" | grep -Eq "$commit_regex"; then
+    echo "✅ ¡El mensaje de commit es válido!"
+else
+    echo "❌ El mensaje de commit no es válido."
+    echo "Formato esperado: tipo(alcance): descripcion"
+    echo "Ejemplo: feat(cli): add product env merge command"
+    exit 1
+fi

.github/workflows/ci-commits.yml

@@ -0,0 +1,22 @@
+name: Commits Syntax Checker
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - main
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+jobs:
+  check:
+    name: Conventional Commits
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Validate commit messages
+        uses: webiny/action-conventional-commits@v1.3.0

.gitignore

@@ -6,4 +6,5 @@ build
 
 __pycache__/
 *.pyc
-*.pyo
+*.pyo
+.env

README.md

@@ -9,6 +9,102 @@ make setup        # Prepare .env, start Docker, enter CLI container
 splent --help     # See all available commands
 ```
 
+## Local marketplace flow
+
+When using the CLI from inside the SPLENT Docker container, `127.0.0.1`
+points to the container itself. If your marketplace/API is running on your
+host machine, use `host.docker.internal`.
+
+The marketplace/API must expose:
+
+```text
+GET  /api/auth/check
+POST /api/packages
+GET  /api/packages
+```
+
+For local development with token authentication, configure the API with:
+
+```env
+SPLENT_API_TOKEN=mi-token-secreto-local
+```
+
+Then, from the app workspace/container, log in:
+
+```bash
+splent marketplace:login --url http://host.docker.internal:5000 --token mi-token-secreto-local
+```
+
+`marketplace:login` requires a token. You can also put the token in `.env`
+first and then run login without flags:
+
+```env
+SPLENT_API_URL=http://host.docker.internal:5000
+SPLENT_API_TOKEN=mi-token-secreto-local
+```
+
+```bash
+splent marketplace:login
+```
+
+This validates the token and saves the marketplace configuration in the
+workspace `.env`:
+
+```env
+SPLENT_API_URL=http://host.docker.internal:5000
+SPLENT_API_TOKEN=mi-token-secreto-local
+SPLENT_MARKETPLACE_AUTH=true
+```
+
+`SPLENT_MARKETPLACE_AUTH=true` means the token has been validated with
+`GET /api/auth/check`. Marketplace feature commands that read or write package
+metadata require this validated login state and a configured `SPLENT_API_TOKEN`:
+
+```text
+feature:search
+feature:info
+feature:install
+feature:clone
+feature:versions
+feature:publish
+```
+
+To log out:
+
+```bash
+splent marketplace:logout
+```
+
+Logout keeps `SPLENT_API_URL` and `SPLENT_API_TOKEN`, but marks the marketplace
+session as inactive:
+
+```env
+SPLENT_API_URL=http://host.docker.internal:5000
+SPLENT_API_TOKEN=mi-token-secreto-local
+SPLENT_MARKETPLACE_AUTH=false
+```
+
+Run `splent marketplace:login` again to re-validate the saved token.
+
+Create a feature and publish it:
+
+```bash
+splent feature:create splent-io/splent_feature_demo_marketplace --type light
+splent feature:publish splent-io/splent_feature_demo_marketplace
+```
+
+Verify that it appears in the marketplace:
+
+```bash
+splent feature:search demo
+```
+
+You can also publish with an explicit version:
+
+```bash
+splent feature:publish splent-io/splent_feature_demo_marketplace@0.1.0
+```
+
 ## Requirements
 
 - Docker + Docker Compose

docker/docker-compose.yml

@@ -5,6 +5,8 @@ services:
     build:
       context: ../../
       dockerfile: splent_cli/docker/images/Dockerfile.cli
+    env_file:
+      - ../.env
     environment:
       HOST_UID: ${HOST_UID:-1000}
       HOST_GID: ${HOST_GID:-1000}
@@ -21,4 +23,4 @@ services:
 
 networks:
   splent_network:
-    name: splent_network
+    name: splent_network

makefiles/Makefile.setup

@@ -1,4 +1,8 @@
+ifeq ($(shell docker compose version >/dev/null 2>&1; echo $$?),0)
 SPLENT_DOCKER_COMPOSE = docker compose -f docker/docker-compose.yml
+else
+SPLENT_DOCKER_COMPOSE = docker-compose -f docker/docker-compose.yml
+endif
 HOST_PROJECT_DIR := $(shell cd .. && pwd)
 
 .PHONY: setup setup-rebuild env-prepare docker-up cli-enter

scripts/setup_prompt.sh

@@ -53,6 +53,12 @@ splent() {
   elif [ "$1" = "product:deselect" ]; then
     shift
     eval "$(command splent product:deselect --shell "$@")"
+  elif [ "$1" = "marketplace:login" ]; then
+    shift
+    eval "$(command splent marketplace:login --shell "$@")"
+  elif [ "$1" = "marketplace:logout" ]; then
+    shift
+    eval "$(command splent marketplace:logout --shell "$@")"
   else
     command splent "$@"
   fi
@@ -80,4 +86,4 @@ _splent_completion() {
 complete -o nosort -F _splent_completion splent
 
 # --- END SPLENT CLI ---
-EOF
+EOF

src/splent_cli/cli.py

@@ -1,13 +1,13 @@
 import os
 
 import click
-from dotenv import load_dotenv
 
+from splent_cli.services.env import load_cli_env
 from splent_cli.utils.dynamic_imports import get_app
 from splent_cli.utils.command_loader import load_commands
 from splent_cli.utils.db_utils import check_db_connection
 
-load_dotenv()
+load_cli_env()
 
 
 class SPLENTCLI(click.Group):
@@ -48,9 +48,11 @@ def _load_feature_commands(self) -> dict[str, click.BaseCommand]:
                     group = click.Group(
                         name=f"feature:{feature_short}",
                         help=f"Commands contributed by splent_feature_{feature_short}.",
-                        short_help=f"Subcommands: {cmd_names}"
-                        if cmd_names
-                        else f"Commands from splent_feature_{feature_short}.",
+                        short_help=(
+                            f"Subcommands: {cmd_names}"
+                            if cmd_names
+                            else f"Commands from splent_feature_{feature_short}."
+                        ),
                     )
                     group.requires_app = True  # type: ignore[attr-defined]
                     for cmd in commands:
@@ -59,7 +61,9 @@ def _load_feature_commands(self) -> dict[str, click.BaseCommand]:
         except Exception as e:
             if os.getenv("SPLENT_DEBUG"):
                 click.secho(
-                    f"  ⚠ Feature commands not loaded: {e}", fg="yellow", err=True
+                    f"  ⚠ Feature commands not loaded: {e}",
+                    fg="yellow",
+                    err=True,
                 )
         return self._feature_cmds_cache
 
@@ -98,10 +102,17 @@ def format_commands(self, ctx, formatter):
         all_cmds = self.list_commands(ctx)
         feat_cmds = self._load_feature_commands()
         groups = {
+            "🛒 Marketplace": [
+                cmd
+                for cmd in all_cmds
+                if cmd.startswith("marketplace:") or cmd == "feature:search"
+            ],
             "🌿 Feature Management": [
                 cmd
                 for cmd in all_cmds
-                if cmd.startswith("feature:") and cmd not in feat_cmds
+                if cmd.startswith("feature:")
+                and cmd not in feat_cmds
+                and cmd != "feature:search"
             ],
             "🏗️ Product Management": [
                 cmd for cmd in all_cmds if cmd.startswith("product:")
@@ -112,8 +123,12 @@ def format_commands(self, ctx, formatter):
             "🧱 Database": [cmd for cmd in all_cmds if cmd.startswith("db:")],
             "💾 Cache": [cmd for cmd in all_cmds if cmd.startswith("cache:")],
             "🔍 Checks": [cmd for cmd in all_cmds if cmd.startswith("check:")],
-            "📦 Export": [cmd for cmd in all_cmds if cmd.startswith("export:")],
-            "🚀 Release": [cmd for cmd in all_cmds if cmd.startswith("release:")],
+            "📦 Export": [
+                cmd for cmd in all_cmds if cmd.startswith("export:")
+            ],
+            "🚀 Release": [
+                cmd for cmd in all_cmds if cmd.startswith("release:")
+            ],
             "🧰 Utilities": [
                 cmd
                 for cmd in all_cmds
@@ -123,9 +138,12 @@ def format_commands(self, ctx, formatter):
             "🐍 Development & QA": [
                 cmd
                 for cmd in all_cmds
-                if cmd in ("lint", "coverage", "selenium", "locust", "locust:stop")
+                if cmd
+                in ("lint", "coverage", "selenium", "locust", "locust:stop")
+            ],
+            "🔌 Feature Commands": [
+                cmd for cmd in all_cmds if cmd in feat_cmds
             ],
-            "🔌 Feature Commands": [cmd for cmd in all_cmds if cmd in feat_cmds],
         }
         total = 0
         for title, cmds in groups.items():

src/splent_cli/commands/feature/feature_clone.py

@@ -3,7 +3,12 @@
 import subprocess
 import requests
 import click
-from splent_cli.services import context
+from splent_cli.services import context, marketplace
+from splent_cli.services.api_client import (
+    SplentAPIAuthError,
+    SplentAPIError,
+    get_package_by_name,
+)
 from splent_cli.utils.cache_utils import make_feature_readonly
 from splent_cli.utils.feature_utils import normalize_namespace
 
@@ -69,6 +74,46 @@ def _parse_full_name(full_name: str):
     return namespace, repo, version
 
 
+def _feature_api_name(repo: str) -> str:
+    if repo.startswith("splent_feature_"):
+        return repo
+    return f"splent_feature_{repo}"
+
+
+def _resolve_full_name_from_api(full_name: str) -> str:
+    raw = full_name
+    version = None
+    if "@" in raw:
+        raw, version = raw.split("@", 1)
+
+
+    repo = raw.split("/")[-1]
+    api_name = _feature_api_name(repo)
+
+    try:
+        marketplace.require_marketplace_login()
+        package = get_package_by_name(api_name)
+    except SplentAPIAuthError as exc:
+        click.secho(f"❌ {exc}", fg="red")
+        raise SystemExit(1) from exc
+    except SplentAPIError as exc:
+        click.secho(f"❌ {exc}", fg="red")
+        click.echo("   Check SPLENT_API_URL or start the package index.")
+        raise SystemExit(1) from exc
+
+    if not isinstance(package, dict):
+        click.secho("❌ Invalid package response from API.", fg="red")
+        raise SystemExit(1)
+
+    resolved = package.get("full_name")
+    if not isinstance(resolved, str) or "/" not in resolved:
+        resolved = f"splent-io/{package.get('name') or api_name}"
+
+    if version:
+        return f"{resolved}@{version}"
+    return resolved
+
+
 def _validate_identifier_part(value: str, label: str):
     if not re.fullmatch(r"[a-zA-Z0-9_\-\.]+", value):
         raise SystemExit(
@@ -84,17 +129,18 @@ def _validate_identifier_part(value: str, label: str):
 @click.command(
     "feature:clone",
     short_help="Clone a feature into the local cache.",
-    help="Clone a feature into the local cache namespace.",
+    help="Clone a marketplace feature into the local cache.",
 )
 @click.argument("full_name", required=True)
 def feature_clone(full_name):
     """
-    Clone <namespace>/<repo> into:
+    Clone <feature>, <repo> or <namespace>/<repo> into:
       .splent_cache/features/<namespace>/<repo>@<version>
 
     - If version is omitted, fetches the latest tag or 'main'.
     """
 
+    full_name = _resolve_full_name_from_api(full_name)
     namespace, repo, version = _parse_full_name(full_name)
 
     _validate_identifier_part(namespace, "namespace")