scitex 2.13.0__py3-none-any.whl → 2.15.1__py3-none-any.whl

scitex/cli/social.py

@@ -0,0 +1,314 @@
+#!/usr/bin/env python3
+# Timestamp: 2026-01-22
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/cli/social.py
+
+"""
+SciTeX CLI - Social Media Commands
+
+Thin wrapper around socialia CLI with SCITEX_ environment variable prefix.
+All commands delegate to socialia for reproducibility.
+"""
+
+import subprocess
+import sys
+
+import click
+
+
+def _run_socialia(*args, json_output: bool = False) -> int:
+    """Run socialia CLI command."""
+    cmd = [sys.executable, "-m", "socialia"]
+    if json_output:
+        cmd.append("--json")
+    cmd.extend(args)
+
+    result = subprocess.run(cmd)
+    return result.returncode
+
+
+def _check_socialia() -> bool:
+    """Check if socialia is available."""
+    try:
+        import socialia  # noqa: F401
+
+        return True
+    except ImportError:
+        return False
+
+
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    invoke_without_command=True,
+)
+@click.option("--help-recursive", is_flag=True, help="Show help for all subcommands")
+@click.pass_context
+def social(ctx, help_recursive):
+    """
+    Social media management (powered by socialia)
+
+    \b
+    Platforms:
+      twitter   - Twitter/X posting and management
+      linkedin  - LinkedIn posting
+      reddit    - Reddit posting
+      youtube   - YouTube video uploads
+
+    \b
+    Examples:
+      scitex social post twitter "Hello from SciTeX!"
+      scitex social post linkedin "Research update"
+      scitex social status
+      scitex social analytics twitter
+
+    \b
+    Environment Variables (SCITEX_ prefix):
+      SCITEX_X_CONSUMER_KEY          Twitter API keys
+      SCITEX_LINKEDIN_ACCESS_TOKEN   LinkedIn OAuth token
+      SCITEX_REDDIT_CLIENT_ID        Reddit app credentials
+      SCITEX_YOUTUBE_API_KEY         YouTube API key
+
+    Note: Falls back to SOCIALIA_ prefix if SCITEX_ not set.
+    """
+    if not _check_socialia():
+        click.secho("Error: socialia not installed", fg="red", err=True)
+        click.echo("\nInstall with: pip install socialia")
+        ctx.exit(1)
+
+    if help_recursive:
+        from . import print_help_recursive
+
+        print_help_recursive(ctx, social)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+@social.command()
+@click.argument(
+    "platform", type=click.Choice(["twitter", "linkedin", "reddit", "youtube"])
+)
+@click.argument("text", required=False)
+@click.option(
+    "-f", "--file", type=click.Path(exists=True), help="Read content from file"
+)
+@click.option("--reply-to", help="Post ID to reply to (Twitter)")
+@click.option("--quote", help="Post ID to quote (Twitter)")
+@click.option("-s", "--subreddit", default="test", help="Target subreddit (Reddit)")
+@click.option("-t", "--title", help="Post title (Reddit/YouTube)")
+@click.option("--dry-run", is_flag=True, help="Preview without posting")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def post(platform, text, file, reply_to, quote, subreddit, title, dry_run, as_json):
+    """
+    Post content to a social platform
+
+    \b
+    Examples:
+      scitex social post twitter "Hello world!"
+      scitex social post twitter --file tweet.txt
+      scitex social post reddit "Check this out" -s python -t "Cool project"
+      scitex social post linkedin "Professional update"
+      scitex social post twitter "Test" --dry-run
+    """
+    args = ["post", platform]
+
+    if text:
+        args.append(text)
+    if file:
+        args.extend(["--file", file])
+    if reply_to:
+        args.extend(["--reply-to", reply_to])
+    if quote:
+        args.extend(["--quote", quote])
+    if subreddit and platform == "reddit":
+        args.extend(["--subreddit", subreddit])
+    if title:
+        args.extend(["--title", title])
+    if dry_run:
+        args.append("--dry-run")
+
+    sys.exit(_run_socialia(*args, json_output=as_json))
+
+
+@social.command()
+@click.argument("platform", type=click.Choice(["twitter", "linkedin", "reddit"]))
+@click.argument("post_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def delete(platform, post_id, as_json):
+    """
+    Delete a post from a platform
+
+    \b
+    Examples:
+      scitex social delete twitter 1234567890
+      scitex social delete reddit abc123
+    """
+    sys.exit(_run_socialia("delete", platform, post_id, json_output=as_json))
+
+
+@social.command()
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def status(as_json):
+    """
+    Check configuration and authentication status
+
+    \b
+    Example:
+      scitex social status
+      scitex social status --json
+    """
+    sys.exit(_run_socialia("status", json_output=as_json))
+
+
+@social.command()
+@click.argument(
+    "platform",
+    type=click.Choice(["twitter", "linkedin", "reddit", "youtube"]),
+    required=False,
+)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def check(platform, as_json):
+    """
+    Check platform connection status.
+
+    \b
+    Examples:
+      scitex social check              # Check all platforms
+      scitex social check twitter      # Check specific platform
+    """
+    args = ["check"]
+    if platform:
+        args.append(platform)
+    sys.exit(_run_socialia(*args, json_output=as_json))
+
+
+@social.command()
+@click.argument(
+    "platform",
+    type=click.Choice(["twitter", "linkedin", "reddit"]),
+    required=False,
+)
+@click.option("--limit", "-l", type=int, default=10, help="Number of posts to fetch")
+@click.option("--mentions", is_flag=True, help="Get mentions/notifications instead")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def feed(platform, limit, mentions, as_json):
+    """
+    Get recent posts from platform feeds.
+
+    \b
+    Examples:
+      scitex social feed                    # All platforms
+      scitex social feed twitter --limit 5  # Specific platform
+      scitex social feed --mentions         # Get mentions
+    """
+    args = ["feed"]
+    if platform:
+        args.append(platform)
+    args.extend(["--limit", str(limit)])
+    if mentions:
+        args.append("--mentions")
+    sys.exit(_run_socialia(*args, json_output=as_json))
+
+
+@social.command()
+@click.argument("platform", type=click.Choice(["twitter", "linkedin", "reddit"]))
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def me(platform, as_json):
+    """
+    Get user profile information.
+
+    \b
+    Examples:
+      scitex social me twitter
+      scitex social me linkedin --json
+    """
+    sys.exit(_run_socialia("me", platform, json_output=as_json))
+
+
+@social.command()
+@click.argument("platform", type=click.Choice(["twitter", "youtube", "ga"]))
+@click.option("--days", "-d", type=int, default=7, help="Number of days to analyze")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def analytics(platform, days, as_json):
+    """
+    Get analytics for a platform
+
+    \b
+    Platforms:
+      twitter  - Tweet engagement metrics
+      youtube  - Channel and video statistics
+      ga       - Google Analytics reports
+
+    \b
+    Examples:
+      scitex social analytics twitter
+      scitex social analytics youtube --days 30
+      scitex social analytics ga --json
+    """
+    args = ["analytics", platform, "--days", str(days)]
+    sys.exit(_run_socialia(*args, json_output=as_json))
+
+
+@social.command()
+@click.argument("platform", type=click.Choice(["twitter"]))
+@click.option(
+    "-f", "--file", type=click.Path(exists=True), required=True, help="Thread file"
+)
+@click.option("--delay", type=int, default=2, help="Delay between posts (seconds)")
+@click.option("--dry-run", is_flag=True, help="Preview without posting")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def thread(platform, file, delay, dry_run, as_json):
+    """
+    Post a thread (multiple connected posts)
+
+    \b
+    Thread file format (--- separates posts):
+      First tweet in the thread
+      ---
+      Second tweet, replying to first
+      ---
+      Third tweet, and so on...
+
+    \b
+    Example:
+      scitex social thread twitter --file thread.txt
+      scitex social thread twitter --file thread.txt --dry-run
+    """
+    args = ["thread", platform, "--file", file, "--delay", str(delay)]
+    if dry_run:
+        args.append("--dry-run")
+    sys.exit(_run_socialia(*args, json_output=as_json))
+
+
+@social.command()
+@click.option(
+    "-t",
+    "--transport",
+    type=click.Choice(["stdio", "sse", "http"]),
+    default="stdio",
+    help="Transport protocol",
+)
+@click.option("--host", default="0.0.0.0", help="Host for HTTP/SSE transport")
+@click.option("--port", default=8086, type=int, help="Port for HTTP/SSE transport")
+def serve(transport, host, port):
+    """
+    Run socialia MCP server
+
+    \b
+    Examples:
+      scitex social serve                    # stdio for Claude Desktop
+      scitex social serve -t http --port 8086
+    """
+    args = ["mcp", "run", "--transport", transport]
+    if transport != "stdio":
+        args.extend(["--host", host, "--port", str(port)])
+        click.secho(f"Starting socialia MCP server ({transport})", fg="cyan")
+        click.echo(f"  Host: {host}")
+        click.echo(f"  Port: {port}")
+
+    sys.exit(_run_socialia(*args))
+
+
+if __name__ == "__main__":
+    social()
+
+# EOF

scitex/cli/stats.py

@@ -32,6 +32,24 @@ def stats():
     pass
 
 
+@stats.command("help-recursive")
+@click.pass_context
+def help_recursive(ctx):
+    """Show help for all commands recursively."""
+    fake_parent = click.Context(click.Group(), info_name="scitex")
+    parent_ctx = click.Context(stats, info_name="stats", parent=fake_parent)
+    click.secho("━━━ scitex stats ━━━", fg="cyan", bold=True)
+    click.echo(stats.get_help(parent_ctx))
+    for name in sorted(stats.list_commands(ctx) or []):
+        cmd = stats.get_command(ctx, name)
+        if cmd is None or name == "help-recursive":
+            continue
+        click.echo()
+        click.secho(f"━━━ scitex stats {name} ━━━", fg="cyan", bold=True)
+        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
+            click.echo(cmd.get_help(sub_ctx))
+
+
 @stats.command()
 @click.option(
     "--n-groups", "-n", type=int, required=True, help="Number of groups to compare"

scitex/cli/template.py

@@ -32,6 +32,24 @@ def template():
     pass
 
 
+@template.command("help-recursive")
+@click.pass_context
+def help_recursive(ctx):
+    """Show help for all commands recursively."""
+    fake_parent = click.Context(click.Group(), info_name="scitex")
+    parent_ctx = click.Context(template, info_name="template", parent=fake_parent)
+    click.secho("━━━ scitex template ━━━", fg="cyan", bold=True)
+    click.echo(template.get_help(parent_ctx))
+    for name in sorted(template.list_commands(ctx) or []):
+        cmd = template.get_command(ctx, name)
+        if cmd is None or name == "help-recursive":
+            continue
+        click.echo()
+        click.secho(f"━━━ scitex template {name} ━━━", fg="cyan", bold=True)
+        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
+            click.echo(cmd.get_help(sub_ctx))
+
+
 @template.command(name="list")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
 def list_templates(as_json):

scitex/cli/tex.py

@@ -31,6 +31,24 @@ def tex():
     pass
 
 
+@tex.command("help-recursive")
+@click.pass_context
+def help_recursive(ctx):
+    """Show help for all commands recursively."""
+    fake_parent = click.Context(click.Group(), info_name="scitex")
+    parent_ctx = click.Context(tex, info_name="tex", parent=fake_parent)
+    click.secho("━━━ scitex tex ━━━", fg="cyan", bold=True)
+    click.echo(tex.get_help(parent_ctx))
+    for name in sorted(tex.list_commands(ctx) or []):
+        cmd = tex.get_command(ctx, name)
+        if cmd is None or name == "help-recursive":
+            continue
+        click.echo()
+        click.secho(f"━━━ scitex tex {name} ━━━", fg="cyan", bold=True)
+        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
+            click.echo(cmd.get_help(sub_ctx))
+
+
 @tex.command()
 @click.argument("tex_file", type=click.Path(exists=True))
 @click.option("--output", "-o", type=click.Path(), help="Output PDF path")

scitex/cli/writer.py

@@ -1,15 +1,15 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 """
 SciTeX Writer Commands - LaTeX Manuscript Management
 
 Provides manuscript project initialization and compilation.
 """
 
-import click
 import sys
 from pathlib import Path
 
+import click
+
 
 @click.group(context_settings={"help_option_names": ["-h", "--help"]})
 def writer():
@@ -26,6 +26,26 @@ def writer():
     pass
 
 
+@writer.command("help-recursive")
+@click.pass_context
+def help_recursive(ctx):
+    """Show help for all commands recursively."""
+    fake_parent = click.Context(click.Group(), info_name="scitex")
+    parent_ctx = click.Context(writer, info_name="writer", parent=fake_parent)
+
+    click.secho("━━━ scitex writer ━━━", fg="cyan", bold=True)
+    click.echo(writer.get_help(parent_ctx))
+
+    for name in sorted(writer.list_commands(ctx) or []):
+        cmd = writer.get_command(ctx, name)
+        if cmd is None or name == "help-recursive":
+            continue
+        click.echo()
+        click.secho(f"━━━ scitex writer {name} ━━━", fg="cyan", bold=True)
+        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
+            click.echo(cmd.get_help(sub_ctx))
+
+
 @writer.command()
 @click.argument("project_dir", type=click.Path())
 @click.option(
@@ -93,19 +113,19 @@ def clone(project_dir, git_strategy, branch, tag):
             click.echo("Project structure:")
             click.echo(f"  {project_dir}/")
             click.echo(
-                f"    ├── 00_shared/          # Shared resources (figures, bibliography)"
+                "    ├── 00_shared/          # Shared resources (figures, bibliography)"
             )
-            click.echo(f"    ├── 01_manuscript/      # Main manuscript")
-            click.echo(f"    ├── 02_supplementary/   # Supplementary materials")
-            click.echo(f"    ├── 03_revision/        # Revision documents")
-            click.echo(f"    └── scripts/            # Compilation scripts")
+            click.echo("    ├── 01_manuscript/      # Main manuscript")
+            click.echo("    ├── 02_supplementary/   # Supplementary materials")
+            click.echo("    ├── 03_revision/        # Revision documents")
+            click.echo("    └── scripts/            # Compilation scripts")
             click.echo()
             click.echo("Next steps:")
             click.echo(f"  cd {project_dir}")
-            click.echo(f"  # Edit your manuscript in 01_manuscript/contents/")
-            click.echo(f"  scitex writer compile manuscript")
+            click.echo("  # Edit your manuscript in 01_manuscript/contents/")
+            click.echo("  scitex writer compile manuscript")
         else:
-            click.secho(f"✗ Failed to clone project", fg="red", err=True)
+            click.secho("✗ Failed to clone project", fg="red", err=True)
             sys.exit(1)
 
     except Exception as e:
@@ -151,10 +171,23 @@ def compile(document, dir, track_changes, timeout):
         scitex writer compile revision --track-changes
         scitex writer compile supplementary --timeout 600
     """
-    try:
-        from scitex.writer import Writer
+    from scitex.writer import Writer
+
+    project_dir = Path(dir) if dir else Path.cwd()
 
-        project_dir = Path(dir) if dir else Path.cwd()
+    # Check if this is a Writer project before trying to attach
+    required_dirs = ["01_manuscript", "02_supplementary", "03_revision"]
+    missing = [d for d in required_dirs if not (project_dir / d).exists()]
+
+    if missing:
+        click.echo(f"Not a Writer project: {project_dir.absolute()}")
+        click.echo(f"Missing directories: {', '.join(missing)}")
+        click.echo()
+        click.echo("To create a new project, run:")
+        click.echo("  scitex writer clone <project-name>")
+        return  # Exit gracefully with code 0
+
+    try:
         writer = Writer(project_dir)
 
         click.echo(f"Compiling {document} in {project_dir}...")
@@ -171,7 +204,7 @@ def compile(document, dir, track_changes, timeout):
             )
 
         if result.success:
-            click.secho(f"✓ Compilation successful!", fg="green")
+            click.secho("✓ Compilation successful!", fg="green")
             click.echo(f"PDF: {result.output_pdf}")
         else:
             click.secho(
@@ -207,10 +240,20 @@ def info(dir):
         scitex writer info
         scitex writer info --dir ./my_paper
     """
-    try:
-        from scitex.writer import Writer
+    from scitex.writer import Writer
 
-        project_dir = Path(dir) if dir else Path.cwd()
+    project_dir = Path(dir) if dir else Path.cwd()
+
+    # Check if this is a Writer project before trying to attach
+    required_dirs = ["01_manuscript", "02_supplementary", "03_revision"]
+    missing = [d for d in required_dirs if not (project_dir / d).exists()]
+
+    if missing:
+        click.echo(f"Not a Writer project: {project_dir.absolute()}")
+        click.echo(f"Missing directories: {', '.join(missing)}")
+        return  # Exit gracefully with code 0
+
+    try:
         writer = Writer(project_dir)
 
         click.echo(f"Project: {writer.project_name}")
@@ -237,6 +280,123 @@ def info(dir):
         sys.exit(1)
 
 
+@writer.group()
+def mcp():
+    """
+    MCP (Model Context Protocol) tools for writer module.
+
+    \b
+    Examples:
+      scitex writer mcp list-tools      # List available MCP tools
+      scitex writer mcp usage           # Show tool usage and parameters
+    """
+    pass
+
+
+@mcp.command("list-tools")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def list_tools(as_json: bool):
+    """
+    List available MCP tools for writer module.
+
+    \b
+    Examples:
+      scitex writer mcp list-tools
+      scitex writer mcp list-tools --json
+    """
+    from scitex.writer._mcp.tool_schemas import get_tool_schemas
+
+    tools = get_tool_schemas()
+
+    if as_json:
+        import json
+
+        output = {
+            "module": "writer",
+            "count": len(tools),
+            "tools": [
+                {
+                    "name": t.name,
+                    "description": t.description,
+                    "parameters": list(t.inputSchema.get("properties", {}).keys()),
+                    "required": t.inputSchema.get("required", []),
+                }
+                for t in tools
+            ],
+        }
+        click.echo(json.dumps(output, indent=2))
+    else:
+        click.secho(
+            f"SciTeX Writer MCP Tools ({len(tools)} total)", fg="cyan", bold=True
+        )
+        click.echo()
+
+        for tool in tools:
+            click.secho(f"  {tool.name}", fg="green", bold=True)
+            # First line of description
+            desc = tool.description.split("\n")[0] if tool.description else ""
+            click.echo(f"    {desc}")
+
+            # Parameters
+            props = tool.inputSchema.get("properties", {})
+            required = tool.inputSchema.get("required", [])
+            if props:
+                params = []
+                for pname, pinfo in props.items():
+                    req_marker = "*" if pname in required else ""
+                    params.append(f"{pname}{req_marker}")
+                click.echo(f"    Parameters: {', '.join(params)}")
+            click.echo()
+
+
+@mcp.command("usage")
+@click.argument("tool_name", required=False)
+def usage(tool_name: str):
+    """
+    Show detailed usage for writer MCP tools.
+
+    \b
+    Examples:
+      scitex writer mcp usage                    # Show all tools
+      scitex writer mcp usage compile_manuscript # Show specific tool
+    """
+    from scitex.writer._mcp.tool_schemas import get_tool_schemas
+
+    tools = get_tool_schemas()
+
+    if tool_name:
+        # Find specific tool
+        tool = next((t for t in tools if t.name == tool_name), None)
+        if not tool:
+            click.secho(f"Tool '{tool_name}' not found", fg="red", err=True)
+            click.echo(f"Available tools: {', '.join(t.name for t in tools)}")
+            raise SystemExit(1)
+        tools = [tool]
+
+    for tool in tools:
+        click.secho(f"━━━ {tool.name} ━━━", fg="cyan", bold=True)
+        click.echo()
+        click.echo(f"Description: {tool.description}")
+        click.echo()
+
+        props = tool.inputSchema.get("properties", {})
+        required = tool.inputSchema.get("required", [])
+
+        if props:
+            click.secho("Parameters:", bold=True)
+            for pname, pinfo in props.items():
+                req = " (required)" if pname in required else ""
+                ptype = pinfo.get("type", "any")
+                pdesc = pinfo.get("description", "")
+                default = pinfo.get("default")
+                default_str = f" [default: {default}]" if default is not None else ""
+
+                click.echo(f"  {pname}: {ptype}{req}{default_str}")
+                if pdesc:
+                    click.echo(f"    {pdesc}")
+        click.echo()
+
+
 @writer.command()
 @click.option(
     "--dir",
@@ -253,10 +413,20 @@ def watch(dir):
         scitex writer watch
         scitex writer watch --dir ./my_paper
     """
-    try:
-        from scitex.writer import Writer
+    from scitex.writer import Writer
+
+    project_dir = Path(dir) if dir else Path.cwd()
 
-        project_dir = Path(dir) if dir else Path.cwd()
+    # Check if this is a Writer project before trying to attach
+    required_dirs = ["01_manuscript", "02_supplementary", "03_revision"]
+    missing = [d for d in required_dirs if not (project_dir / d).exists()]
+
+    if missing:
+        click.echo(f"Not a Writer project: {project_dir.absolute()}")
+        click.echo(f"Missing directories: {', '.join(missing)}")
+        return  # Exit gracefully with code 0
+
+    try:
         writer = Writer(project_dir)
 
         click.echo(f"Watching {project_dir} for changes...")