stratasynth-cli 0.2.0__tar.gz

stratasynth_cli-0.2.0/.gitignore

@@ -0,0 +1,63 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+venv/
+env/
+.env
+.env.test
+*.egg-info/
+dist/
+build/
+.uv/
+
+# Node
+node_modules/
+dist/
+.next/
+
+# Playwright
+apps/frontend/e2e/report/
+apps/frontend/test-results/
+apps/frontend/playwright-report/
+out/
+.turbo/
+
+# AWS / Serverless
+.serverless/
+*.zip
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Archivos temporales de scripting con Claude Code
+_*.json
+_*.py
+_*.js
+_token*.txt
+_resp*.json
+_login*.json
+_payload*.json
+
+# Secretos y configuración local
+*.local
+.env.test
+.env.production.local
+apps/backend/.env
+apps/frontend/.env.local
+apps/frontend/.env.production
+Docs/CREDENTIALS_DEV.md
+docs/CREDENTIALS_MARKETPULSE.md
+
+# Parquet (no en layers — archivos locales de desarrollo)
+*.parquet
+
+# OS
+.DS_Store
+Thumbs.db

stratasynth_cli-0.2.0/CLAUDE.md

@@ -0,0 +1,54 @@
+# CLAUDE.md — StrataSynth CLI
+
+## Stack
+- Python 3.12
+- uv como package manager
+- Distribuido en PyPI como `stratasynth-cli`
+- Click para CLI framework
+
+## Instalación y uso
+```bash
+pip install stratasynth-cli   # producción
+uv run stratasynth --help      # desarrollo local
+
+# Dataset Engine:
+stratasynth auth login --api-key ss_live_...
+stratasynth generate --scenario FAM-01 --count 100 --complexity 3 --adapter llamaindex_nodes
+stratasynth jobs list
+stratasynth jobs status {jobId}
+stratasynth personas generate --archetype working_mother --complexity 4
+stratasynth evaluate start --job-id {jobId}
+stratasynth evaluate results --eval-id {evalId}
+stratasynth evaluate results --eval-id {evalId} --json
+# Humans Engine:
+stratasynth humans generate -d '{"age_range":"28-40","gender":"female","country":"ES"}' -c '{"category":"yogures funcionales","study_brands":["Activia"]}'
+stratasynth humans status --id hu_xxx
+stratasynth humans batch --count 3 -d '{"age_range":"25-45","country":"ES"}'
+stratasynth humans interview --id hu_xxx --interview-style narrative --verbosity high
+```
+
+## Estructura
+```
+stratasynth_cli/
+  commands/
+    auth.py        ← login, logout, whoami
+    generate.py    ← generate dataset
+    jobs.py        ← list, status, download
+    personas.py    ← generate, view
+    evaluate.py    ← start evaluation, results
+    scenarios.py   ← list scenarios
+    humans.py      ← generate, status, batch, interview (Humans Engine)
+  config.py        ← Dataset + Humans API URLs, token management
+  output.py        ← Rich formatting, progress bars
+  __main__.py      ← CLI entry point
+```
+
+## Token management
+- Token guardado en `~/.stratasynth/config.json` (no en código)
+- TTL de 24h — regenerar con `stratasynth auth login`
+
+## Deploy
+```bash
+uv build   # genera dist/
+uv publish # publicar a PyPI
+```

stratasynth_cli-0.2.0/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: stratasynth-cli
+Version: 0.2.0
+Summary: CLI for StrataSynth — synthetic conversational data with psychological depth
+Project-URL: Homepage, https://stratasynth.com
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.0

