framework-m-studio 0.5.2__tar.gz → 0.7.0__tar.gz

{framework_m_studio-0.5.2 → framework_m_studio-0.7.0}/.gitignore

@@ -113,8 +113,14 @@ yarn-error.log*
 
 # Generated Documentation
 docs/developer/generated/
-docs/developer/protocols/
+docs/developer/generated-core/
+docs/user/generated/
 docs/machine/
+docs/adr/index.md
+docs/adr/_sidebar.json
+docs/rfcs/index.md
+docs/rfcs/_sidebar.json
+docs/rfcs/_category_.json
 
 # Website
 website/.docusaurus/

{framework_m_studio-0.5.2 → framework_m_studio-0.7.0}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## framework-m-studio v0.7.0
+
+### Features
+
+- split cli modules and add security command (44214a1)
+- refactor documentation generation CLI and add integration tests (81055f2)
+- implement screenshot pipeline and automated docs generation (4c7ae26)
+- enhance CLI commands and documentation generators (759045b)
+
+### Bug Fixes
+
+- env for deps test (2b99410)
+- add ipython as dependency (e81a27c)
+- improve default target handling in quality commands (7a921ff)
+- studio polish and cli polish (b8f62ec)
+- generate explicit heading IDs in feature summary (9115617)
+- mock environment for consistent source link tests (2946ab6)
+- resolve B310 security vulnerability in OpenAPI export (aaea4a8)
+
+
+## framework-m-studio v0.6.0
+
+### Features
+
+- add entrypoints discovery command (b24dbf1)
+- implement mfe verification cli (bcd87a2)
+
+
 ## framework-m-studio v0.5.2
 
 ### Bug Fixes

