licos-dev-cli 0.2.16__tar.gz → 0.2.17__tar.gz

{licos_dev_cli-0.2.16 → licos_dev_cli-0.2.17}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: licos-dev-cli
-Version: 0.2.16
+Version: 0.2.17
 Summary: LICOS Dev CLI - generate files and call model capabilities
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1
-Requires-Dist: licos-dev-sdk>=0.2.17
+Requires-Dist: licos-dev-sdk>=0.2.18

{licos_dev_cli-0.2.16 → licos_dev_cli-0.2.17}/pyproject.toml

@@ -1,19 +1,19 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "licos-dev-cli"
-version = "0.2.16"
-description = "LICOS Dev CLI - generate files and call model capabilities"
-requires-python = ">=3.10"
-dependencies = [
-    "licos-dev-sdk>=0.2.17",
-    "click>=8.1",
-]
-
-[project.scripts]
-licos-dev = "licos_dev_cli.main:cli"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/licos_dev_cli"]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "licos-dev-cli"
+version = "0.2.17"
+description = "LICOS Dev CLI - generate files and call model capabilities"
+requires-python = ">=3.10"
+dependencies = [
+    "licos-dev-sdk>=0.2.18",
+    "click>=8.1",
+]
+
+[project.scripts]
+licos-dev = "licos_dev_cli.main:cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/licos_dev_cli"]

{licos_dev_cli-0.2.16 → licos_dev_cli-0.2.17}/src/licos_dev_cli/main.py

@@ -1,42 +1,42 @@
-"""CLI entry point - wraps licos-dev-sdk functions as click commands."""
-
-from __future__ import annotations
-
+"""CLI entry point - wraps licos-dev-sdk functions as click commands."""
+
+from __future__ import annotations
+
 import sys
 import json
 import os
 from pathlib import Path
 import click
-
-# ── Helpers ──────────────────────────────────────────────────────────────────
-
-def _read_input(input_path: str | None, content: str | None) -> str:
-    """Read content from --input file, --content arg, or stdin."""
-    if input_path:
-        with open(input_path, "r", encoding="utf-8") as f:
-            return f.read()
-    if content:
-        return content
-    if not sys.stdin.isatty():
-        return sys.stdin.read()
-    raise click.UsageError("Provide --input, --content, or pipe via stdin.")
-
-
-def _read_json(input_path: str | None, content: str | None) -> object:
-    """Read and parse JSON from input."""
-    raw = _read_input(input_path, content)
-    return json.loads(raw)
-
-
-def _json_option(value: str | None, name: str) -> dict | list | None:
-    if not value:
-        return None
-    try:
-        return json.loads(value)
-    except json.JSONDecodeError as exc:
-        raise click.BadParameter(f"{name} must be valid JSON") from exc
-
-
+
+# ── Helpers ──────────────────────────────────────────────────────────────────
+
+def _read_input(input_path: str | None, content: str | None) -> str:
+    """Read content from --input file, --content arg, or stdin."""
+    if input_path:
+        with open(input_path, "r", encoding="utf-8") as f:
+            return f.read()
+    if content:
+        return content
+    if not sys.stdin.isatty():
+        return sys.stdin.read()
+    raise click.UsageError("Provide --input, --content, or pipe via stdin.")
+
+
+def _read_json(input_path: str | None, content: str | None) -> object:
+    """Read and parse JSON from input."""
+    raw = _read_input(input_path, content)
+    return json.loads(raw)
+
+
+def _json_option(value: str | None, name: str) -> dict | list | None:
+    if not value:
+        return None
+    try:
+        return json.loads(value)
+    except json.JSONDecodeError as exc:
+        raise click.BadParameter(f"{name} must be valid JSON") from exc
+
+
 def _echo_json(value: object) -> None:
     if hasattr(value, "to_dict"):
         value = value.to_dict()
@@ -88,7 +88,7 @@ def _echo_path(path: object) -> None:
 
 
 # ── CLI Group ────────────────────────────────────────────────────────────────
-
+
 @click.group()
 def cli():
     """LICOS Dev - file generation and model CLI for AI agents."""
@@ -115,584 +115,584 @@ def credit_check(estimated_points, resource_type, resource_code, request_id):
 
 
 # ── PDF ──────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path", help="Input file (Markdown or HTML)")