stratasynth_cli-0.2.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["stratasynth_cli"]
+
+[project]
+name = "stratasynth-cli"
+version = "0.2.0"
+description = "CLI for StrataSynth — synthetic conversational data with psychological depth"
+requires-python = ">=3.12"
+dependencies = [
+    "click>=8.1.0",
+    "httpx>=0.27.0",
+    "rich>=13.7.0",
+    "pydantic>=2.6.0",
+    "python-dotenv>=1.0.0",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+stratasynth = "stratasynth_cli.__main__:cli"
+
+[project.urls]
+Homepage = "https://stratasynth.com"

stratasynth_cli-0.2.0/stratasynth_cli/commands/auth.py

@@ -0,0 +1,54 @@
+"""
+CLI auth commands — login, logout, whoami.
+
+$ stratasynth auth login --api-key ss_live_...
+$ stratasynth auth logout
+"""
+import click
+import httpx
+from stratasynth_cli.config import get_api_url, save_token, clear_token, get_token
+from stratasynth_cli.output import print_error, print_success, print_login_success, print_whoami
+
+
+@click.group()
+def auth():
+    """Authentication commands."""
+    pass
+
+
+@auth.command()
+@click.option("--api-key", required=True, envvar="STRATASYNTH_API_KEY", help="Your StrataSynth API key (ss_live_...)")
+def login(api_key):
+    """Login with your API key."""
+    try:
+        response = httpx.post(
+            f"{get_api_url()}/auth/token",
+            json={"api_key": api_key},
+            timeout=10,
+        )
+        if response.status_code == 200:
+            token = response.json()["data"]["token"]
+            save_token(token)
+            print_login_success()
+        else:
+            msg = response.json().get("message", "Invalid API key")
+            print_error(f"Login failed: {msg}")
+            raise SystemExit(1)
+    except SystemExit:
+        raise
+    except Exception as e:
+        print_error(f"Connection error: {e}")
+        raise SystemExit(1)
+
+
+@auth.command()
+def logout():
+    """Logout and remove saved token."""
+    clear_token()
+    print_success("Logged out.")
+
+
+@auth.command()
+def whoami():
+    """Show current authentication status."""
+    print_whoami(authenticated=bool(get_token()))

stratasynth_cli-0.2.0/stratasynth_cli/commands/evaluate.py

@@ -0,0 +1,111 @@
+"""
+CLI evaluate commands — evaluar output y ver resultados.
+
+$ stratasynth evaluate start --job-id job_xxx
+$ stratasynth evaluate results --eval-id eval_xxx
+$ stratasynth evaluate results --eval-id eval_xxx --json
+"""
+import json
+import time
+
+import click
+import httpx
+from stratasynth_cli.config import get_api_url, get_token
+from stratasynth_cli.output import (
+    print_error,
+    print_eval_started,
+    print_eval_results,
+)
+
+
+@click.group()
+def evaluate():
+    """Evaluate your system's output against StrataSynth ground truth."""
+    pass
+
+
+@evaluate.command()
+@click.option("--job-id",     required=True, help="StrataSynth job ID (el dataset generado)")
+@click.option("--output-url", default=None,  help="S3 key del output de tu sistema a evaluar (opcional)")
+@click.option("--json",       "json_output", is_flag=True, help="Output as JSON for scripting")
+def start(job_id, output_url, json_output):
+    """Start a new evaluation for a completed job."""
+    token = get_token()
+    if not token:
+        print_error("Not authenticated. Run: stratasynth auth login --api-key ss_live_...")
+        raise SystemExit(1)
+
+    payload: dict = {"jobId": job_id}
+    if output_url:
+        payload["system_output"] = output_url
+
+    response = httpx.post(
+        f"{get_api_url()}/evaluate",
+        json=payload,
+        headers={"Authorization": f"Bearer {token}"},
+        timeout=10,
+    )
+    if response.status_code in (200, 201):
+        data = response.json()["data"]
+        if json_output:
+            click.echo(json.dumps(data))
+        else:
+            print_eval_started(data["evalId"])
+    else:
+        print_error(response.json().get("message", "Unknown error"))
+        raise SystemExit(1)
+
+
+@evaluate.command()
+@click.option("--eval-id",  required=True, help="Evaluation ID from 'evaluate start'")
+@click.option("--wait/--no-wait", default=True, help="Wait for evaluation to complete (default: wait)")
+@click.option("--json",     "json_output", is_flag=True, help="Output as JSON for scripting")
+def results(eval_id, wait, json_output):
+    """Get evaluation results (polls until COMPLETED if --wait)."""
+    token = get_token()
+    if not token:
+        print_error("Not authenticated. Run: stratasynth auth login --api-key ss_live_...")
+        raise SystemExit(1)
+
+    headers = {"Authorization": f"Bearer {token}"}
+    api_url = get_api_url()
+
+    max_polls = 24 if wait else 1
+    result = None
+
+    for _ in range(max_polls):
+        response = httpx.get(
+            f"{api_url}/evaluate/{eval_id}",
+            headers=headers,
+            timeout=10,
+        )
+
+        if response.status_code == 404:
+            print_error(f"Evaluation {eval_id} not found.")
+            raise SystemExit(1)
+        if response.status_code != 200:
+            print_error(f"API error: {response.status_code} — {response.text}")
+            raise SystemExit(1)
+
+        result = response.json()["data"]
+        status = result.get("status", "UNKNOWN")
+
+        if status in ("COMPLETED", "FAILED"):
+            break
+
+        if wait:
+            time.sleep(5)
+
+    if json_output:
+        click.echo(json.dumps(result))
+        return
+
+    if result.get("status") == "FAILED":
+        print_error(f"Evaluation {eval_id} failed.")
+        raise SystemExit(1)
+
+    if result.get("status") != "COMPLETED":
+        print_error(f"Evaluation {eval_id} still {result.get('status')}. Use --wait to poll.")
+        raise SystemExit(1)
+
+    print_eval_results(result)

stratasynth_cli-0.2.0/stratasynth_cli/commands/generate.py

@@ -0,0 +1,112 @@
+"""
+CLI generate command — crear job de generación de dataset.
+"""
+import json
+import click
+import httpx
+from stratasynth_cli.config import get_api_url, get_token
+from stratasynth_cli.output import print_error, print_job_created
+
+
+VALID_ADAPTERS = [
+    "flat_jsonl", "llamaindex_nodes", "openai_finetuning",
+    "langchain_memory", "huggingface_dataset", "csv_tabular",
+    "anthropic_claude", "luminoracore", "custom_adapter",
+]
+VALID_MEDIUMS = ["text_chat", "voice_call", "face_to_face", "email", "unspecified"]
+VALID_LOCATIONS = ["home", "work", "public", "unspecified"]
+VALID_TURN_LENGTHS = ["brief", "natural", "extended"]
+VALID_LANGUAGES = ["en", "es", "de", "fr"]
+
+
+_GENERATE_EPILOG = """
+\b
+SCENARIOS (run `stratasynth scenarios list` to see all 12):
+  FAM-01  Family — mother/child accumulated tension
+  FAM-02  Family — father/daughter reconnection after estrangement
+  ROM-01  Romance — couple in post-relocation crisis
+  ROM-02  Romance — relationship slowly ending
+  PRO-01  Professional — silent burnout
+  VIT-01  Vital — grief after loss of parent
+
+\b
+ADAPTERS:
+  flat_jsonl          Raw JSON per turn. Use for custom pipelines.
+  openai_finetuning   ChatML format, ready for OpenAI fine-tuning API.
+  llamaindex_nodes    TextNode objects for LlamaIndex / vector stores.
+  langchain_memory    HumanMessage/AIMessage for LangChain.
+  huggingface_dataset Arrow/Parquet, load with datasets.load_dataset().
+  anthropic_claude    Anthropic Messages API format.
+  csv_tabular         One row per turn — good for pandas / Excel.
+
+\b
+EXAMPLES:
+  # 500 conversations for OpenAI fine-tuning, family conflict
+  stratasynth generate --scenario FAM-01 --count 500 --adapter openai_finetuning
+
+  # Spanish romantic conflict, text chat context, brief turns
+  stratasynth generate --scenario ROM-02 --count 200 \\
+    --language es --medium text_chat --turn-length brief
+
+  # Reproducible dataset (same seed = identical output every time)
+  stratasynth generate --scenario PRO-01 --count 1000 --seed 42
+
+  # Pipe job ID to another command
+  JOB=$(stratasynth generate --scenario FAM-02 --count 50 --json | jq -r '.jobId')
+  stratasynth jobs status --job-id $JOB
+"""
+
+
+@click.command(epilog=_GENERATE_EPILOG)
+@click.option("--scenario",    required=True, help="Scenario ID. Run `stratasynth scenarios list` to see all 12.")
+@click.option("--count",       default=100,   show_default=True, help="Number of conversations to generate.")
+@click.option("--complexity",  default=3,     show_default=True, type=click.IntRange(1, 5), help="PsycheGraph depth: 1=minimal, 3=standard (recommended), 5=deep.")
+@click.option("--adapter",     default="flat_jsonl", show_default=True, type=click.Choice(VALID_ADAPTERS), help="Output format (see ADAPTERS below).")
+@click.option("--language",    default="en",  show_default=True, type=click.Choice(VALID_LANGUAGES), help="Language for generated conversations.")
+@click.option("--medium",      default="unspecified", show_default=True, type=click.Choice(VALID_MEDIUMS), help="Conversation channel — affects tone and style of generated text.")
+@click.option("--location",    default="unspecified", show_default=True, type=click.Choice(VALID_LOCATIONS), help="Physical context injected into each turn.")
+@click.option("--turn-length", default="natural", show_default=True, type=click.Choice(VALID_TURN_LENGTHS), help="Turn length: brief (1-2 sentences), natural (3-5), extended (paragraphs).")
+@click.option("--noise",       default=0.12,  show_default=True, type=click.FloatRange(0.0, 0.5), help="Noise injection rate: fraction of turns with intentional noise (0.0-0.5).")
+@click.option("--seed",        default=None,  type=int, help="Random seed for reproducible generation.")
+@click.option("--json",        "json_output", is_flag=True, help="Output as JSON (for scripting / pipes).")
+def generate(scenario, count, complexity, adapter, language, medium, location, turn_length, noise, seed, json_output):
+    """Generate a synthetic conversational dataset."""
+    token = get_token()
+    if not token:
+        print_error("Not authenticated. Run: stratasynth auth login --api-key ss_live_...")
+        raise SystemExit(1)
+
+    payload = {
+        "scenario_id": scenario,
+        "conversation_count": count,
+        "complexity": complexity,
+        "adapter": adapter,
+        "language": language,
+        "noise_pct": noise,
+        "turn_length_target": turn_length,
+        "conversation_setting": {"medium": medium, "location": location},
+    }
+    if seed is not None:
+        payload["seed"] = seed
+
+    try:
+        response = httpx.post(
+            f"{get_api_url()}/jobs/dataset",
+            json=payload,
+            headers={"Authorization": f"Bearer {token}"},
+            timeout=10,
+        )
+        if response.status_code == 200:
+            data = response.json()["data"]
+            if json_output:
+                click.echo(json.dumps(data))
+            else:
+                print_job_created(data)
+        else:
+            print_error(f"Error {response.status_code}: {response.text}")
+            raise SystemExit(1)
+    except SystemExit:
+        raise
+    except Exception as e:
+        print_error(f"Connection error: {e}")
+        raise SystemExit(1)