feat: Introduce a unified CLI, refactor documentation generation into a dedicated package, and add a CI workflow for automated documentation builds.

Author: MervinPraison

.github/workflows/generate-docs.yml

@@ -0,0 +1,66 @@
+name: Generate SDK Reference Docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'praisonai_tools/docs_generator/**'
+  repository_dispatch:
+    types: [trigger-docs-generation]
+  workflow_dispatch:
+
+jobs:
+  generate-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout PraisonAI Tools
+        uses: actions/checkout@v4
+        with:
+          path: praisonai-tools
+
+      - name: Checkout PraisonAI Source Repo
+        uses: actions/checkout@v4
+        with:
+          repository: MervinPraison/PraisonAI
+          path: praisonai-source
+
+      - name: Checkout PraisonAI Docs
+        uses: actions/checkout@v4
+        with:
+          repository: MervinPraison/PraisonAIDocs
+          path: praisonai-docs
+          token: ${{ secrets.DOCS_GITHUB_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install PraisonAI Tools
+        run: |
+          cd praisonai-tools
+          pip install -e .
+
+      - name: Run Docs Generation
+        run: |
+          # Use the new unified CLI
+          praisonai-tools docs-generate \
+            --package all \
+            --docs-root $(pwd)/praisonai-docs \
+            --source-root $(pwd)/praisonai-source
+        env:
+          PYTHONPATH: $(pwd)/praisonai-tools
+
+      - name: Commit and Push Docs
+        run: |
+          cd praisonai-docs
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git add .
+          if git diff --staged --quiet; then
+            echo "No changes to commit"
+          else
+            git commit -m "docs: auto-generate SDK reference documentation"
+            git push
+          fi

praisonai_tools/cli.py

@@ -0,0 +1,64 @@
+"""
+Unified CLI for PraisonAI Tools.
+"""
+
+import argparse
+import sys
+from importlib import import_module
+
+def main():
+    if len(sys.argv) < 2:
+        print("PraisonAI Developer Tools CLI")
+        print("\nUsage: praisonai-tools [tool] [args]")
+        print("\nAvailable tools:")
+        print("  docs-generate    Generate SDK reference documentation")
+        print("  video            AI-powered video editing tools")
+        print("  fcp              Final Cut Pro automation tools")
+        return 1
+    
+    tool = sys.argv[1]
+    tool_args = sys.argv[2:]
+    
+    if tool == "docs-generate":
+        # Handle docs-generate with its own parser for better help
+        parser = argparse.ArgumentParser(prog="praisonai-tools docs-generate")
+        parser.add_argument("--package", choices=["praisonaiagents", "praisonai", "typescript", "all"], 
+                            default="all", help="Package to generate docs for")
+        parser.add_argument("--dry-run", action="store_true", help="Don't write files")
+        parser.add_argument("--docs-root", default="/Users/praison/PraisonAIDocs", 
+                            help="Root directory of the documentation repository")
+        parser.add_argument("--source-root", help="Root directory of the source code")
+        
+        args = parser.parse_args(tool_args)
+        from .docs_generator.generator import ReferenceDocsGenerator
+        generator = ReferenceDocsGenerator(docs_root=args.docs_root, source_root=args.source_root)
+        
+        if args.package == "all":
+            generator.generate_all(dry_run=args.dry_run)
+        else:
+            generator.generate_package(args.package, dry_run=args.dry_run)
+        return 0
+        
+    elif tool == "video":
+        try:
+            video_main = import_module(".video.__main__", package="praisonai_tools").main
+            sys.argv = [f"{sys.argv[0]} video"] + tool_args
+            return video_main()
+        except ImportError as e:
+            print(f"Error: Video tool not available. {e}")
+            return 1
+            
+    elif tool == "fcp":
+        try:
+            fcp_main = import_module(".fcp_tool.cli", package="praisonai_tools").main
+            return fcp_main(tool_args)
+        except ImportError as e:
+            print(f"Error: FCP tool not available. {e}")
+            return 1
+    else:
+        print(f"Unknown tool: {tool}")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

praisonai_tools/docs_generator/__init__.py

@@ -0,0 +1,29 @@
+"""
+CLI entry point for praisonai_tools.docs_generator.
+"""
+
+import argparse
+import sys
+from .generator import ReferenceDocsGenerator
+
+def main():
+    parser = argparse.ArgumentParser(description="PraisonAI SDK Documentation Generator")
+    parser.add_argument("--package", choices=["praisonaiagents", "praisonai", "typescript", "all"], 
+                        default="all", help="Package to generate docs for")
+    parser.add_argument("--dry-run", action="store_true", help="Don't write files")
+    parser.add_argument("--docs-root", default="/Users/praison/PraisonAIDocs", 
+                        help="Root directory of the documentation repository")
+    
+    args = parser.parse_args()
+    
+    generator = ReferenceDocsGenerator(docs_root=args.docs_root)
+    
+    if args.package == "all":
+        generator.generate_all(dry_run=args.dry_run)
+    else:
+        generator.generate_package(args.package, dry_run=args.dry_run)
+    
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())