-@click.option("-c", "--content", help="Direct content")
-@click.option("-f", "--filename", required=True, help="Output filename (no extension)")
-@click.option("-o", "--output-dir", default=None, help="Output directory")
-@click.option("--format", "content_type", default="markdown", help="Content type: markdown|html")
-@click.option("--page-size", default="A4", help="Page size: A4|LETTER")
-def pdf(input_path, content, filename, output_dir, content_type, page_size):
-    """Generate PDF from Markdown or HTML."""
+
+@cli.command()
+@click.option("-i", "--input", "input_path", help="Input file (Markdown or HTML)")
+@click.option("-c", "--content", help="Direct content")
+@click.option("-f", "--filename", required=True, help="Output filename (no extension)")
+@click.option("-o", "--output-dir", default=None, help="Output directory")
+@click.option("--format", "content_type", default="markdown", help="Content type: markdown|html")
+@click.option("--page-size", default="A4", help="Page size: A4|LETTER")
+def pdf(input_path, content, filename, output_dir, content_type, page_size):
+    """Generate PDF from Markdown or HTML."""
     from licos_dev_sdk import create_pdf
     text = _read_input(input_path, content)
     path = create_pdf(text, filename, content_type=content_type, output_dir=output_dir, page_size=page_size)
     _echo_path(path)
-
-
-# ── DOCX ─────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "content_type", default="markdown")
-@click.option("--font", default="Arial")
-@click.option("--font-size", default=11, type=int)
-def docx(input_path, content, filename, output_dir, content_type, font, font_size):
-    """Generate DOCX from Markdown or HTML."""
+
+
+# ── DOCX ─────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "content_type", default="markdown")
+@click.option("--font", default="Arial")
+@click.option("--font-size", default=11, type=int)
+def docx(input_path, content, filename, output_dir, content_type, font, font_size):
+    """Generate DOCX from Markdown or HTML."""
     from licos_dev_sdk import create_docx
     text = _read_input(input_path, content)
     path = create_docx(text, filename, content_type=content_type, output_dir=output_dir, font_name=font, font_size=font_size)
     _echo_path(path)
