framework-m-studio 0.17.2__tar.gz → 0.18.0__tar.gz

{framework_m_studio-0.17.2 → framework_m_studio-0.18.0}/CHANGELOG.md

@@ -1,4 +1,10 @@
-## framework-m-studio v0.17.2
+## framework-m-studio v0.18.0
+
+### Features
+
+- add commit scope linting and CI validator (96cb12a)
+
+**framework-m-studio** v0.17.3: internal dependency bump due to **framework-m** update## framework-m-studio v0.17.2
 
 ### Bug Fixes
 

{framework_m_studio-0.17.2 → framework_m_studio-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: framework-m-studio
-Version: 0.17.2
+Version: 0.18.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
@@ -20,8 +20,8 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Requires-Dist: bandit>=1.9.4
 Requires-Dist: build>=1.5.0
-Requires-Dist: framework-m-core>=0.24.0
-Requires-Dist: framework-m>=0.12.2
+Requires-Dist: framework-m-core>=0.26.0
+Requires-Dist: framework-m>=0.14.0
 Requires-Dist: honcho>=2.0.0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: ipython>=9.14.1

{framework_m_studio-0.17.2 → framework_m_studio-0.18.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "framework-m-studio"
-version = "0.17.2"
+version = "0.18.0"
 description = "Framework M Studio - Visual DocType Builder & Developer Tools"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -21,8 +21,8 @@ classifiers = [
 ]
 
 dependencies = [
-    "framework-m-core>=0.24.0",
-    "framework-m>=0.12.2",
+    "framework-m-core>=0.26.0",
+    "framework-m>=0.14.0",
     # Code generation
     "libcst>=1.8.6",
     "jinja2>=3.1.6",

{framework_m_studio-0.17.2 → framework_m_studio-0.18.0}/src/framework_m_studio/cli/release/__init__.py

@@ -11,6 +11,7 @@ from framework_m_studio.core.shell import run_cmd
 from .cli import (
     release_app,
     release_auto_command,
+    release_lint_scopes_command,
     release_mr_command,
     release_plan_command,
     release_prepare_command,
@@ -64,6 +65,7 @@ __all__ = [
     "push_release_branch",
     "release_app",
     "release_auto_command",
+    "release_lint_scopes_command",
     "release_mr_command",
     "release_plan_command",
     "release_prepare_command",

{framework_m_studio-0.17.2 → framework_m_studio-0.18.0}/src/framework_m_studio/cli/release/cli.py

@@ -15,6 +15,7 @@ from .orchestrator import (
     _load_release_config,
     compute_release_plan,
     create_or_update_mr,
+    lint_release_scopes,
     prepare_release,
     push_release_branch,
     run_release_orchestration,
@@ -199,6 +200,18 @@ async def release_tag_command(
     await tag_and_release(release_config, root_path, git_provider, dry_run)
 
 
+@release_app.command(name="lint-scopes")
+def release_lint_scopes_command(
+    base: str,
+    head: str = "HEAD",
+    config: str = "release-config.json",
+    root: str | None = None,
+) -> None:
+    """Lint that modified packages have corresponding release scopes/tags."""
+    root_path = Path(root) if root else Path.cwd()
+    lint_release_scopes(config, root_path, base, head)
+
+
 def release_schema_command(output: str | None = None) -> None:
     """Generate JSON schema for the release configuration."""
     from .models import ReleaseConfig

{framework_m_studio-0.17.2 → framework_m_studio-0.18.0}/src/framework_m_studio/cli/release/orchestrator.py

@@ -397,3 +397,99 @@ async def run_release_orchestration(
 
     desc = "\n\n".join(sections)
     await create_or_update_mr(branch, config.target_branch, title, desc, provider_cls)
+
+
+def lint_release_scopes(config_path: str, root: Path, base: str, head: str) -> None:
+    """Verify that all modified packages have corresponding release scopes/tags in commits."""
+    import sys
+
+    from .gitops import _parse_commit_message
+
+    config = _load_release_config(config_path, root=root)
+
+    # 1. Get changed files in the diff range
+    cmd_diff = ["git", "diff", "--name-only", f"{base}...{head}"]
+    res_diff = subprocess.run(
+        cmd_diff, cwd=root, capture_output=True, text=True, check=True
+    )
+    changed_files = [
+        line.strip() for line in res_diff.stdout.splitlines() if line.strip()
+    ]
+
+    # 2. Map changed files to packages
+    modified_packages = []
+    for pkg in config.packages:
+        pkg_modified = False
+        for path in pkg.paths:
+            norm_path = path.strip("/") + "/"
+            if any(
+                f.startswith(norm_path) or f == path.strip("/") for f in changed_files
+            ):
+                pkg_modified = True
+                break
+        if pkg_modified:
+            modified_packages.append(pkg)
+
+    if not modified_packages:
+        CLIConsole().success("✅ No packages modified in this range.")
+        return
+
+    # 3. Get all commits in the diff range
+    sep = "||COMMIT_SEP||"
+    log_format = f"%H%n%s%n%b%n{sep}"
+    cmd_log = ["git", "log", f"{base}..{head}", f"--pretty=format:{log_format}"]
+    res_log = subprocess.run(
+        cmd_log, cwd=root, capture_output=True, text=True, check=True
+    )
+
+    commits = []
+    if res_log.stdout:
+        raw_commits = res_log.stdout.split(sep)
+        for raw in raw_commits:
+            if not raw.strip():
+                continue
+            lines = raw.strip().split("\n")
+            if len(lines) < 2:
+                continue
+            parsed = _parse_commit_message("\n".join(lines[1:]), lines[0])
+            if parsed:
+                commits.append(parsed)
+
+    # 4. Validate that each modified package matches at least one commit
+    missing_scopes = []
+    for pkg in modified_packages:
+        matched = False
+        for commit in commits:
+            if commit.body_tags:
+                if "*" in commit.body_tags:
+                    matched = True
+                    break
+                if (
+                    (pkg.name in commit.body_tags)
+                    or (pkg.publish_name and pkg.publish_name in commit.body_tags)
+                    or (commit.scope in pkg.scopes)
+                    or any(tag in pkg.scopes for tag in commit.body_tags)
+                ):
+                    matched = True
+                    break
+            else:
+                if (pkg.include_global and not commit.scope) or (
+                    commit.scope in pkg.scopes
+                ):
+                    matched = True
+                    break
+        if not matched:
+            missing_scopes.append(pkg)
+
+    if missing_scopes:
+        CLIConsole().error("❌ Commit message scope linting failed!")
+        for pkg in missing_scopes:
+            CLIConsole().error(
+                f"Package '{pkg.name}' was modified but no commits in range contain the "
+                f"scope '{pkg.scopes[0]}' or body tag 'Releases: {pkg.name}' / 'Releases: *'."
+            )
+        sys.exit(1)
+
+    CLIConsole().success(
+        "✅ All modified packages have corresponding release scopes/tags."
+    )