code-standards 7.33.0__tar.gz → 8.1.1__tar.gz

{code_standards-7.33.0 → code_standards-8.1.1}/.gitignore

@@ -1,4 +1,4 @@
-node_modules/
+node_modules
 .astro/
 dist/
 build/

{code_standards-7.33.0 → code_standards-8.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: code-standards
-Version: 7.33.0
+Version: 8.1.1
 Summary: One deterministic quality gate for Sarj Python, TypeScript, Swift, Kotlin, shell, SQL, IaC, and repository policy.
 Project-URL: Homepage, https://code-standards.sarj.ai/
 Project-URL: Documentation, https://code-standards.sarj.ai/cli/
@@ -27,9 +27,10 @@ Requires-Dist: pydantic==2.13.5
 Requires-Dist: pyyaml==6.0.3
 Requires-Dist: repo-standards==6.0.1
 Requires-Dist: ruff==0.16.8
-Requires-Dist: sarj-iac-lint==0.15.13
-Requires-Dist: sarj-python-lint==0.88.0
-Requires-Dist: sarj-sql-lint==0.17.7
+Requires-Dist: sarj-iac-lint==0.16.0
+Requires-Dist: sarj-python-lint==1.1.1
+Requires-Dist: sarj-rule-contracts==0.1.0
+Requires-Dist: sarj-sql-lint==0.18.0
 Requires-Dist: semgrep==1.178.0
 Requires-Dist: shellcheck-py==0.11.0.1; (sys_platform == 'darwin' and platform_machine == 'arm64') or (sys_platform == 'darwin' and platform_machine == 'x86_64') or (sys_platform == 'linux' and platform_machine == 'x86_64') or (sys_platform == 'win32' and platform_machine == 'AMD64')
 Requires-Dist: typer==0.27.2
@@ -56,6 +57,8 @@ code-standards doctor
 code-standards update
 ```
 
-Use repeatable `check --rule ENGINE:ID` selectors to check only selected Sarj custom rules. Exclusions, baselines, and severities still apply; upstream rules such as Ruff IDs are not supported. Native linters execute only selected rules; ESLint runs its configured rules and filters the findings.
+Use repeatable `check --rule ENGINE:ID` selectors to check only selected Sarj custom rules. Exclusions, baselines, and severities still apply; upstream rules such as Ruff IDs are not supported. Native linters and ESLint execute only selected rules. ESLint retains configured parsers, options, severities, and suppression directives.
+
+`check --jobs 2` overlaps native analysis with the external-tool pipeline. The default is `--jobs 1`; external tools remain sequential and report ordering is deterministic.
 
 [Documentation](https://code-standards.sarj.ai/) · [Source](https://github.com/sarj-ai/code-standards)

{code_standards-7.33.0 → code_standards-8.1.1}/README.md

@@ -19,6 +19,8 @@ code-standards doctor
 code-standards update
 ```
 
-Use repeatable `check --rule ENGINE:ID` selectors to check only selected Sarj custom rules. Exclusions, baselines, and severities still apply; upstream rules such as Ruff IDs are not supported. Native linters execute only selected rules; ESLint runs its configured rules and filters the findings.
+Use repeatable `check --rule ENGINE:ID` selectors to check only selected Sarj custom rules. Exclusions, baselines, and severities still apply; upstream rules such as Ruff IDs are not supported. Native linters and ESLint execute only selected rules. ESLint retains configured parsers, options, severities, and suppression directives.
+
+`check --jobs 2` overlaps native analysis with the external-tool pipeline. The default is `--jobs 1`; external tools remain sequential and report ordering is deterministic.
 
 [Documentation](https://code-standards.sarj.ai/) · [Source](https://github.com/sarj-ai/code-standards)

{code_standards-7.33.0 → code_standards-8.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "code-standards"
-version = "7.33.0"
+version = "8.1.1"
 description = "One deterministic quality gate for Sarj Python, TypeScript, Swift, Kotlin, shell, SQL, IaC, and repository policy."
 readme = "README.md"
 requires-python = ">=3.14"
@@ -16,6 +16,7 @@ classifiers = [
   "Topic :: Software Development :: Quality Assurance",
 ]
 dependencies = [
+  "sarj-rule-contracts==0.1.0",
   "pathspec==1.1.1",
   "basedpyright==1.40.1",
   "deptry==0.25.1",
@@ -28,9 +29,9 @@ dependencies = [
   "ruff==0.16.8",
   "semgrep==1.178.0",
   "shellcheck-py==0.11.0.1; (sys_platform == 'darwin' and platform_machine == 'arm64') or (sys_platform == 'darwin' and platform_machine == 'x86_64') or (sys_platform == 'linux' and platform_machine == 'x86_64') or (sys_platform == 'win32' and platform_machine == 'AMD64')",
-  "sarj-iac-lint==0.15.13",
-  "sarj-python-lint==0.88.0",
-  "sarj-sql-lint==0.17.7",
+  "sarj-iac-lint==0.16.0",
+  "sarj-python-lint==1.1.1",
+  "sarj-sql-lint==0.18.0",
   "typer==0.27.2",
 ]
 
@@ -66,6 +67,7 @@ dev = [
   "pytest>=9.1.1",
 ]
 [tool.uv.sources]
+sarj-rule-contracts = { path = "../contracts", editable = true }
 # Development uses the sibling packages while wheel smoke tests resolve the
 # same exact, already-published versions declared above.
 sarj-iac-lint = { path = "../iac", editable = true }

{code_standards-7.33.0 → code_standards-8.1.1}/src/sarj_standards/api.py

@@ -63,6 +63,7 @@ from .libs.linting.library_policy import (
 )
 from .libs.linting.policy import Policy
 from .libs.linting.runner import group_paths, run as check
+from .libs.linting.scheduling import analyze_groups
 from .libs.rules import RuleEngine, RuleId, RuleSelection, RuleSelector
 from .libs.typed_containers import is_object_list, is_object_mapping
 
@@ -238,7 +239,7 @@ class Standards:
             return _operation_result(max(source_status, eslint_status, 1 if findings else 0), findings=findings)
         return _operation_result(_verify(self.root))
 
-    def analyze(  # ruff: ignore[too-many-locals] -- one boundary coordinates routing, policy, and coverage.
+    def analyze(
         self,
         paths: Sequence[str] | None = None,
         *,
@@ -250,7 +251,10 @@ class Standards:
         react_doctor_triggered: bool = False,
         include_react_doctor: bool = True,
         pass_on_unpruned_eslint_suppressions: bool = False,
+        jobs: int = 1,
     ) -> AnalysisReport:
+        if jobs not in {1, 2}:
+            return _failed_analysis(self.root, "invalid-input", "analysis jobs must be 1 or 2")
         try:
             normalized_trust = TrustMode(trust)
             normalized_mode = AnalysisMode(mode)
@@ -277,19 +281,24 @@ class Standards:
         react_doctor_full_scan = not staged and (
             requested_paths is None or any(Path(path) == Path() for path in requested_paths)
         )
-        native = analyze_paths(
-            active_selected,
-            root=self.root,
-            policy=selection_policy,
-            grouped=selected_groups,
-            rule_selection=rule_selection,
-        )
-        if rule_selection is None:
-            native = _with_library_policy(self.root, native, active_selected, selection_policy)
-        if rule_selection is None and normalized_mode is AnalysisMode.POLICY:
-            native = _with_repository_analysis(self.root, native, staged=staged)
+
+        def native_analysis() -> tuple[ToolReport, ...]:
+            native = analyze_paths(
+                active_selected,
+                root=self.root,
+                policy=selection_policy,
+                grouped=selected_groups,
+                rule_selection=rule_selection,
+            )
+            if rule_selection is None:
+                native = _with_library_policy(self.root, native, active_selected, selection_policy)
+            if rule_selection is None and normalized_mode is AnalysisMode.POLICY:
+                native = _with_repository_analysis(self.root, native, staged=staged)
+            return native.tools
+
         coverage = _selection_coverage(self.root, selected, active_selected, selected_groups, rule_selection)
         if not external:
+            native = report_from_tools(self.root, native_analysis())
             _native_typescript_coverage(selected_groups, adopted, rule_selection, coverage)
             if normalized_mode in {AnalysisMode.POLICY, AnalysisMode.OBSERVE}:
                 native = _with_warning_severity(native, _warning_rule_keys())
@@ -305,21 +314,26 @@ class Standards:
                     CoverageDisposition.NOT_REQUESTED,
                 )
             )
-        external_reports = _selected_external_analysis(
-            active_selected,
-            root=self.root,
-            selected_groups=selected_groups,
-            adopted=adopted,
-            selection_policy=selection_policy,
-            rule_selection=rule_selection,
-            normalized_trust=normalized_trust,
-            include_react_doctor=include_react_doctor,
-            react_doctor_triggered=react_doctor_triggered,
-            staged=staged,
-            react_doctor_full_scan=react_doctor_full_scan,
-            pass_on_unpruned_eslint_suppressions=pass_on_unpruned_eslint_suppressions,
+
+        def external_analysis() -> tuple[ToolReport, ...]:
+            return _selected_external_analysis(
+                active_selected,
+                root=self.root,
+                selected_groups=selected_groups,
+                adopted=adopted,
+                selection_policy=selection_policy,
+                rule_selection=rule_selection,
+                normalized_trust=normalized_trust,
+                include_react_doctor=include_react_doctor,
+                react_doctor_triggered=react_doctor_triggered,
+                staged=staged,
+                react_doctor_full_scan=react_doctor_full_scan,
+                pass_on_unpruned_eslint_suppressions=pass_on_unpruned_eslint_suppressions,
+            )
+
+        combined = report_from_tools(
+            self.root, analyze_groups(self.root, native_analysis, external_analysis, jobs=jobs)
         )
-        combined = report_from_tools(self.root, (*native.tools, *external_reports))
         if normalized_mode in {AnalysisMode.POLICY, AnalysisMode.OBSERVE}:
             combined = _with_warning_severity(combined, _warning_rule_keys())
         return _with_coverage(
@@ -335,8 +349,9 @@ class Standards:
         mode: AnalysisMode | str = AnalysisMode.POLICY,
         rules: Sequence[str | RuleSelector] | None = None,
         staged: bool = False,
+        jobs: int = 1,
     ) -> AnalysisReport:
-        return self.analyze(paths, external=external, trust=trust, mode=mode, rules=rules, staged=staged)
+        return self.analyze(paths, external=external, trust=trust, mode=mode, rules=rules, staged=staged, jobs=jobs)
 
     def fix(self) -> Result:
         from .libs.adoption import (  # ruff: ignore[import-outside-top-level] -- selected operation only
@@ -603,6 +618,11 @@ def _selected_external_analysis(
     react_doctor_full_scan: bool,
     pass_on_unpruned_eslint_suppressions: bool,
 ) -> tuple[ToolReport, ...]:
+    rule_ids = (
+        frozenset(str(value) for value in rule_selection.ids_for(RuleEngine.ESLINT))
+        if rule_selection is not None
+        else None
+    )
     run_eslint = rule_selection is None or RuleEngine.ESLINT in rule_selection.engines
     external_reports = (
         (
@@ -615,6 +635,7 @@ def _selected_external_analysis(
                     frozenset({"eslint"}) if rule_selection is not None else frozenset(adopted.enabled_capabilities)
                 ),
                 grouped=selected_groups,
+                rule_ids=rule_ids,
                 include_react_doctor=include_react_doctor and rule_selection is None,
                 force_react_doctor=react_doctor_triggered,
                 react_doctor_staged=staged,
@@ -628,6 +649,7 @@ def _selected_external_analysis(
                 trust=normalized_trust,
                 capabilities=frozenset({"eslint"}) if rule_selection is not None else None,
                 grouped=selected_groups,
+                rule_ids=rule_ids,
                 include_react_doctor=include_react_doctor and rule_selection is None,
                 force_react_doctor=react_doctor_triggered,
                 react_doctor_staged=staged,

{code_standards-7.33.0 → code_standards-8.1.1}/src/sarj_standards/cli/main.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from dataclasses import dataclass, field
+from dataclasses import asdict, dataclass, field
 from datetime import timedelta
 from enum import StrEnum
 from functools import lru_cache
@@ -122,6 +122,7 @@ class _Args:
     roots: list[Path] = field(default_factory=list)
     include_text: Path | None = None
     rules_cmd: str = ""
+    repeats: int = 5
     rule_category: str = ""
     rule_summary: str = ""
     apply_rule: bool = False
@@ -145,6 +146,7 @@ class _Args:
     release_exclude_file: list[Path] = field(default_factory=list)
     output: Path | None = None
     external: bool = False
+    jobs: int = 1
     trust: str = "safe"
     trust_repository_code: bool = False
     before: str = ""
@@ -156,6 +158,7 @@ class _Args:
     hooks: manifest.HookManager | None = None
     show_cmd: str = ""
     catalog_cmd: str = ""
+    typescript_built: bool = False
     exclude_cmd: str = ""
     exclude_kind: str = ""
     value: str = ""
@@ -1000,6 +1003,7 @@ def cmd_verify(args: _Args) -> int:
         root,
         None if adopted is None else adopted.verify_paths,
         raw=adopted is None,
+        jobs=args.jobs,
         trusted=args.trust_repository_code,
     )
 
@@ -1076,7 +1080,7 @@ def cmd_check(args: _Args) -> int:
             return health_status
         args.files = [path for path in args.files if runner.accepts_hook_path(Path(path), root=root)]
         if not args.files and not scope.react_doctor_triggered:
-            return _run_canonical_check(root, (), trusted=args.trust_repository_code, staged=True)
+            return _run_canonical_check(root, (), trusted=args.trust_repository_code, staged=True, jobs=args.jobs)
     if args.output_format != "text":
         return _check_machine_output(args, root, scope)
     return _check_text_output(args, root, scope)
@@ -1090,6 +1094,7 @@ def _check_selected_rules(args: _Args, root: Path, scope: _CheckScope) -> int:
     paths = args.files if args.files or args.staged or scope.pull_request_scoped else None
     report = Standards(root).analyze(
         paths,
+        jobs=args.jobs,
         rules=args.selected_rules,
         external=any(selector.engine.value == "eslint" for selector in args.selected_rules),
         trust=TrustMode.TRUSTED if args.trust_repository_code else TrustMode.SAFE,
@@ -1110,8 +1115,9 @@ def _check_text_output(args: _Args, root: Path, scope: _CheckScope) -> int:
                     (),
                     trusted=args.trust_repository_code,
                     react_doctor_triggered=True,
+                    jobs=args.jobs,
                 )
-            return _run_canonical_check(root, (), trusted=args.trust_repository_code)
+            return _run_canonical_check(root, (), trusted=args.trust_repository_code, jobs=args.jobs)
     if not args.files:
         return cmd_verify(args)
     check_options: dict[str, bool] = {
@@ -1120,7 +1126,7 @@ def _check_text_output(args: _Args, root: Path, scope: _CheckScope) -> int:
     }
     if scope.react_doctor_triggered:
         check_options["react_doctor_triggered"] = True
-    return _run_canonical_check(root, list(args.files), **check_options)
+    return _run_canonical_check(root, list(args.files), jobs=args.jobs, **check_options)
 
 
 @dataclass(slots=True)
@@ -1229,6 +1235,7 @@ def _check_machine_output(args: _Args, root: Path, scope: _CheckScope) -> int:
         report = Standards(root).analyze(
             (),
             external=True,
+            jobs=args.jobs,
             trust=TrustMode.TRUSTED if args.trust_repository_code else TrustMode.SAFE,
             mode=AnalysisMode.POLICY,
             react_doctor_triggered=scope.react_doctor_triggered,
@@ -1308,6 +1315,7 @@ def _run_canonical_check(
     trusted: bool = False,
     staged: bool = False,
     react_doctor_triggered: bool = False,
+    jobs: int = 1,
 ) -> int:
     from sarj_standards.api import AnalysisMode, Standards, TrustMode  # ruff: ignore[import-outside-top-level]
     from sarj_standards.libs.diagnostics import to_text  # ruff: ignore[import-outside-top-level]
@@ -1315,6 +1323,7 @@ def _run_canonical_check(
     report = Standards(root).analyze(
         paths,
         external=True,
+        jobs=jobs,
         trust=TrustMode.TRUSTED if trusted else TrustMode.SAFE,
         mode=AnalysisMode.RAW if raw else AnalysisMode.POLICY,
         staged=staged,
@@ -1337,6 +1346,7 @@ def cmd_analyze(args: _Args) -> int:
         return 2
     report = Standards(root).analyze(
         args.files or None,
+        jobs=args.jobs,
         external=args.external,
         trust=args.trust,
         mode=AnalysisMode(args.analysis_mode),
@@ -1359,6 +1369,7 @@ def cmd_rule_evaluate(args: _Args) -> int:
         return 2
     report = Standards(root).analyze(
         args.files or None,
+        jobs=args.jobs,
         external=any(selector.engine.value == "eslint" for selector in args.selected_rules),
         trust=TrustMode.TRUSTED if args.trust_repository_code else TrustMode.SAFE,
         mode=(AnalysisMode.CORPUS if args.evaluation_scope is _EvaluationScope.CORPUS else AnalysisMode.POLICY),
@@ -1548,6 +1559,7 @@ def cmd_observe(args: _Args) -> int:
         return 2
     report = Standards(root).analyze(
         args.files or None,
+        jobs=args.jobs,
         external=any(selector.engine.value == "eslint" for selector in args.selected_rules),
         trust=TrustMode.TRUSTED if args.trust_repository_code else TrustMode.SAFE,
         mode=AnalysisMode.OBSERVE,
@@ -2621,6 +2633,7 @@ class _ExcludeKind(StrEnum):
 
 
 class _ReleaseTargetChoice(StrEnum):
+    CONTRACTS = "contracts"
     TYPESCRIPT = "typescript"
     BOOTSTRAP = "bootstrap"
     PYTHON = "python"
@@ -2837,6 +2850,9 @@ def build_app(handler: Callable[[_Args], int] = _dispatch) -> typer.Typer:
                 help="allow executable repository ESLint configuration (generated hooks and CI set this explicitly)",
             ),
         ] = False,
+        jobs: Annotated[
+            int, typer.Option("--jobs", min=1, max=2, help="overlap native and external analysis (default: 1)")
+        ] = 1,
         staged: Annotated[
             bool,
             typer.Option(
@@ -2861,6 +2877,7 @@ def build_app(handler: Callable[[_Args], int] = _dispatch) -> typer.Typer:
             _Args(
                 dest=_command_root(ctx),
                 cmd="check",
+                jobs=jobs,
                 trust_repository_code=trust_repository_code,
                 staged=staged,
                 selected_rules=selected_rules if selected_rules is not None else [],
@@ -3725,6 +3742,31 @@ def build_app(handler: Callable[[_Args], int] = _dispatch) -> typer.Typer:
             )
         )
 
+    @group_maintain_rules.command("bench", help="measure native Python analysis with diagnostic and source digests")
+    def command_maintain_rules_bench(
+        ctx: typer.Context,
+        files: Annotated[list[str], typer.Argument(help="Python files or directories")],
+        *,
+        repeats: Annotated[int, typer.Option(min=1)] = 5,
+        selected_rules: Annotated[
+            list[RuleSelector] | None,
+            typer.Option(
+                "--rule", parser=_parse_rule_selector, help="python:ID selector; defaults to all Python rules"
+            ),
+        ] = None,
+    ) -> int:
+        return handler(
+            _Args(
+                dest=_command_root(ctx),
+                cmd="maintain",
+                repo_cmd="rules",
+                rules_cmd="bench",
+                files=files,
+                repeats=repeats,
+                selected_rules=selected_rules or [],
+            )
+        )
+
     @group_maintain_rules.command("changes", help="compare rule inventory and policy between two Git revisions")
     def command_maintain_rules_changes(
         ctx: typer.Context,
@@ -3806,6 +3848,11 @@ def build_app(handler: Callable[[_Args], int] = _dispatch) -> typer.Typer:
     @group_maintain_catalog.command("check", help="verify the public catalog matches every live rule")
     def command_maintain_catalog_check(
         ctx: typer.Context,
+        *,
+        typescript_built: Annotated[
+            bool,
+            typer.Option("--typescript-built", help="reuse the TypeScript build completed by this verification run"),
+        ] = False,
     ) -> int:
         return handler(
             _Args(
@@ -3813,6 +3860,7 @@ def build_app(handler: Callable[[_Args], int] = _dispatch) -> typer.Typer:
                 cmd="maintain",
                 repo_cmd="catalog",
                 catalog_cmd="check",
+                typescript_built=typescript_built,
             )
         )
 
@@ -3972,8 +4020,11 @@ def _run_repo_check(args: _Args) -> int:
 
 
 def _run_repo_sync_ledger(args: _Args) -> int:
-    from sarj_standards.libs.repository import rule_maintenance  # ruff: ignore[import-outside-top-level]
+    from sarj_standards.libs.repository import rule_checkout, rule_maintenance  # ruff: ignore[import-outside-top-level]
 
+    rule_checkout.ensure_current(
+        _resolve_dest(args.dest), ("maintain", "sync-ledger", *(("--check",) if args.check else ())), all_engines=True
+    )
     result = rule_maintenance.sync_ledger(_resolve_dest(args.dest), check=args.check)
     print(result.message)
     return result.status
@@ -4010,8 +4061,17 @@ def _run_repo_hooks(args: _Args) -> int:
 
 
 def _run_repo_rules(args: _Args) -> int:
-    from sarj_standards.libs.repository import rule_inventory_artifact  # ruff: ignore[import-outside-top-level]
+    from sarj_standards.libs.repository import rule_checkout, rule_inventory_artifact  # ruff: ignore[import-outside-top-level]
 
+    if args.selector is not None and args.rules_cmd in {"new", "verify", "prepare", "stage-warning", "promote-error"}:
+        rule_checkout.ensure_current(
+            _resolve_dest(args.dest),
+            ("maintain", "rules", args.rules_cmd, str(args.selector)),
+            engine=args.selector.engine,
+            all_engines=args.rules_cmd in {"prepare", "stage-warning", "promote-error"},
+        )
+    if args.rules_cmd in {"sync", "check"}:
+        rule_checkout.ensure_current(_resolve_dest(args.dest), ("maintain", "rules", args.rules_cmd), all_engines=True)
     if args.rules_cmd == "manifest":
         print(json.dumps(rule_inventory_artifact.load(), indent=2))
         return 0
@@ -4019,6 +4079,8 @@ def _run_repo_rules(args: _Args) -> int:
         return _run_repo_rules_changes(args)
     if args.rules_cmd == "evaluate":
         return cmd_rule_evaluate(args)
+    if args.rules_cmd == "bench":
+        return _run_repo_rules_bench(args)
     if args.rules_cmd == "new":
         return _run_repo_rules_new(args)
     if args.rules_cmd == "verify":
@@ -4030,10 +4092,38 @@ def _run_repo_rules(args: _Args) -> int:
     return result.status
 
 
+def _run_repo_rules_bench(args: _Args) -> int:
+    from sarj_python_lint.benchmark import measure  # ruff: ignore[import-outside-top-level] -- benchmark-only dependency
+    from sarj_python_lint.rules import REGISTRY  # ruff: ignore[import-outside-top-level] -- benchmark selection
+
+    for selector in args.selected_rules:
+        if selector.engine.value != "python" or selector.rule_id not in REGISTRY:
+            print(f"error: benchmark requires a registered python:ID selector: {selector}", file=sys.stderr)
+            return 2
+    root = _resolve_dest(args.dest)
+    try:
+        result = measure(
+            [root / path for path in args.files],
+            [selector.rule_id for selector in args.selected_rules] or None,
+            repeats=args.repeats,
+        )
+    except (OSError, ValueError, RuntimeError) as exc:
+        print(f"error: benchmark failed: {exc}", file=sys.stderr)
+        return 2
+    print(json.dumps(asdict(result), indent=2))
+    return 0
+
+
 def _run_repo_catalog(args: _Args) -> int:
-    from sarj_standards.libs.repository import rule_catalog_artifact  # ruff: ignore[import-outside-top-level]
+    from sarj_standards.libs.repository import rule_catalog_artifact, rule_checkout  # ruff: ignore[import-outside-top-level]
 
-    result = rule_catalog_artifact.sync(_resolve_dest(args.dest), check=args.catalog_cmd == "check")
+    root = _resolve_dest(args.dest)
+    rule_checkout.ensure_current(root, ("maintain", "catalog", args.catalog_cmd), all_engines=True)
+    if args.typescript_built:
+        projection = rule_catalog_artifact.typescript_specs(root, already_built=True)
+        result = rule_catalog_artifact.sync(root, check=args.catalog_cmd == "check", typescript=projection)
+    else:
+        result = rule_catalog_artifact.sync(root, check=args.catalog_cmd == "check")
     print(result.message)
     return result.status
 
@@ -4150,7 +4240,7 @@ def _run_repo_release_publish(args: _Args, root: Path) -> int:
 
     target = args.release_target
     match target:
-        case "typescript" | "bootstrap" | "python" | "sql" | "iac" | "standards" | "tsconfig":
+        case "typescript" | "bootstrap" | "contracts" | "python" | "sql" | "iac" | "standards" | "tsconfig":
             publish_target = target
         case _:
             return 2
@@ -4218,7 +4308,7 @@ def _run_repo_rules_verify(args: _Args) -> int:
         msg = "verify requires a rule selector"
         raise TypeError(msg)
     try:
-        result = rule_authoring.verify(_resolve_dest(args.dest), args.selector)
+        result = rule_authoring.verify(_resolve_dest(args.dest), args.selector, run_tests=True)
     except (OSError, TypeError, ValueError, RuntimeError) as exc:
         print(f"error: cannot verify rule: {exc}", file=sys.stderr)
         return 2
@@ -4232,22 +4322,28 @@ def _run_repo_rules_stage_warning(args: _Args) -> int:
     if args.selector is None:  # pragma: no cover - Typer requires the positional value
         msg = f"{args.rules_cmd} requires a rule selector"
         raise TypeError(msg)
+    typescript = None
     if args.rules_cmd == "prepare":
         from sarj_standards.libs.repository import (  # ruff: ignore[import-outside-top-level]
             rule_authoring,
         )
 
         try:
-            verified = rule_authoring.verify(_resolve_dest(args.dest), args.selector)
+            verified = rule_authoring.verify(_resolve_dest(args.dest), args.selector, run_tests=True)
         except (OSError, TypeError, ValueError, RuntimeError) as exc:
             print(f"error: cannot verify rule before preparation: {exc}", file=sys.stderr)
             return 2
         if verified.status != 0:
             print(verified.message)
             return verified.status
+        typescript = verified.typescript
     try:
         operation = rule_lifecycle.promote_error if args.rules_cmd == "promote-error" else rule_lifecycle.stage_warning
-        result = operation(_resolve_dest(args.dest), args.selector, check=args.check)
+        result = (
+            operation(_resolve_dest(args.dest), args.selector, check=args.check)
+            if typescript is None
+            else operation(_resolve_dest(args.dest), args.selector, check=args.check, typescript=typescript)
+        )
     except (OSError, TypeError, ValueError, RuntimeError) as exc:
         print(f"error: cannot update rule lifecycle: {exc}", file=sys.stderr)
         return 2