-
-
-@cli.command("docx-template")
-@click.option("-t", "--template", "template_path", required=True, help="DOCX template path")
-@click.option("-i", "--input", "input_path", help="JSON data file")
-@click.option("-d", "--data", "data_content", help="JSON data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def docx_template(template_path, input_path, data_content, filename, output_dir):
-    """Generate DOCX by rendering a DOCX template with JSON data."""
-    from licos_dev_sdk import create_docx_from_template
-    data = _read_json(input_path, data_content)
+
+
+@cli.command("docx-template")
+@click.option("-t", "--template", "template_path", required=True, help="DOCX template path")
+@click.option("-i", "--input", "input_path", help="JSON data file")
+@click.option("-d", "--data", "data_content", help="JSON data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def docx_template(template_path, input_path, data_content, filename, output_dir):
+    """Generate DOCX by rendering a DOCX template with JSON data."""
+    from licos_dev_sdk import create_docx_from_template
+    data = _read_json(input_path, data_content)
     if not isinstance(data, dict):
         raise click.BadParameter("template data must be a JSON object")
     path = create_docx_from_template(template_path, data, filename, output_dir=output_dir)
     _echo_path(path)
-
-
-# ── XLSX ─────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--sheet-name", default="Sheet1")
-@click.option("--header-color", default="4472C4")
-def xlsx(input_path, content, filename, output_dir, sheet_name, header_color):
-    """Generate XLSX from JSON data."""
+
+
+# ── XLSX ─────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--sheet-name", default="Sheet1")
+@click.option("--header-color", default="4472C4")
+def xlsx(input_path, content, filename, output_dir, sheet_name, header_color):
+    """Generate XLSX from JSON data."""
     from licos_dev_sdk import create_xlsx
     data = _read_json(input_path, content)
     path = create_xlsx(data, filename, output_dir=output_dir, sheet_name=sheet_name, header_color=header_color)
     _echo_path(path)
-
-
-@cli.command("xlsx-workbook")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON workbook data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--header-color", default="4472C4")
-@click.option("--freeze-header/--no-freeze-header", default=True)
-@click.option("--autofilter/--no-autofilter", default=True)
-def xlsx_workbook(input_path, content, filename, output_dir, header_color, freeze_header, autofilter):
-    """Generate multi-sheet XLSX from JSON workbook data."""
-    from licos_dev_sdk import create_xlsx_workbook
-    data = _read_json(input_path, content)
-    path = create_xlsx_workbook(
-        data,
-        filename,
-        output_dir=output_dir,
-        header_color=header_color,
+
+
+@cli.command("xlsx-workbook")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON workbook data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--header-color", default="4472C4")
+@click.option("--freeze-header/--no-freeze-header", default=True)
+@click.option("--autofilter/--no-autofilter", default=True)
+def xlsx_workbook(input_path, content, filename, output_dir, header_color, freeze_header, autofilter):
+    """Generate multi-sheet XLSX from JSON workbook data."""
+    from licos_dev_sdk import create_xlsx_workbook
+    data = _read_json(input_path, content)
+    path = create_xlsx_workbook(
+        data,
+        filename,
+        output_dir=output_dir,
+        header_color=header_color,
         freeze_header=freeze_header,
         autofilter=autofilter,
     )
     _echo_path(path)
-
-
-# ── CSV ──────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def csv(input_path, content, filename, output_dir):
-    """Generate CSV from JSON data."""
+
+
+# ── CSV ──────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def csv(input_path, content, filename, output_dir):
+    """Generate CSV from JSON data."""
     from licos_dev_sdk import create_csv
     data = _read_json(input_path, content)
     path = create_csv(data, filename, output_dir=output_dir)
     _echo_path(path)
-
-
-# ── PPTX ─────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "content_type", default="markdown")
-def pptx(input_path, content, filename, output_dir, content_type):
-    """Generate PPTX from Markdown."""
+
+
+# ── PPTX ─────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "content_type", default="markdown")
+def pptx(input_path, content, filename, output_dir, content_type):
+    """Generate PPTX from Markdown."""
     from licos_dev_sdk import create_pptx
     text = _read_input(input_path, content)
     path = create_pptx(text, filename, content_type=content_type, output_dir=output_dir)
     _echo_path(path)
-
-
-# ── Chart ────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON chart data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--type", "chart_type", required=True, help="bar|line|pie|scatter|heatmap")
-@click.option("--format", "fmt", default="png", help="png|svg")
-@click.option("--title", default="")
-@click.option("--width", default=800, type=int)
-@click.option("--height", default=600, type=int)
-def chart(input_path, content, filename, output_dir, chart_type, fmt, title, width, height):
-    """Generate chart image from JSON data."""
+
+
+# ── Chart ────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON chart data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--type", "chart_type", required=True, help="bar|line|pie|scatter|heatmap")
+@click.option("--format", "fmt", default="png", help="png|svg")
+@click.option("--title", default="")
+@click.option("--width", default=800, type=int)
+@click.option("--height", default=600, type=int)
+def chart(input_path, content, filename, output_dir, chart_type, fmt, title, width, height):
+    """Generate chart image from JSON data."""
     from licos_dev_sdk import create_chart
     data = _read_json(input_path, content)
     path = create_chart(chart_type, data, filename, output_dir=output_dir, format=fmt, title=title, width=width, height=height)
     _echo_path(path)
-
-
-# ── Diagram ──────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="DOT source")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "fmt", default="png", help="png|svg|pdf")
-def diagram(input_path, content, filename, output_dir, fmt):
-    """Generate diagram from Graphviz DOT source."""
+
+
+# ── Diagram ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="DOT source")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "fmt", default="png", help="png|svg|pdf")
+def diagram(input_path, content, filename, output_dir, fmt):
+    """Generate diagram from Graphviz DOT source."""
     from licos_dev_sdk import create_diagram
     text = _read_input(input_path, content)
     path = create_diagram(text, filename, output_dir=output_dir, format=fmt)
     _echo_path(path)
-
-
-# ── QR Code ──────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-d", "--data", required=True, help="Data to encode")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--size", default=300, type=int)
-def qrcode(data, filename, output_dir, size):
-    """Generate QR code PNG image."""
+
+
+# ── QR Code ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-d", "--data", required=True, help="Data to encode")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--size", default=300, type=int)
+def qrcode(data, filename, output_dir, size):
+    """Generate QR code PNG image."""
     from licos_dev_sdk import create_qrcode
     path = create_qrcode(data, filename, output_dir=output_dir, size=size)
     _echo_path(path)
-
-
-# ── Barcode ──────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-d", "--data", required=True, help="Data to encode")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--type", "barcode_type", default="code128", help="code128|ean13|ean8|isbn13|upc")
-def barcode(data, filename, output_dir, barcode_type):
-    """Generate barcode PNG image."""
+
+
+# ── Barcode ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-d", "--data", required=True, help="Data to encode")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--type", "barcode_type", default="code128", help="code128|ean13|ean8|isbn13|upc")
+def barcode(data, filename, output_dir, barcode_type):
+    """Generate barcode PNG image."""
     from licos_dev_sdk import create_barcode
     path = create_barcode(data, filename, output_dir=output_dir, barcode_type=barcode_type)
     _echo_path(path)
-
-
-# ── ZIP ──────────────────────────────────────────────────────────────────────
-
-@cli.command("zip")
-@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def zip_cmd(paths, filename, output_dir):
-    """Create ZIP archive."""
+
+
+# ── ZIP ──────────────────────────────────────────────────────────────────────
+
+@cli.command("zip")
+@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def zip_cmd(paths, filename, output_dir):
+    """Create ZIP archive."""
     from licos_dev_sdk import create_zip
     source_paths = [p.strip() for p in paths.split(",")]
     path = create_zip(source_paths, filename, output_dir=output_dir)
     _echo_path(path)
-
-
-# ── TAR.GZ ───────────────────────────────────────────────────────────────────
-
-@cli.command("tar")
-@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def tar_cmd(paths, filename, output_dir):
-    """Create TAR.GZ archive."""
+
+
+# ── TAR.GZ ───────────────────────────────────────────────────────────────────
+
+@cli.command("tar")
+@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def tar_cmd(paths, filename, output_dir):
+    """Create TAR.GZ archive."""
     from licos_dev_sdk import create_tar_gz
     source_paths = [p.strip() for p in paths.split(",")]
     path = create_tar_gz(source_paths, filename, output_dir=output_dir)
     _echo_path(path)
-
-
-# ── JSON ─────────────────────────────────────────────────────────────────────
-
-@cli.command("json")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON or YAML content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def json_cmd(input_path, content, filename, output_dir):
-    """Generate JSON file (accepts JSON or YAML input)."""
-    from licos_dev_sdk import create_json
-    raw = _read_input(input_path, content)
-    try:
-        data = json.loads(raw)
+
+
+# ── JSON ─────────────────────────────────────────────────────────────────────
+
+@cli.command("json")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON or YAML content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def json_cmd(input_path, content, filename, output_dir):
+    """Generate JSON file (accepts JSON or YAML input)."""
+    from licos_dev_sdk import create_json
+    raw = _read_input(input_path, content)
+    try:
+        data = json.loads(raw)
     except json.JSONDecodeError:
         import yaml
         data = yaml.safe_load(raw)
     path = create_json(data, filename, output_dir=output_dir)
     _echo_path(path)
-
-
-# ── YAML ─────────────────────────────────────────────────────────────────────
-
-@cli.command("yaml")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON or YAML content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def yaml_cmd(input_path, content, filename, output_dir):
-    """Generate YAML file (accepts JSON or YAML input)."""
-    from licos_dev_sdk import create_yaml
-    import yaml as yaml_lib
-    raw = _read_input(input_path, content)
-    try:
-        data = json.loads(raw)
+
+
+# ── YAML ─────────────────────────────────────────────────────────────────────
+
+@cli.command("yaml")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON or YAML content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def yaml_cmd(input_path, content, filename, output_dir):
+    """Generate YAML file (accepts JSON or YAML input)."""
+    from licos_dev_sdk import create_yaml
+    import yaml as yaml_lib
+    raw = _read_input(input_path, content)
+    try:
+        data = json.loads(raw)
     except json.JSONDecodeError:
         data = yaml_lib.safe_load(raw)
     path = create_yaml(data, filename, output_dir=output_dir)
     _echo_path(path)
-
-
-# ── XML ──────────────────────────────────────────────────────────────────────
-
-@cli.command("xml")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--root-tag", default="root")
-def xml_cmd(input_path, content, filename, output_dir, root_tag):
-    """Generate XML file from JSON data."""
+
+
+# ── XML ──────────────────────────────────────────────────────────────────────
+
+@cli.command("xml")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--root-tag", default="root")
+def xml_cmd(input_path, content, filename, output_dir, root_tag):
+    """Generate XML file from JSON data."""
     from licos_dev_sdk import create_xml
     data = _read_json(input_path, content)
     path = create_xml(data, filename, output_dir=output_dir, root_tag=root_tag)
     _echo_path(path)
-
-
-# ── HTML ─────────────────────────────────────────────────────────────────────
-
-@cli.command("html")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "content_type", default="markdown", help="markdown|html")
-def html_cmd(input_path, content, filename, output_dir, content_type):
-    """Generate HTML file from Markdown or raw HTML."""
+
+
+# ── HTML ─────────────────────────────────────────────────────────────────────
+
+@cli.command("html")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "content_type", default="markdown", help="markdown|html")
+def html_cmd(input_path, content, filename, output_dir, content_type):
+    """Generate HTML file from Markdown or raw HTML."""
     from licos_dev_sdk import create_html
     text = _read_input(input_path, content)
     path = create_html(text, filename, output_dir=output_dir, content_type=content_type)
     _echo_path(path)
-
-
-# ── Model Catalog ────────────────────────────────────────────────────────────
-
-@cli.command("model-catalog")
-@click.option("--refresh", is_flag=True, help="Bypass local catalog cache")
-@click.option("--workspace-id", default=None, help="Workspace id; defaults to runtime workspace")
-@click.option("--input-capabilities", default=None, help="Optional input capabilities filter, for example text or image")
-@click.option(
-    "--category-code",
-    default="llm",
-    help="Model category code, for example llm, vision_llm, image_generation",
-)
-def model_catalog(refresh, workspace_id, input_capabilities, category_code):
-    """Print platform model capability catalog."""
-    from licos_dev_sdk import fetch_model_catalogs
-
-    _echo_json(
-        fetch_model_catalogs(
-            refresh=refresh,
-            workspace_id=workspace_id,
-            category_code=category_code,
-            input_capabilities=input_capabilities,
-        )
-    )
-
-
-# ── LLM ──────────────────────────────────────────────────────────────────────
-
-@cli.group("llm")
-def llm_group():
-    """Call chat/text model capabilities."""
-    pass
-
-
-@llm_group.command("invoke")
-@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
-@click.option("--messages", help="OpenAI-style messages JSON array")
-@click.option("--model", default=None)
-@click.option("--temperature", default=None, type=float)
-@click.option("--max-completion-tokens", default=None, type=int)
-@click.option("--extra", default=None, help="Extra request fields as JSON object")
-def llm_invoke(prompt, messages, model, temperature, max_completion_tokens, extra):
-    """Run a non-streaming chat completion."""
-    from licos_dev_sdk import LLMClient
-
-    if messages:
-        message_payload = _json_option(messages, "--messages")
-    else:
-        message_payload = prompt if prompt is not None else _read_input(None, None)
-    extra_payload = _json_option(extra, "--extra") or {}
-    if not isinstance(extra_payload, dict):
-        raise click.BadParameter("--extra must be a JSON object")
-    result = LLMClient().invoke(
-        message_payload,
-        model=model,
-        temperature=temperature,
-        max_completion_tokens=max_completion_tokens,
-        **extra_payload,
-    )
-    _echo_json(result)
-
-
-@llm_group.command("stream")
-@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
-@click.option("--messages", help="OpenAI-style messages JSON array")
-@click.option("--model", default=None)
-@click.option("--temperature", default=None, type=float)
-@click.option("--max-completion-tokens", default=None, type=int)
-@click.option("--extra", default=None, help="Extra request fields as JSON object")
-def llm_stream(prompt, messages, model, temperature, max_completion_tokens, extra):
-    """Run a streaming chat completion and print text chunks."""
-    from licos_dev_sdk import LLMClient
-
-    if messages:
-        message_payload = _json_option(messages, "--messages")
-    else:
-        message_payload = prompt if prompt is not None else _read_input(None, None)
-    extra_payload = _json_option(extra, "--extra") or {}
-    if not isinstance(extra_payload, dict):
-        raise click.BadParameter("--extra must be a JSON object")
-    for chunk in LLMClient().stream(
-        message_payload,
-        model=model,
-        temperature=temperature,
-        max_completion_tokens=max_completion_tokens,
-        **extra_payload,
-    ):
-        click.echo(chunk, nl=False)
-
-
-# ── Vision ───────────────────────────────────────────────────────────────────
-
-@cli.group("vision")
-def vision_group():
-    """Call chat vision model capabilities."""
-    pass
-
-
-@vision_group.command("understand")
-@click.option("--image", "image", multiple=True, help="Image URL, Base64 data URI, or plain Base64 image data. Can be repeated.")
-@click.option("--image-url", "image_url", multiple=True, help="Alias for --image. Can be repeated.")
-@click.option("--file-path", "file_path", multiple=True, help="Local image file path. Can be repeated.")
-@click.option("-p", "--prompt", default="Describe this image.")
-@click.option("--model", default=None)
-@click.option("--mime-type", default=None, help="MIME type for plain Base64 image inputs. Defaults to image/png.")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-def vision_understand(image, image_url, file_path, prompt, model, mime_type, raw_request):
-    """Understand one or more images with the catalog vision model."""
-    from licos_dev_sdk import VisionClient
-
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not image_url and not image and not file_path:
-        raise click.UsageError("Provide --image, --image-url, --file-path, or --raw-request.")
-    result = VisionClient().understand(
-        images=[*image, *image_url],
-        file_paths=list(file_path),
-        prompt=prompt,
-        model=model,
-        mime_type=mime_type,
-        raw_request=raw_payload,
-    )
-    _echo_json(result)
-
-
-# ── Image Generation ─────────────────────────────────────────────────────────
-
-@cli.group("image-generation")
-def image_generation_group():
-    """Call image generation model capabilities."""
-    pass
-
-
-@image_generation_group.command("generate")
-@click.option("-p", "--prompt")
-@click.option("--image", "image", multiple=True, help="Source/reference image URL or Base64 data URI")
-@click.option("--image-url", "image_url", multiple=True, help="Alias for --image")
-@click.option("--reference-image", default=None, help="Alias for --image")
-@click.option("--file-path", "file_path", multiple=True, help="Local source/reference image path")
-@click.option("--input-capabilities", default=None, help="Override image model input filter: text or image")
-@click.option("--negative-prompt", default=None)
-@click.option("--count", default=1, type=int)
-@click.option("--size", default=None)
-@click.option("--model", default=None)
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def image_generate(
-    prompt,
-    image,
-    image_url,
-    reference_image,
-    file_path,
-    input_capabilities,
-    negative_prompt,
-    count,
-    size,
-    model,
-    parameters,
-    raw_request,
-    no_wait,
-):
-    """Generate images from text, image URLs/Base64, or local image files."""
-    from licos_dev_sdk import ImageGenerationClient
-
-    parameter_payload = _json_option(parameters, "--parameters") or {}
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if not isinstance(parameter_payload, dict):
-        raise click.BadParameter("--parameters must be a JSON object")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not prompt:
-        raise click.UsageError("Provide --prompt or --raw-request.")
-    result = ImageGenerationClient().generate(
-        prompt or "",
-        negative_prompt=negative_prompt,
-        count=count,
-        size=size,
-        images=[*image, *image_url],
-        reference_image=reference_image,
-        file_paths=list(file_path),
-        input_capabilities=input_capabilities,
-        model=model,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
-    )
-    _echo_json(result)
-
-
-# ── Video Generation ─────────────────────────────────────────────────────────
-
-@cli.group("video-generation")
-def video_generation_group():
-    """Call video generation model capabilities."""
-    pass
-
-
-@video_generation_group.command("generate")
-@click.option("-p", "--prompt")
-@click.option("--image", default=None, help="Source/reference image URL, Base64 data URI, or plain Base64 image data")
-@click.option("--image-url", default=None, help="Alias for --image")
-@click.option("--reference-image", default=None, help="Alias for --image")
-@click.option("--first-frame-url", default=None, help="Alias for --image")
-@click.option("--file-path", default=None, help="Local source/reference image path")
-@click.option("--model", default=None)
-@click.option("--input-capabilities", default=None, help="Override video model input filter: text or image")
-@click.option("--mime-type", default=None, help="MIME type for plain Base64 image inputs. Defaults to image/png.")
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def video_generate(
-    prompt,
-    image,
-    image_url,
-    reference_image,
-    first_frame_url,
-    file_path,
-    model,
-    input_capabilities,
-    mime_type,
-    parameters,
-    raw_request,
-    no_wait,
-):
-    """Generate a video from a text prompt and optional first-frame image."""
-    from licos_dev_sdk import VideoGenerationClient
-
-    parameter_payload = _json_option(parameters, "--parameters") or {}
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if not isinstance(parameter_payload, dict):
-        raise click.BadParameter("--parameters must be a JSON object")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not prompt:
-        raise click.UsageError("Provide --prompt or --raw-request.")
-    result = VideoGenerationClient().generate(
-        prompt or "",
-        image=image,
-        image_url=image_url,
-        reference_image=reference_image,
-        first_frame_url=first_frame_url,
-        file_path=file_path,
-        model=model,
-        input_capabilities=input_capabilities,
-        mime_type=mime_type,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
-    )
-    _echo_json(result)
-
-
-# ── Audio / ASR ──────────────────────────────────────────────────────────────
-
-@cli.group("audio")
-def audio_group():
-    """Call audio model capabilities."""
-    pass
-
-
-@audio_group.command("recognize")
-@click.option("--audio", "audio", multiple=True, help="Audio URL, Base64 data URI, or plain Base64 audio data. Can be repeated.")
-@click.option("--audio-url", "audio_url", multiple=True, help="Alias for --audio. Can be repeated.")
-@click.option("--file-path", "file_path", multiple=True, help="Local audio file path. Can be repeated.")
-@click.option("--model", default=None)
-@click.option("--mime-type", default=None, help="MIME type for plain Base64 audio inputs. Defaults to audio/wav.")
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def audio_recognize(audio, audio_url, file_path, model, mime_type, parameters, raw_request, no_wait):
-    """Recognize speech from one or more audio inputs."""
-    from licos_dev_sdk import SpeechRecognitionClient
-
-    parameter_payload = _json_option(parameters, "--parameters") or {}
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if not isinstance(parameter_payload, dict):
-        raise click.BadParameter("--parameters must be a JSON object")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not audio and not audio_url and not file_path:
-        raise click.UsageError("Provide --audio, --audio-url, --file-path, or --raw-request.")
-    result = SpeechRecognitionClient().recognize(
-        audios=[*audio, *audio_url],
-        file_paths=list(file_path),
-        model=model,
-        mime_type=mime_type,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
-    )
-    _echo_json(result)
-
-
-if __name__ == "__main__":
-    cli()
+
+
+# ── Model Catalog ────────────────────────────────────────────────────────────
+
+@cli.command("model-catalog")
+@click.option("--refresh", is_flag=True, help="Bypass local catalog cache")
+@click.option("--workspace-id", default=None, help="Workspace id; defaults to runtime workspace")
+@click.option("--input-capabilities", default=None, help="Optional input capabilities filter, for example text or image")
+@click.option(
+    "--category-code",
+    default="llm",
+    help="Model category code, for example llm, vision_llm, image_generation",
+)
+def model_catalog(refresh, workspace_id, input_capabilities, category_code):
+    """Print platform model capability catalog."""
+    from licos_dev_sdk import fetch_model_catalogs
+
+    _echo_json(
+        fetch_model_catalogs(
+            refresh=refresh,
+            workspace_id=workspace_id,
+            category_code=category_code,
+            input_capabilities=input_capabilities,
+        )
+    )
+
+
+# ── LLM ──────────────────────────────────────────────────────────────────────
+
+@cli.group("llm")
+def llm_group():
+    """Call chat/text model capabilities."""
+    pass
+
+
+@llm_group.command("invoke")
+@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
+@click.option("--messages", help="OpenAI-style messages JSON array")
+@click.option("--model", default=None)
+@click.option("--temperature", default=None, type=float)
+@click.option("--max-completion-tokens", default=None, type=int)
+@click.option("--extra", default=None, help="Extra request fields as JSON object")
+def llm_invoke(prompt, messages, model, temperature, max_completion_tokens, extra):
+    """Run a non-streaming chat completion."""
+    from licos_dev_sdk import LLMClient
+
+    if messages:
+        message_payload = _json_option(messages, "--messages")
+    else:
+        message_payload = prompt if prompt is not None else _read_input(None, None)
+    extra_payload = _json_option(extra, "--extra") or {}
+    if not isinstance(extra_payload, dict):
+        raise click.BadParameter("--extra must be a JSON object")
+    result = LLMClient().invoke(
+        message_payload,
+        model=model,
+        temperature=temperature,
+        max_completion_tokens=max_completion_tokens,
+        **extra_payload,
+    )
+    _echo_json(result)
+
+
+@llm_group.command("stream")
+@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
+@click.option("--messages", help="OpenAI-style messages JSON array")
+@click.option("--model", default=None)
+@click.option("--temperature", default=None, type=float)
+@click.option("--max-completion-tokens", default=None, type=int)
+@click.option("--extra", default=None, help="Extra request fields as JSON object")
+def llm_stream(prompt, messages, model, temperature, max_completion_tokens, extra):
+    """Run a streaming chat completion and print text chunks."""
+    from licos_dev_sdk import LLMClient
+
+    if messages:
+        message_payload = _json_option(messages, "--messages")
+    else:
+        message_payload = prompt if prompt is not None else _read_input(None, None)
+    extra_payload = _json_option(extra, "--extra") or {}
+    if not isinstance(extra_payload, dict):
+        raise click.BadParameter("--extra must be a JSON object")
+    for chunk in LLMClient().stream(
+        message_payload,
+        model=model,
+        temperature=temperature,
+        max_completion_tokens=max_completion_tokens,
+        **extra_payload,
+    ):
+        click.echo(chunk, nl=False)
+
+
+# ── Vision ───────────────────────────────────────────────────────────────────
+
+@cli.group("vision")
+def vision_group():
+    """Call chat vision model capabilities."""
+    pass
+
+
+@vision_group.command("understand")
+@click.option("--image", "image", multiple=True, help="Image URL, Base64 data URI, or plain Base64 image data. Can be repeated.")
+@click.option("--image-url", "image_url", multiple=True, help="Alias for --image. Can be repeated.")
+@click.option("--file-path", "file_path", multiple=True, help="Local image file path. Can be repeated.")
+@click.option("-p", "--prompt", default="Describe this image.")
+@click.option("--model", default=None)
+@click.option("--mime-type", default=None, help="MIME type for plain Base64 image inputs. Defaults to image/png.")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+def vision_understand(image, image_url, file_path, prompt, model, mime_type, raw_request):
+    """Understand one or more images with the catalog vision model."""
+    from licos_dev_sdk import VisionClient
+
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not image_url and not image and not file_path:
+        raise click.UsageError("Provide --image, --image-url, --file-path, or --raw-request.")
+    result = VisionClient().understand(
+        images=[*image, *image_url],
+        file_paths=list(file_path),
+        prompt=prompt,
+        model=model,
+        mime_type=mime_type,
+        raw_request=raw_payload,
+    )
+    _echo_json(result)
+
+
+# ── Image Generation ─────────────────────────────────────────────────────────
+
+@cli.group("image-generation")
+def image_generation_group():
+    """Call image generation model capabilities."""
+    pass
+
+
+@image_generation_group.command("generate")
+@click.option("-p", "--prompt")
+@click.option("--image", "image", multiple=True, help="Source/reference image URL or Base64 data URI")
+@click.option("--image-url", "image_url", multiple=True, help="Alias for --image")
+@click.option("--reference-image", default=None, help="Alias for --image")
+@click.option("--file-path", "file_path", multiple=True, help="Local source/reference image path")
+@click.option("--input-capabilities", default=None, help="Override image model input filter: text or image")
+@click.option("--negative-prompt", default=None)
+@click.option("--count", default=1, type=int)
+@click.option("--size", default=None)
+@click.option("--model", default=None)
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def image_generate(
+    prompt,
+    image,
+    image_url,
+    reference_image,
+    file_path,
+    input_capabilities,
+    negative_prompt,
+    count,
+    size,
+    model,
+    parameters,
+    raw_request,
+    no_wait,
+):
+    """Generate images from text, image URLs/Base64, or local image files."""
+    from licos_dev_sdk import ImageGenerationClient
+
+    parameter_payload = _json_option(parameters, "--parameters") or {}
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if not isinstance(parameter_payload, dict):
+        raise click.BadParameter("--parameters must be a JSON object")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not prompt:
+        raise click.UsageError("Provide --prompt or --raw-request.")
+    result = ImageGenerationClient().generate(
+        prompt or "",
+        negative_prompt=negative_prompt,
+        count=count,
+        size=size,
+        images=[*image, *image_url],
+        reference_image=reference_image,
+        file_paths=list(file_path),
+        input_capabilities=input_capabilities,
+        model=model,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
+    )
+    _echo_json(result)
+
+
+# ── Video Generation ─────────────────────────────────────────────────────────
+
+@cli.group("video-generation")
+def video_generation_group():
+    """Call video generation model capabilities."""
+    pass
+
+
+@video_generation_group.command("generate")
+@click.option("-p", "--prompt")
+@click.option("--image", default=None, help="Source/reference image URL, Base64 data URI, or plain Base64 image data")
+@click.option("--image-url", default=None, help="Alias for --image")
+@click.option("--reference-image", default=None, help="Alias for --image")
+@click.option("--first-frame-url", default=None, help="Alias for --image")
+@click.option("--file-path", default=None, help="Local source/reference image path")
+@click.option("--model", default=None)
+@click.option("--input-capabilities", default=None, help="Override video model input filter: text or image")
+@click.option("--mime-type", default=None, help="MIME type for plain Base64 image inputs. Defaults to image/png.")
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def video_generate(
+    prompt,
+    image,
+    image_url,
+    reference_image,
+    first_frame_url,
+    file_path,
+    model,
+    input_capabilities,
+    mime_type,
+    parameters,
+    raw_request,
+    no_wait,
+):
+    """Generate a video from a text prompt and optional first-frame image."""
+    from licos_dev_sdk import VideoGenerationClient
+
+    parameter_payload = _json_option(parameters, "--parameters") or {}
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if not isinstance(parameter_payload, dict):
+        raise click.BadParameter("--parameters must be a JSON object")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not prompt:
+        raise click.UsageError("Provide --prompt or --raw-request.")
+    result = VideoGenerationClient().generate(
+        prompt or "",
+        image=image,
+        image_url=image_url,
+        reference_image=reference_image,
+        first_frame_url=first_frame_url,
+        file_path=file_path,
+        model=model,
+        input_capabilities=input_capabilities,
+        mime_type=mime_type,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
+    )
+    _echo_json(result)
+
+
+# ── Audio / ASR ──────────────────────────────────────────────────────────────
+
+@cli.group("audio")
+def audio_group():
+    """Call audio model capabilities."""
+    pass
+
+
+@audio_group.command("recognize")
+@click.option("--audio", "audio", multiple=True, help="Audio URL, Base64 data URI, or plain Base64 audio data. Can be repeated.")
+@click.option("--audio-url", "audio_url", multiple=True, help="Alias for --audio. Can be repeated.")
+@click.option("--file-path", "file_path", multiple=True, help="Local audio file path. Can be repeated.")
+@click.option("--model", default=None)
+@click.option("--mime-type", default=None, help="MIME type for plain Base64 audio inputs. Defaults to audio/wav.")
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def audio_recognize(audio, audio_url, file_path, model, mime_type, parameters, raw_request, no_wait):
+    """Recognize speech from one or more audio inputs."""
+    from licos_dev_sdk import SpeechRecognitionClient
+
+    parameter_payload = _json_option(parameters, "--parameters") or {}
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if not isinstance(parameter_payload, dict):
+        raise click.BadParameter("--parameters must be a JSON object")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not audio and not audio_url and not file_path:
+        raise click.UsageError("Provide --audio, --audio-url, --file-path, or --raw-request.")
+    result = SpeechRecognitionClient().recognize(
+        audios=[*audio, *audio_url],
+        file_paths=list(file_path),
+        model=model,
+        mime_type=mime_type,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
+    )
+    _echo_json(result)
+
+
+if __name__ == "__main__":
+    cli()