{framework_m_studio-0.5.2 → framework_m_studio-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: framework-m-studio
-Version: 0.5.2
+Version: 0.7.0
 Summary: Framework M Studio - Visual DocType Builder & Developer Tools
 Project-URL: Homepage, https://gitlab.com/castlecraft/framework-m
 Project-URL: Documentation, https://gitlab.com/castlecraft/framework-m#readme
@@ -17,11 +17,25 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
-Requires-Dist: framework-m-core>=0.7.1
-Requires-Dist: framework-m>=0.5.2
+Requires-Dist: bandit>=1.9.4
+Requires-Dist: build>=1.0.0
+Requires-Dist: framework-m-core>=0.9.0
+Requires-Dist: framework-m>=0.6.0
 Requires-Dist: honcho>=1.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: ipython>=9.11.0
 Requires-Dist: jinja2>=3.1.0
 Requires-Dist: libcst>=1.0.0
+Requires-Dist: mypy>=1.8.0
+Requires-Dist: playwright>=1.58.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pytest-asyncio>=0.23.0
+Requires-Dist: pytest-cov>=4.1.0
+Requires-Dist: pytest>=8.0.0
+Requires-Dist: python-semantic-release>=9.0.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: ruff>=0.3.0
+Requires-Dist: twine>=5.0.0
 Description-Content-Type: text/markdown
 
 # Framework M Studio

{framework_m_studio-0.5.2 → framework_m_studio-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "framework-m-studio"
-version = "0.5.2"
+version = "0.7.0"
 description = "Framework M Studio - Visual DocType Builder & Developer Tools"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -21,31 +21,38 @@ classifiers = [
 ]
 
 dependencies = [
-    "framework-m-core>=0.7.1",
-    "framework-m>=0.5.2",
+    "framework-m-core>=0.9.0",
+    "framework-m>=0.6.0",
     # Code generation
     "libcst>=1.0.0",
     "jinja2>=3.1.0",
     # Process management for dev command
     "honcho>=1.1.0",
-]
-
-[tool.uv.sources]
-framework-m-core = { workspace = true }
-framework-m = { workspace = true }
-
-[dependency-groups]
-dev = [
+    "playwright>=1.58.0",
+    "pyyaml>=6.0.3",
+    "ipython>=9.11.0",
+    # Developer Tooling (wrapped by Studio CLI)
     "pytest>=8.0.0",
     "pytest-asyncio>=0.23.0",
     "pytest-cov>=4.1.0",
     "mypy>=1.8.0",
     "ruff>=0.3.0",
+    "bandit>=1.9.4",
     "httpx>=0.27.0",
     # Release tools
     "python-semantic-release>=9.0.0",
     "build>=1.0.0",
     "twine>=5.0.0",
+    "pydantic>=2.12.5",
+]
+
+[tool.uv.sources]
+framework-m-core = { workspace = true }
+framework-m = { workspace = true }
+
+[dependency-groups]
+dev = [
+    "types-pyyaml>=6.0.12.20250915",
 ]
 
 [project.entry-points."framework_m_core.cli_commands"]
@@ -53,21 +60,19 @@ dev = [
 codegen = "framework_m_studio.cli:codegen_app"
 studio = "framework_m_studio.cli:studio_app"
 docs = "framework_m_studio.cli:docs_app"
-"docs:generate" = "framework_m_studio.cli:docs_generate"
-"docs:export" = "framework_m_studio.cli:docs_export"
-"docs:adr" = "framework_m_studio.cli:docs_adr"
-"docs:rfc" = "framework_m_studio.cli:docs_rfc"
-new = "framework_m_studio.cli.new:new_app_command"
-"new:doctype" = "framework_m_studio.cli.new:new_doctype_command"
-"new:app" = "framework_m_studio.cli.new:new_app_command"
-"init:frontend" = "framework_m_studio.cli.init:init_frontend_command"
+new = "framework_m_studio.cli.new:new_app"
 test = "framework_m_studio.cli.quality:test_command"
 lint = "framework_m_studio.cli.quality:lint_command"
 format = "framework_m_studio.cli.quality:format_command"
 typecheck = "framework_m_studio.cli.quality:typecheck_command"
+security = "framework_m_studio.cli.quality:security_command"
 console = "framework_m_studio.cli.utility:console_command"
 routes = "framework_m_studio.cli.utility:routes_command"
+entrypoints = "framework_m_studio.cli.utility:entrypoints_command"
 dev = "framework_m_studio.cli.dev:dev_command"
+release = "framework_m_studio.cli.release:release_app"
+deps = "framework_m_studio.cli.deps:deps_app"
+contrib = "framework_m_studio.cli.contrib:contrib_app"
 
 
 [project.urls]

{framework_m_studio-0.5.2 → framework_m_studio-0.7.0}/src/framework_m_studio/app.py

@@ -60,24 +60,24 @@ def _get_spa_response(path: str) -> Response[bytes | dict[str, str]]:
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Framework M Studio - Build Required</title>
     <style>
-        body { 
+        body {
             font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
-            max-width: 600px; 
-            margin: 100px auto; 
+            max-width: 600px;
+            margin: 100px auto;
             padding: 20px;
             line-height: 1.6;
         }
         h1 { color: #333; }
-        code { 
-            background: #f4f4f4; 
-            padding: 2px 6px; 
+        code {
+            background: #f4f4f4;
+            padding: 2px 6px;
             border-radius: 3px;
             font-family: monospace;
         }
         .api-links { margin-top: 30px; }
-        .api-links a { 
-            display: block; 
-            margin: 10px 0; 
+        .api-links a {
+            display: block;
+            margin: 10px 0;
             color: #0066cc;
             text-decoration: none;
         }
@@ -89,7 +89,7 @@ def _get_spa_response(path: str) -> Response[bytes | dict[str, str]]:
     <p>The Studio UI assets have not been built yet.</p>
     <p>To build the UI, run:</p>
     <pre><code>cd apps/studio/studio_ui && pnpm install && pnpm build</code></pre>
-    
+
     <div class="api-links">
         <h3>Available API Endpoints:</h3>
         <a href="/studio/api/health">Health Check</a>
@@ -104,7 +104,7 @@ def _get_spa_response(path: str) -> Response[bytes | dict[str, str]]:
         )
 
     # Check for actual file
-    file_path = STATIC_DIR / path
+    file_path = STATIC_DIR / path.lstrip("/")
     if file_path.is_file():
         # Serve the actual file with proper content type detection
         content = file_path.read_bytes()

framework_m_studio-0.7.0/src/framework_m_studio/cli/__init__.py

@@ -0,0 +1,127 @@
+"""Framework M Studio CLI Commands.
+
+This module provides CLI commands that are registered via entry points
+when framework-m-studio is installed. These extend the base `m` CLI
+with developer tools.
+
+Entry Point Registration (pyproject.toml):
+    [project.entry-points."framework_m.cli_commands"]
+    codegen = "framework_m_studio.cli:codegen_app"
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import cyclopts
+
+# Import utility commands and alias them for top-level registration
+from framework_m_studio.cli.codegen import codegen_app, codegen_client, codegen_doctype
+from framework_m_studio.cli.docs import (
+    docs_app,
+    docs_audit,
+    docs_generate,
+    docs_openapi,
+    docs_screenshots,
+)
+from framework_m_studio.cli.utility import console_command as console
+from framework_m_studio.cli.utility import routes_command as routes
+from framework_m_studio.cli.verify import verify_mfe_command as verify_mfe
+
+# =============================================================================
+# Studio Sub-App (Main command to start Studio server)
+# =============================================================================
+
+studio_app = cyclopts.App(
+    name="studio",
+    help="Start Framework M Studio visual editor",
+)
+
+
+@studio_app.default
+def studio_serve(
+    port: Annotated[
+        int,
+        cyclopts.Parameter(
+            name="--port",
+            help="Port to run Studio on",
+        ),
+    ] = 9000,
+    host: Annotated[
+        str,
+        cyclopts.Parameter(
+            name="--host",
+            help="Host to bind to",
+        ),
+    ] = "0.0.0.0",  # nosec B104
+    reload: Annotated[
+        bool,
+        cyclopts.Parameter(
+            name="--reload",
+            help="Enable auto-reload for development",
+        ),
+    ] = False,
+    cloud: Annotated[
+        bool,
+        cyclopts.Parameter(
+            name="--cloud",
+            help="Enable cloud mode (Git-backed workspaces)",
+        ),
+    ] = False,
+) -> None:
+    """Start Framework M Studio.
+
+    Examples:
+        m studio              # Start on port 9000
+        m studio --port 8000  # Custom port
+        m studio --reload     # Development mode
+        m studio --cloud      # Enable cloud mode
+    """
+    import os
+    import webbrowser
+    from contextlib import suppress
+
+    import uvicorn
+
+    # Print startup banner
+    display_host = "localhost" if host in {"0.0.0.0", "::"} else host  # nosec B104
+    print()
+    print("🎨 Starting Framework M Studio")
+    print(f"   ➜ Local:   http://{display_host}:{port}/studio/")
+    print(f"   ➜ API:     http://{display_host}:{port}/studio/api/")
+    print(f"  🔌 API Health:   http://{display_host}:{port}/studio/api/health")
+    print()
+
+    if cloud:
+        print("☁️  Cloud mode enabled - Git-backed workspaces")
+        os.environ["STUDIO_CLOUD_MODE"] = "1"
+        print()
+
+    with suppress(Exception):
+        webbrowser.open_new_tab(f"http://{display_host}:{port}/studio/")
+
+    # Start uvicorn
+    uvicorn.run(
+        "framework_m_studio.app:app",
+        host=host,
+        port=port,
+        reload=reload,
+        log_level="info",
+    )
+
+
+__all__ = [
+    "codegen_app",
+    "codegen_client",
+    "codegen_doctype",
+    "console",
+    "docs_app",
+    "docs_audit",
+    "docs_generate",
+    "docs_openapi",
+    "docs_screenshots",
+    "routes",
+    "studio_app",
+    "studio_serve",
+    "verify_mfe",
+]

framework_m_studio-0.7.0/src/framework_m_studio/cli/codegen.py

@@ -0,0 +1,107 @@
+"""Codegen CLI Commands.
+
+This module provides code generation tools for Framework M.
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import cyclopts
+
+codegen_app = cyclopts.App(
+    name="codegen",
+    help="Code generation tools for Framework M",
+)
+
+
+@codegen_app.command(name="client")
+def codegen_client(
+    lang: Annotated[
+        str,
+        cyclopts.Parameter(
+            name="--lang",
+            help="Target language: ts (TypeScript) or py (Python)",
+        ),
+    ] = "ts",
+    out: Annotated[
+        str,
+        cyclopts.Parameter(
+            name="--out",
+            help="Output directory for generated code",
+        ),
+    ] = "./generated",
+    openapi_url: Annotated[
+        str,
+        cyclopts.Parameter(
+            name="--openapi-url",
+            help="URL to fetch OpenAPI schema from",
+        ),
+    ] = "http://localhost:8000/schema/openapi.json",
+) -> None:
+    """Generate API client from OpenAPI schema.
+
+    Examples:
+        m codegen client --lang ts --out ./frontend/src/api
+        m codegen client --lang py --out ./scripts/api_client
+    """
+    from pathlib import Path
+
+    from framework_m_studio.sdk_generator import (
+        fetch_openapi_schema,
+        generate_typescript_client,
+        generate_typescript_types,
+    )
+
+    print(f"Generating {lang.upper()} client...")
+    print(f"  OpenAPI URL: {openapi_url}")
+    print(f"  Output: {out}")
+
+    # Create output directory
+    output_path = Path(out)
+    output_path.mkdir(parents=True, exist_ok=True)
+
+    # Fetch schema and generate
+    schema = fetch_openapi_schema(openapi_url)
+    if lang.lower() == "ts":
+        types_code = generate_typescript_types(schema)
+        client_code = generate_typescript_client(schema)
+        (output_path / "types.ts").write_text(types_code)
+        (output_path / "client.ts").write_text(client_code)
+
+
+@codegen_app.command(name="doctype")
+def codegen_doctype(
+    name: Annotated[
+        str,
+        cyclopts.Parameter(help="DocType class name (PascalCase)"),
+    ],
+    app: Annotated[
+        str | None,
+        cyclopts.Parameter(
+            name="--app",
+            help="Target app directory",
+        ),
+    ] = None,
+) -> None:
+    """Generate DocType Python code from schema.
+
+    This is the programmatic version of the Studio UI's
+    DocType builder. Useful for CI/CD pipelines.
+
+    Examples:
+        m codegen doctype Invoice --app apps/billing
+    """
+    print(f"Generating DocType: {name}")
+    if app:
+        print(f"  Target app: {app}")
+    print()
+    print("⚠️  Not yet implemented. Coming in Phase 07.")
+    print("    Will use LibCST for code generation")
+
+
+__all__ = [
+    "codegen_app",
+    "codegen_client",
+    "codegen_doctype",
+]

framework_m_studio-0.7.0/src/framework_m_studio/cli/contrib.py

@@ -0,0 +1,73 @@
+"""Contributor CLI Commands."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Annotated
+
+import cyclopts
+
+contrib_app = cyclopts.App(
+    name="contrib", help="Contributor tooling (CLA checks, etc.)"
+)
+
+
+@contrib_app.command(name="cla-check")
+def cla_check_command(
+    user: Annotated[
+        str | None, cyclopts.Parameter(name="--user", help="GitLab/GitHub username")
+    ] = None,
+    contributors_file: Annotated[
+        str,
+        cyclopts.Parameter(
+            name="--contributors-file", help="Path to contributors JSON"
+        ),
+    ] = "contributors.json",
+) -> None:
+    """Check if a user has signed the Contributor License Agreement."""
+    target_user = user or os.environ.get("GITLAB_USER_LOGIN")
+
+    if not target_user:
+        print("No user provided. Skipping CLA check.")
+        return
+
+    contrib_path = Path(contributors_file)
+    if not contrib_path.exists():
+        print(
+            f"Error: Contributors file not found at {contributors_file}",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    try:
+        data = json.loads(contrib_path.read_text())
+    except json.JSONDecodeError:
+        print(f"Error: Invalid JSON in {contributors_file}", file=sys.stderr)
+        sys.exit(1)
+
+    # Support both the TDD test format and the real repository format
+    icla_users = data.get("icla", [])
+    if "users" in data and "gitlab" in data["users"]:
+        icla_users.extend(data["users"]["gitlab"])
+
+    if target_user in icla_users:
+        print(f"✅ User '{target_user}' has signed the ICLA.")
+        return
+
+    ccla_orgs = data.get("ccla", {})
+    for org, members in ccla_orgs.items():
+        if target_user in members:
+            print(
+                f"✅ User '{target_user}' is covered by CCLA for organization '{org}'."
+            )
+            return
+
+    print(f"❌ User '{target_user}' is not listed in {contributors_file}.")
+    print("Please sign the CLA by adding your username to the contributors file.")
+    sys.exit(1)
+
+
+__all__ = ["cla_check_command", "contrib_app"]