code-standards 7.0.4__tar.gz → 7.1.0__tar.gz

{code_standards-7.0.4 → code_standards-7.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: code-standards
-Version: 7.0.4
+Version: 7.1.0
 Summary: One deterministic quality gate for Sarj Python, TypeScript, SQL, IaC, and repository policy.
 Project-URL: Homepage, https://code-standards.sarj.ai/
 Project-URL: Documentation, https://code-standards.sarj.ai/cli/
@@ -26,7 +26,7 @@ Requires-Dist: pydantic==2.13.4
 Requires-Dist: pyyaml==6.0.3
 Requires-Dist: ruff==0.16.3
 Requires-Dist: sarj-iac-lint==0.14.3
-Requires-Dist: sarj-python-lint==0.77.1
+Requires-Dist: sarj-python-lint==0.78.0
 Requires-Dist: sarj-sql-lint==0.16.1
 Description-Content-Type: text/markdown
 

{code_standards-7.0.4 → code_standards-7.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "code-standards"
-version = "7.0.4"
+version = "7.1.0"
 description = "One deterministic quality gate for Sarj Python, TypeScript, SQL, IaC, and repository policy."
 readme = "README.md"
 requires-python = ">=3.14"
@@ -25,7 +25,7 @@ dependencies = [
   "PyYAML==6.0.3",
   "ruff==0.16.3",
   "sarj-iac-lint==0.14.3",
-  "sarj-python-lint==0.77.1",
+  "sarj-python-lint==0.78.0",
   "sarj-sql-lint==0.16.1",
 ]
 

{code_standards-7.0.4 → code_standards-7.1.0}/src/sarj_standards/_meta.py

@@ -14,6 +14,9 @@ CONFIGS_DIR: Path = Path(__file__).resolve().parent / "configs"
 RUFF_STRICT: Path = CONFIGS_DIR / "ruff.strict.toml"
 RUFF_APPLICATION: Path = CONFIGS_DIR / "ruff.application.toml"
 PYRIGHT_STRICT: Path = CONFIGS_DIR / "pyright.strict.json"
+BASEDPYRIGHT_STRICT: Path = CONFIGS_DIR / "basedpyright.strict.json"
+RUFF_PYTHON315_WATCH: Path = CONFIGS_DIR / "ruff.python315-watch.toml"
+BASEDPYRIGHT_PYTHON315_WATCH: Path = CONFIGS_DIR / "basedpyright.python315-watch.json"
 ESLINT_STRICT: Path = CONFIGS_DIR / "eslint.strict.mjs"
 ESLINT_APPLICATION: Path = CONFIGS_DIR / "eslint.application.mjs"
 MARKDOWNLINT_STRICT: Path = CONFIGS_DIR / "markdownlint.strict.yaml"

{code_standards-7.0.4 → code_standards-7.1.0}/src/sarj_standards/api.py

@@ -240,6 +240,7 @@ class Standards:
         mode: AnalysisMode | str = AnalysisMode.POLICY,
         rules: Sequence[str | RuleSelector] | None = None,
         staged: bool = False,
+        react_doctor_triggered: bool = False,
     ) -> AnalysisReport:
         try:
             normalized_trust = TrustMode(trust)
@@ -264,12 +265,18 @@ class Standards:
         try:
             baseline_counts: dict[str, int]
             baseline_counts = (
-                diagnostic_baseline.load(self.root / adopted.diagnostic_baseline)
+                diagnostic_baseline.load(
+                    self.root / adopted.diagnostic_baseline,
+                    require_v2=True,
+                    expected_bundle_version=__version__,
+                    expected_catalog_digest=diagnostic_baseline.bundled_catalog_digest(),
+                )
                 if normalized_mode is AnalysisMode.POLICY
                 and adopted is not None
                 and adopted.diagnostic_baseline is not None
                 else {}
             )
+            changed_scope = diagnostic_baseline.changed_line_scope(self.root, staged=staged)
         except (OSError, TypeError, ValueError) as exc:
             return _failed_analysis(self.root, "baseline-failure", str(exc))
         try:
@@ -335,7 +342,9 @@ class Standards:
                 )
             if normalized_mode in {AnalysisMode.POLICY, AnalysisMode.OBSERVE}:
                 native = _with_warning_severity(native, _warning_rule_keys())
-            return _with_coverage(_without_baselined_diagnostics(native, baseline_counts), coverage)
+            return _with_coverage(
+                _without_baselined_diagnostics(native, baseline_counts, changed_scope=changed_scope), coverage
+            )
         if selected_groups.typescript and adopted is not None and "eslint" not in adopted.configs:
             coverage.append(
                 CoverageNotice(
@@ -355,7 +364,8 @@ class Standards:
                     policy=selection_policy,
                     capabilities=(frozenset({"eslint"}) if rule_selection is not None else frozenset(adopted.configs)),
                     grouped=selected_groups,
-                    include_react_doctor=(paths is None or staged) and rule_selection is None,
+                    include_react_doctor=rule_selection is None,
+                    force_react_doctor=react_doctor_triggered,
                     react_doctor_staged=staged,
                 )
                 if adopted is not None
@@ -364,7 +374,8 @@ class Standards:
                     root=self.root,
                     trust=normalized_trust,
                     grouped=selected_groups,
-                    include_react_doctor=(paths is None or staged) and rule_selection is None,
+                    include_react_doctor=rule_selection is None,
+                    force_react_doctor=react_doctor_triggered,
                     react_doctor_staged=staged,
                 )
             )
@@ -386,7 +397,9 @@ class Standards:
         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(_without_baselined_diagnostics(combined, baseline_counts), coverage)
+        return _with_coverage(
+            _without_baselined_diagnostics(combined, baseline_counts, changed_scope=changed_scope), coverage
+        )
 
     def run(
         self,
@@ -578,7 +591,12 @@ def _failed_analysis(root: Path, kind: str, message: str) -> AnalysisReport:
     return AnalysisReport(root, Completion.FAILED, Conclusion.INCONCLUSIVE, (tool,))
 
 
-def _without_baselined_diagnostics(report: AnalysisReport, counts: dict[str, int]) -> AnalysisReport:
+def _without_baselined_diagnostics(
+    report: AnalysisReport,
+    counts: dict[str, int],
+    *,
+    changed_scope: diagnostic_baseline.ChangedLineScope | None = None,
+) -> AnalysisReport:
     if not counts:
         return report
     remaining = counts.copy()
@@ -586,6 +604,8 @@ def _without_baselined_diagnostics(report: AnalysisReport, counts: dict[str, int
     def active(diagnostic: Diagnostic) -> bool:
         if not diagnostic_baseline.is_baselineable(diagnostic) or diagnostic.code == "SARJ206":
             return True
+        if diagnostic_baseline.touches_changed_lines(diagnostic, changed_scope):
+            return True
         fingerprint = diagnostic.fingerprint
         budget = 0 if fingerprint is None else remaining.get(fingerprint, 0)
         if budget < 1 or fingerprint is None:

{code_standards-7.0.4 → code_standards-7.1.0}/src/sarj_standards/cli/main.py

@@ -50,6 +50,19 @@ _INVALID_DOCTOR_IDS = frozenset(
         "doctor.package-json.invalid",
     }
 )
+_REACT_DOCTOR_METADATA = frozenset(
+    {
+        "doctor.config.json",
+        "eslint.config.js",
+        "eslint.config.mjs",
+        "package-lock.json",
+        "package.json",
+        "pnpm-lock.yaml",
+        "tsconfig.json",
+        "yarn.lock",
+    }
+)
+_REACT_DOCTOR_TYPESCRIPT_SUFFIXES = frozenset({".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx", ".mts", ".cts"})
 
 
 class _EvaluationScope(StrEnum):
@@ -125,6 +138,8 @@ class _Args(argparse.Namespace):
     selector: RuleSelector | None = None
     evaluation_scope: _EvaluationScope = _EvaluationScope.CORPUS
     baseline: Path | None = None
+    baseline_rules: list[str]
+    react_doctor_triggered: bool = False
     package: list[str]
     exclude_subtree: list[str]
     allow_increase: bool = False
@@ -141,6 +156,7 @@ class _Args(argparse.Namespace):
         self.repo_only = []
         self.roots = []
         self.release_exclude = []
+        self.baseline_rules = []
         self.release_exclude_file = []
         self.release_targets = []
         self.wheels = []
@@ -770,7 +786,7 @@ def cmd_library_policy(args: _Args, *, selected_paths: Iterable[str] | None = No
     return 1 if findings else 0
 
 
-def cmd_check(args: _Args) -> int:
+def cmd_check(args: _Args) -> int:  # ruff: ignore[too-many-locals] -- staged and PR scopes retain Doctor triggers.
     from sarj_standards.libs.linting import external, runner  # ruff: ignore[import-outside-top-level]
 
     root = _resolve_dest(args.dest)
@@ -779,9 +795,11 @@ def cmd_check(args: _Args) -> int:
         return catalog_status
     repository_wide = not args.files
     pull_request_scoped = False
+    react_doctor_triggered = False
     if args.staged:
         try:
             staged_names = _staged_file_names(root)
+            react_doctor_triggered = _react_doctor_triggered_by(staged_names)
             staged = _safe_staged_paths(root, staged_names)
         except (OSError, subprocess.SubprocessError) as exc:
             if args.output_format != "text":
@@ -819,7 +837,11 @@ def cmd_check(args: _Args) -> int:
         pull_request_scoped = True
     elif (root / ".git").exists() and (base := external.change_scope_base()):
         try:
-            args.files = [path for path in _changed_file_paths(root, base) if runner.accepts_hook_path(Path(path))]
+            changed_names = _changed_file_names(root, base)
+            react_doctor_triggered = _react_doctor_triggered_by(changed_names)
+            args.files = [
+                path for path in _safe_staged_paths(root, changed_names) if runner.accepts_hook_path(Path(path))
+            ]
             pull_request_scoped = True
         except (OSError, subprocess.SubprocessError) as exc:
             if args.output_format != "text":
@@ -838,7 +860,7 @@ def cmd_check(args: _Args) -> int:
         if health_status:
             return health_status
         args.files = [path for path in args.files if runner.accepts_hook_path(Path(path))]
-        if not args.files:
+        if not args.files and not react_doctor_triggered:
             return 0
     if args.output_format != "text":
         if _validate_analysis_output(args, root):
@@ -862,18 +884,33 @@ def cmd_check(args: _Args) -> int:
                 external=True,
                 trust=TrustMode.TRUSTED if args.trust_repository_code else TrustMode.SAFE,
                 mode=AnalysisMode.POLICY,
+                react_doctor_triggered=react_doctor_triggered,
             )
             return _emit_analysis_report(args, root, report)
+        args.react_doctor_triggered = react_doctor_triggered
         return cmd_analyze(args)
     if pull_request_scoped:
         adoption_report = _machine_adoption_gate(root)
         if adoption_report is not None:
             return _emit_analysis_report(args, root, adoption_report)
         if not args.files:
+            if react_doctor_triggered:
+                return _run_canonical_check(
+                    root,
+                    (),
+                    trusted=args.trust_repository_code,
+                    react_doctor_triggered=True,
+                )
             return _run_canonical_check(root, (), trusted=args.trust_repository_code)
     if not args.files:
         return cmd_verify(args)
-    return _run_canonical_check(root, list(args.files), trusted=args.trust_repository_code, staged=args.staged)
+    check_options: dict[str, bool] = {
+        "trusted": args.trust_repository_code,
+        "staged": args.staged,
+    }
+    if react_doctor_triggered:
+        check_options["react_doctor_triggered"] = True
+    return _run_canonical_check(root, list(args.files), **check_options)
 
 
 def cmd_validate_slack_automations(args: _Args) -> int:
@@ -945,6 +982,7 @@ def _run_canonical_check(
     raw: bool = False,
     trusted: bool = False,
     staged: bool = False,
+    react_doctor_triggered: bool = False,
 ) -> 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]
@@ -955,6 +993,7 @@ def _run_canonical_check(
         trust=TrustMode.TRUSTED if trusted else TrustMode.SAFE,
         mode=AnalysisMode.RAW if raw else AnalysisMode.POLICY,
         staged=staged,
+        react_doctor_triggered=react_doctor_triggered,
     )
     rendered = to_text(report)
     if rendered:
@@ -977,6 +1016,7 @@ def cmd_analyze(args: _Args) -> int:
         trust=args.trust,
         mode=AnalysisMode(args.analysis_mode),
         staged=args.staged,
+        react_doctor_triggered=args.react_doctor_triggered,
     )
     return _emit_analysis_report(args, root, report)
 
@@ -1362,7 +1402,7 @@ def _staged_file_names(root: Path) -> list[str]:
         msg = "git is required for --staged"
         raise OSError(msg)
     completed = subprocess.run(  # ruff: ignore[subprocess-without-shell-equals-true] -- fixed argv, no shell.
-        [git, "diff", "--cached", "--name-only", "--diff-filter=ACMR", "-z"],
+        [git, "diff", "--cached", "--name-only", "--diff-filter=ACDMR", "-z"],
         cwd=root,
         check=True,
         capture_output=True,
@@ -1373,19 +1413,29 @@ def _staged_file_names(root: Path) -> list[str]:
 
 
 def _changed_file_paths(root: Path, base: str) -> list[str]:
+    return _safe_staged_paths(root, _changed_file_names(root, base))
+
+
+def _changed_file_names(root: Path, base: str) -> list[str]:
     git = shutil.which("git")
     if git is None:
         msg = "git is required for pull-request change scoping"
         raise OSError(msg)
     completed = subprocess.run(  # ruff: ignore[subprocess-without-shell-equals-true] -- fixed argv, no shell.
-        [git, "diff", "--name-only", "--diff-filter=ACMR", "-z", f"{base}...HEAD", "--"],
+        [git, "diff", "--name-only", "--diff-filter=ACDMR", "-z", f"{base}...HEAD", "--"],
         cwd=root,
         check=True,
         capture_output=True,
         env=_git_environment(),
     )
-    names = [part.decode("utf-8", errors="surrogateescape") for part in completed.stdout.split(b"\0") if part]
-    return _safe_staged_paths(root, names)
+    return [part.decode("utf-8", errors="surrogateescape") for part in completed.stdout.split(b"\0") if part]
+
+
+def _react_doctor_triggered_by(paths: Iterable[str]) -> bool:
+    return any(
+        Path(value).name in _REACT_DOCTOR_METADATA or Path(value).suffix.lower() in _REACT_DOCTOR_TYPESCRIPT_SUFFIXES
+        for value in paths
+    )
 
 
 def _safe_staged_paths(root: Path, paths: Iterable[str]) -> list[str]:
@@ -1650,7 +1700,18 @@ def cmd_baseline(args: _Args) -> int:
             print(f"error: {issue.kind}: {issue.message}", file=sys.stderr)
         return 2
     eligible = tuple(item for item in report.diagnostics if baseline.is_baselineable(item))
-    rendered = baseline.render(eligible)
+    provenance = {
+        "bundle_version": __version__,
+        "consumer_base_sha": baseline.repository_base_sha(root),
+        "catalog_digest": baseline.bundled_catalog_digest(),
+    }
+    if args.baseline_cmd == "update" and args.baseline_rules:
+        if not output.is_file():
+            print(f"error: scoped diagnostic baseline update requires an existing baseline: {output}", file=sys.stderr)
+            return 2
+        rendered = baseline.merge_scoped(output, eligible, selectors=args.baseline_rules, **provenance)
+    else:
+        rendered = baseline.render(eligible, **provenance)
     try:
         output.parent.mkdir(parents=True, exist_ok=True)
         output.write_text(rendered, encoding="utf-8")
@@ -1916,6 +1977,14 @@ def build_parser() -> argparse.ArgumentParser:  # ruff: ignore[too-many-locals]
             action="store_true",
             help="run repository-local analyzers that execute project code",
         )
+        if name == "update":
+            command.add_argument(
+                "--rule",
+                action="append",
+                dest="baseline_rules",
+                default=[],
+                help="replace debt only for this newly promoted rule (repeatable; source:RULE is also accepted)",
+            )
         command.add_argument("files", nargs="*", help="paths to analyze (default: the whole repository)")
 
     ratchet = sub.add_parser("ratchet", help="keep the Python suppression budget from growing")

code_standards-7.1.0/src/sarj_standards/configs/basedpyright.python315-watch.json

@@ -0,0 +1,7 @@
+{
+  // Advisory compatibility profile. Experimental diagnostics stay isolated
+  // here and never leak into the blocking Python 3.14 policy.
+  "extends": "./basedpyright.strict.json",
+  "pythonVersion": "3.15",
+  "enableExperimentalFeatures": true
+}

code_standards-7.1.0/src/sarj_standards/configs/basedpyright.strict.json

@@ -0,0 +1,22 @@
+{
+  // Additive active BasedPyright policy. Upstream-Pyright consumers can extend
+  // pyright.strict.json directly without receiving unrecognized settings.
+  "extends": "./pyright.strict.json",
+  "enableBasedFeatures": false,
+  "strictGenericNarrowing": true,
+
+  "reportInvalidCast": "error",
+  "reportUnsafeMultipleInheritance": "error",
+  "reportImplicitRelativeImport": "error",
+  "reportExplicitAny": "error",
+  "reportIgnoreCommentWithoutRule": "error",
+  "reportPrivateLocalImportUsage": "error",
+  "reportAny": "error",
+  "reportUnannotatedClassAttribute": "error",
+
+  "reportImplicitAbstractClass": "error",
+  "reportEmptyAbstractUsage": "error",
+  "reportIncompatibleUnannotatedOverride": "error",
+  "reportInvalidAbstractMethod": "error",
+  "reportSelfClsDefault": "error"
+}

code_standards-7.1.0/src/sarj_standards/configs/cli-reference.v1.json

@@ -0,0 +1 @@
+{"commands":[{"commands":[],"name":"doctor","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["text","json"],"kind":"option","metavar":"OUTPUT_FORMAT","names":["--format"],"repeatable":false,"required":false,"summary":"output format (default: text)"},{"choices":[],"kind":"option","metavar":null,"names":["--repair"],"repeatable":false,"required":false,"summary":"transactionally repair safe drift with the executing bundle, then re-diagnose"},{"choices":[],"kind":"option","metavar":null,"names":["--no-install"],"repeatable":false,"required":false,"summary":"with --repair, update configuration without installing dependencies or hooks"}],"path":["doctor"],"summary":"diagnose adoption health and optionally repair safe drift","usage":"code-standards doctor [-h] [--format OUTPUT_FORMAT] [--repair] [--no-install]"},{"commands":[],"name":"setup","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["pre-commit","lefthook","none"],"kind":"option","metavar":"HOOKS","names":["--hooks"],"repeatable":false,"required":false,"summary":"hook manager (default: detect Lefthook, otherwise pre-commit)"},{"choices":[],"kind":"option","metavar":"PYTHON_DEST","names":["--python-dest"],"repeatable":false,"required":false,"summary":"the directory that owns pyproject.toml (default: detected)"},{"choices":[],"kind":"option","metavar":"TYPESCRIPT_DEST","names":["--typescript-dest"],"repeatable":false,"required":false,"summary":"the directory that owns the npm lockfile (default: detected)"},{"choices":[],"kind":"option","metavar":null,"names":["--dry-run"],"repeatable":false,"required":false,"summary":"print the complete plan without writing"},{"choices":[],"kind":"option","metavar":null,"names":["--force"],"repeatable":false,"required":false,"summary":"replace conflicting generated lint configuration after review"},{"choices":["standard","application"],"kind":"option","metavar":"PROFILE","names":["--profile"],"repeatable":false,"required":false,"summary":"policy profile to adopt (default: existing value, otherwise standard)"},{"choices":[],"kind":"option","metavar":null,"names":["--no-install"],"repeatable":false,"required":false,"summary":"write wiring without installing dependencies or hooks"},{"choices":["eslint","markdownlint","pyright","ruff","taplo","yamllint"],"kind":"option","metavar":"ONLY","names":["--config"],"repeatable":true,"required":false,"summary":"select one config explicitly (repeatable)"}],"path":["setup"],"summary":"adopt or converge the repository in one idempotent operation","usage":"code-standards setup [-h] [--hooks HOOKS] [--python-dest PYTHON_DEST] [--typescript-dest TYPESCRIPT_DEST] [--dry-run] [--force] [--profile PROFILE] [--no-install] [--config ONLY ...]"},{"commands":[],"name":"check","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":null,"names":["--trust-repository-code"],"repeatable":false,"required":false,"summary":"allow executable repository ESLint configuration (generated hooks and CI set this explicitly)"},{"choices":[],"kind":"option","metavar":null,"names":["--staged"],"repeatable":false,"required":false,"summary":"run custom rules on hook-supplied paths, or discover staged files when none are supplied"},{"choices":["text","json","sarif","github"],"kind":"option","metavar":"OUTPUT_FORMAT","names":["--format"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"OUTPUT","names":["--output"],"repeatable":false,"required":false,"summary":"write JSON or SARIF atomically to PATH"},{"choices":["0","1","2","3","4","5","6","7","8","9","10"],"kind":"option","metavar":"MAX_ANNOTATIONS_PER_LEVEL","names":["--max-annotations-per-level"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"positional","metavar":"files","names":["files"],"repeatable":true,"required":false,"summary":"selected paths; when omitted, check the complete repository"}],"path":["check"],"summary":"run the complete quality gate or check selected paths","usage":"code-standards check [-h] [--trust-repository-code] [--staged] [--format OUTPUT_FORMAT] [--output OUTPUT] [--max-annotations-per-level MAX_ANNOTATIONS_PER_LEVEL] [files ...]"},{"commands":[],"name":"validate-slack-automations","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"PATH","names":["slack_catalog"],"repeatable":false,"required":true,"summary":""}],"path":["validate-slack-automations"],"summary":"validate a versioned Slack automation catalog","usage":"code-standards validate-slack-automations [-h] PATH"},{"commands":[],"name":"observe","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"SELECTED_RULES","names":["--rule"],"repeatable":true,"required":true,"summary":"canonical ENGINE:ID selector (repeatable)"},{"choices":["text","json","sarif","github"],"kind":"option","metavar":"OUTPUT_FORMAT","names":["--format"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"OUTPUT","names":["--output"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":null,"names":["--trust-repository-code"],"repeatable":false,"required":false,"summary":"allow repository ESLint configuration to execute"},{"choices":[],"kind":"option","metavar":"MAX_ANNOTATIONS_PER_LEVEL","names":["--max-annotations-per-level"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"positional","metavar":"files","names":["files"],"repeatable":true,"required":false,"summary":"selected paths; defaults to adopted verification paths"}],"path":["observe"],"summary":"report warning-stage findings with exit 0; invalid input or execution still exits 2","usage":"code-standards observe [-h] --rule SELECTED_RULES ... [--format OUTPUT_FORMAT] [--output OUTPUT] [--trust-repository-code] [--max-annotations-per-level MAX_ANNOTATIONS_PER_LEVEL] [files ...]"},{"commands":[],"name":"fix","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":null,"names":["--staged"],"repeatable":false,"required":false,"summary":"fix only files staged in Git"},{"choices":[],"kind":"positional","metavar":"files","names":["files"],"repeatable":true,"required":false,"summary":"selected paths; when omitted, fix the complete repository"}],"path":["fix"],"summary":"apply safe formatting and lint fixes","usage":"code-standards fix [-h] [--staged] [files ...]"},{"commands":[],"name":"update","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":null,"names":["--check"],"repeatable":false,"required":false,"summary":"preview without writing; exit 1 when changes exist"},{"choices":[],"kind":"option","metavar":null,"names":["--offline"],"repeatable":false,"required":false,"summary":"reconverge the executing bundle and skip every network-dependent install; does not resolve latest"},{"choices":[],"kind":"option","metavar":"VERSION","names":["--to"],"repeatable":false,"required":false,"summary":"resolve and apply exactly this immutable coherent bundle version"},{"choices":[],"kind":"option","metavar":null,"names":["--no-install"],"repeatable":false,"required":false,"summary":"do not install dependencies or hooks"}],"path":["update"],"summary":"upgrade to the latest published coherent Standards bundle","usage":"code-standards update [-h] [--check] [--offline] [--to VERSION] [--no-install]"},{"commands":[{"commands":[],"name":"init","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"OUTPUT","names":["--output"],"repeatable":false,"required":false,"summary":"baseline JSON (default: diagnostic-baseline.json)"},{"choices":[],"kind":"option","metavar":null,"names":["--trust-repository-code"],"repeatable":false,"required":false,"summary":"run repository-local analyzers that execute project code"},{"choices":[],"kind":"positional","metavar":"files","names":["files"],"repeatable":true,"required":false,"summary":"paths to analyze (default: the whole repository)"}],"path":["baseline","init"],"summary":"record the first diagnostic baseline","usage":"code-standards baseline init [-h] [--output OUTPUT] [--trust-repository-code] [files ...]"},{"commands":[],"name":"update","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"OUTPUT","names":["--output"],"repeatable":false,"required":false,"summary":"baseline JSON (default: diagnostic-baseline.json)"},{"choices":[],"kind":"option","metavar":null,"names":["--trust-repository-code"],"repeatable":false,"required":false,"summary":"run repository-local analyzers that execute project code"},{"choices":[],"kind":"option","metavar":"BASELINE_RULES","names":["--rule"],"repeatable":true,"required":false,"summary":"replace debt only for this newly promoted rule (repeatable; source:RULE is also accepted)"},{"choices":[],"kind":"positional","metavar":"files","names":["files"],"repeatable":true,"required":false,"summary":"paths to analyze (default: the whole repository)"}],"path":["baseline","update"],"summary":"re-record the diagnostic baseline after reviewed cleanup","usage":"code-standards baseline update [-h] [--output OUTPUT] [--trust-repository-code] [--rule BASELINE_RULES ...] [files ...]"}],"name":"baseline","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["baseline"],"summary":"grandfather today's findings so only new ones fail","usage":"code-standards baseline [-h] {init,update}"},{"commands":[{"commands":[],"name":"init","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"BASELINE","names":["--baseline"],"repeatable":false,"required":false,"summary":"budget JSON (default: suppression-baseline.json)"},{"choices":[],"kind":"option","metavar":"PACKAGE","names":["--package"],"repeatable":true,"required":false,"summary":"Python package root (repeatable)"},{"choices":[],"kind":"option","metavar":"EXCLUDE_SUBTREE","names":["--exclude-subtree"],"repeatable":true,"required":false,"summary":"generated or vendored subtree to persistently exclude (repeatable)"}],"path":["ratchet","init"],"summary":"create the first suppression budget","usage":"code-standards ratchet init [-h] [--baseline BASELINE] [--package PACKAGE ...] [--exclude-subtree EXCLUDE_SUBTREE ...]"},{"commands":[],"name":"check","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"BASELINE","names":["--baseline"],"repeatable":false,"required":false,"summary":"budget JSON (default: suppression-baseline.json)"},{"choices":[],"kind":"option","metavar":"PACKAGE","names":["--package"],"repeatable":true,"required":false,"summary":"Python package root (repeatable)"},{"choices":[],"kind":"option","metavar":"EXCLUDE_SUBTREE","names":["--exclude-subtree"],"repeatable":true,"required":false,"summary":"generated or vendored subtree to persistently exclude (repeatable)"}],"path":["ratchet","check"],"summary":"fail when suppression debt grows","usage":"code-standards ratchet check [-h] [--baseline BASELINE] [--package PACKAGE ...] [--exclude-subtree EXCLUDE_SUBTREE ...]"},{"commands":[],"name":"status","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"BASELINE","names":["--baseline"],"repeatable":false,"required":false,"summary":"budget JSON (default: suppression-baseline.json)"},{"choices":[],"kind":"option","metavar":"PACKAGE","names":["--package"],"repeatable":true,"required":false,"summary":"Python package root (repeatable)"},{"choices":[],"kind":"option","metavar":"EXCLUDE_SUBTREE","names":["--exclude-subtree"],"repeatable":true,"required":false,"summary":"generated or vendored subtree to persistently exclude (repeatable)"}],"path":["ratchet","status"],"summary":"show current suppression debt and available reductions","usage":"code-standards ratchet status [-h] [--baseline BASELINE] [--package PACKAGE ...] [--exclude-subtree EXCLUDE_SUBTREE ...]"},{"commands":[],"name":"update","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"BASELINE","names":["--baseline"],"repeatable":false,"required":false,"summary":"budget JSON (default: suppression-baseline.json)"},{"choices":[],"kind":"option","metavar":"PACKAGE","names":["--package"],"repeatable":true,"required":false,"summary":"Python package root (repeatable)"},{"choices":[],"kind":"option","metavar":"EXCLUDE_SUBTREE","names":["--exclude-subtree"],"repeatable":true,"required":false,"summary":"generated or vendored subtree to persistently exclude (repeatable)"},{"choices":[],"kind":"option","metavar":null,"names":["--allow-increase"],"repeatable":false,"required":false,"summary":"permit a reviewed increase in suppression debt"}],"path":["ratchet","update"],"summary":"lock in reviewed suppression-budget changes","usage":"code-standards ratchet update [-h] [--baseline BASELINE] [--package PACKAGE ...] [--exclude-subtree EXCLUDE_SUBTREE ...] [--allow-increase]"}],"name":"ratchet","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["ratchet"],"summary":"keep the Python suppression budget from growing","usage":"code-standards ratchet [-h] {init,check,status,update}"},{"commands":[{"commands":[],"name":"list","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["exclude","list"],"summary":"list the complete denylist","usage":"code-standards exclude list [-h]"},{"commands":[],"name":"add","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["path","rule"],"kind":"positional","metavar":"{path,rule}","names":["exclude_kind"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"positional","metavar":"value","names":["value"],"repeatable":false,"required":true,"summary":"repository-relative glob or canonical engine:rule selector"}],"path":["exclude","add"],"summary":"add one exact denylist entry","usage":"code-standards exclude add [-h] {path,rule} value"},{"commands":[],"name":"remove","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["path","rule"],"kind":"positional","metavar":"{path,rule}","names":["exclude_kind"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"positional","metavar":"value","names":["value"],"repeatable":false,"required":true,"summary":"repository-relative glob or canonical engine:rule selector"}],"path":["exclude","remove"],"summary":"remove one exact denylist entry","usage":"code-standards exclude remove [-h] {path,rule} value"}],"name":"exclude","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["exclude"],"summary":"inspect or change explicit path and rule exclusions","usage":"code-standards exclude [-h] {list,add,remove}"},{"commands":[{"commands":[],"name":"state","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["show","state"],"summary":"print detected adoption state as JSON","usage":"code-standards show state [-h]"},{"commands":[],"name":"configs","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["show","configs"],"summary":"list bundled configurations","usage":"code-standards show configs [-h]"},{"commands":[],"name":"config","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["eslint","markdownlint","pyright","ruff","taplo","yamllint"],"kind":"positional","metavar":"name","names":["name"],"repeatable":false,"required":true,"summary":""},{"choices":["standard","application"],"kind":"option","metavar":"PROFILE","names":["--profile"],"repeatable":false,"required":false,"summary":""}],"path":["show","config"],"summary":"print one bundled configuration path","usage":"code-standards show config [-h] name [--profile PROFILE]"},{"commands":[],"name":"peers","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["show","peers"],"summary":"show tested ESLint peer dependencies and install command","usage":"code-standards show peers [-h]"},{"commands":[],"name":"rules","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["show","rules"],"summary":"print the machine-readable custom-rule inventory","usage":"code-standards show rules [-h]"},{"commands":[],"name":"ci","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"OUTPUT","names":["--output"],"repeatable":false,"required":false,"summary":"write a managed workflow inside the repository"}],"path":["show","ci"],"summary":"print a complete pinned GitHub Actions standards workflow","usage":"code-standards show ci [-h] [--output OUTPUT]"}],"name":"show","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["show"],"summary":"print read-only package and adoption information","usage":"code-standards show [-h] {state,configs,config,peers,rules,ci}"},{"commands":[{"commands":[],"name":"setup","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":null,"names":["--check"],"repeatable":false,"required":false,"summary":"print the deterministic setup plan without executing it"}],"path":["maintain","setup"],"summary":"install every standards development environment and repository hook","usage":"code-standards maintain setup [-h] [--check]"},{"commands":[{"commands":[],"name":"check-tag","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"tag","names":["tag"],"repeatable":false,"required":true,"summary":""}],"path":["maintain","release","check-tag"],"summary":"require a release tag to match its package manifest","usage":"code-standards maintain release check-tag [-h] tag"},{"commands":[],"name":"verify-tags","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"RELEASE_COMMIT","names":["--commit"],"repeatable":false,"required":false,"summary":"also require existing tags to match this publishing commit or an unchanged package tree"}],"path":["maintain","release","verify-tags"],"summary":"verify all manifest release tags on origin","usage":"code-standards maintain release verify-tags [-h] [--commit RELEASE_COMMIT]"},{"commands":[],"name":"create-tags","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["typescript","bootstrap","python","sql","iac","standards","tsconfig","docs-ui"],"kind":"positional","metavar":"release_targets","names":["release_targets"],"repeatable":true,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"RELEASE_COMMIT","names":["--commit"],"repeatable":false,"required":true,"summary":"exact commit that was published"},{"choices":[],"kind":"option","metavar":"ATTEMPTS","names":["--attempts"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"DELAY_SECONDS","names":["--delay-seconds"],"repeatable":false,"required":false,"summary":""}],"path":["maintain","release","create-tags"],"summary":"create and push manifest release tags","usage":"code-standards maintain release create-tags [-h] release_targets ... --commit RELEASE_COMMIT [--attempts ATTEMPTS] [--delay-seconds DELAY_SECONDS]"},{"commands":[],"name":"changes","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"BEFORE","names":["--before"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"AFTER","names":["--after"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"GITHUB_OUTPUT","names":["--github-output"],"repeatable":false,"required":true,"summary":""}],"path":["maintain","release","changes"],"summary":"emit package version changes between Git revisions","usage":"code-standards maintain release changes [-h] --before BEFORE --after AFTER --github-output GITHUB_OUTPUT"},{"commands":[],"name":"causality","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"BEFORE","names":["--before"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"AFTER","names":["--after"],"repeatable":false,"required":true,"summary":""}],"path":["maintain","release","causality"],"summary":"require every publishable package change to bump its version","usage":"code-standards maintain release causality [-h] --before BEFORE --after AFTER"},{"commands":[],"name":"lock-age","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"lockfile","names":["lockfile"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"MINIMUM_AGE","names":["--minimum-days"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"RELEASE_EXCLUDE","names":["--exclude"],"repeatable":true,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"RELEASE_EXCLUDE_FILE","names":["--exclude-file"],"repeatable":true,"required":false,"summary":"line-oriented exact package@version exceptions (repeatable)"}],"path":["maintain","release","lock-age"],"summary":"enforce npm lockfile minimum release age","usage":"code-standards maintain release lock-age [-h] lockfile [--minimum-days MINIMUM_AGE] [--exclude RELEASE_EXCLUDE ...] [--exclude-file RELEASE_EXCLUDE_FILE ...]"},{"commands":[],"name":"typescript","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["check","pack","publish"],"kind":"positional","metavar":"release_mode","names":["release_mode"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"OUTPUT","names":["--output"],"repeatable":false,"required":false,"summary":"artifact directory (required for pack)"}],"path":["maintain","release","typescript"],"summary":"check, pack, or publish the TypeScript package","usage":"code-standards maintain release typescript [-h] release_mode [--output OUTPUT]"},{"commands":[],"name":"verify-wheel","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"wheels","names":["wheels"],"repeatable":true,"required":true,"summary":""}],"path":["maintain","release","verify-wheel"],"summary":"require non-empty license text in built Python wheels","usage":"code-standards maintain release verify-wheel [-h] wheels ..."},{"commands":[],"name":"verify-publications","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"ATTEMPTS","names":["--attempts"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"DELAY_SECONDS","names":["--delay-seconds"],"repeatable":false,"required":false,"summary":""}],"path":["maintain","release","verify-publications"],"summary":"wait for every exact sibling publication required by Standards","usage":"code-standards maintain release verify-publications [-h] [--attempts ATTEMPTS] [--delay-seconds DELAY_SECONDS]"},{"commands":[],"name":"publish","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["typescript","bootstrap","python","sql","iac","standards","tsconfig","docs-ui"],"kind":"positional","metavar":"release_target","names":["release_target"],"repeatable":false,"required":true,"summary":""}],"path":["maintain","release","publish"],"summary":"build and publish one package through its native client","usage":"code-standards maintain release publish [-h] release_target"}],"name":"release","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","release"],"summary":"validate and build publishable release artifacts","usage":"code-standards maintain release [-h] {check-tag,verify-tags,create-tags,changes,causality,lock-age,typescript,verify-wheel,verify-publications,publish}"},{"commands":[],"name":"check","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":["ci-history","file-conventions","private-refs","versions"],"kind":"option","metavar":"REPO_ONLY","names":["--only"],"repeatable":true,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"COMMITS","names":["--commits"],"repeatable":false,"required":false,"summary":"also inspect commit messages in this revision range"},{"choices":[],"kind":"option","metavar":"POLICY_DEST","names":["--policy-root"],"repeatable":false,"required":false,"summary":"trusted repository policy root (default: --root)"},{"choices":[],"kind":"option","metavar":"PRIVATE_REFS_FILE","names":["--private-refs-file"],"repeatable":false,"required":false,"summary":"private-reference TOML outside the scanned repository"},{"choices":[],"kind":"option","metavar":null,"names":["--quiet"],"repeatable":false,"required":false,"summary":"hide finding details"}],"path":["maintain","check"],"summary":"run repository policy gates","usage":"code-standards maintain check [-h] [--only REPO_ONLY ...] [--commits COMMITS] [--policy-root POLICY_DEST] [--private-refs-file PRIVATE_REFS_FILE] [--quiet]"},{"commands":[],"name":"sync-ledger","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":null,"names":["--check"],"repeatable":false,"required":false,"summary":"report drift without writing"}],"path":["maintain","sync-ledger"],"summary":"synchronize the rule compatibility ledger","usage":"code-standards maintain sync-ledger [-h] [--check]"},{"commands":[{"commands":[],"name":"check","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","docs","check"],"summary":"","usage":"code-standards maintain docs check [-h]"},{"commands":[],"name":"sync","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","docs","sync"],"summary":"","usage":"code-standards maintain docs sync [-h]"}],"name":"docs","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","docs"],"summary":"check or synchronize source-derived documentation","usage":"code-standards maintain docs [-h] {check,sync}"},{"commands":[],"name":"comment-corpus","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"roots","names":["roots"],"repeatable":true,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"PRIVATE_JSONL","names":["--include-text"],"repeatable":false,"required":false,"summary":"write sensitive comment text to a new owner-readable file"}],"path":["maintain","comment-corpus"],"summary":"extract comments for calibration","usage":"code-standards maintain comment-corpus [-h] roots ... [--include-text PRIVATE_JSONL]"},{"commands":[{"commands":[],"name":"install","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","hooks","install"],"summary":"install Lefthook","usage":"code-standards maintain hooks install [-h]"}],"name":"hooks","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","hooks"],"summary":"manage the pinned repository hooks","usage":"code-standards maintain hooks [-h] {install}"},{"commands":[{"commands":[],"name":"manifest","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","rules","manifest"],"summary":"print the shipped rule inventory","usage":"code-standards maintain rules manifest [-h]"},{"commands":[],"name":"check","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","rules","check"],"summary":"verify the shipped rule inventory matches live registries","usage":"code-standards maintain rules check [-h]"},{"commands":[],"name":"sync","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","rules","sync"],"summary":"update the shipped rule inventory from live registries","usage":"code-standards maintain rules sync [-h]"},{"commands":[],"name":"new","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"selector","names":["selector"],"repeatable":false,"required":true,"summary":"canonical ENGINE:ID selector"},{"choices":["architecture","correctness","maintainability","performance","security","style","testing"],"kind":"option","metavar":"RULE_CATEGORY","names":["--category"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"RULE_SUMMARY","names":["--summary"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":null,"names":["--apply"],"repeatable":false,"required":false,"summary":"create the planned files"}],"path":["maintain","rules","new"],"summary":"plan or create author-owned rule and test skeletons","usage":"code-standards maintain rules new [-h] selector --category RULE_CATEGORY --summary RULE_SUMMARY [--apply]"},{"commands":[],"name":"stage-warning","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"selector","names":["selector"],"repeatable":false,"required":true,"summary":"canonical ENGINE:ID selector"},{"choices":[],"kind":"option","metavar":null,"names":["--check"],"repeatable":false,"required":false,"summary":"report required staging without writing"}],"path":["maintain","rules","stage-warning"],"summary":"prepare one registered rule for warning-first publication","usage":"code-standards maintain rules stage-warning [-h] selector [--check]"},{"commands":[],"name":"prepare","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"selector","names":["selector"],"repeatable":false,"required":true,"summary":"canonical ENGINE:ID selector"},{"choices":[],"kind":"option","metavar":null,"names":["--check"],"repeatable":false,"required":false,"summary":"report required preparation without writing"}],"path":["maintain","rules","prepare"],"summary":"validate and prepare one registered rule for warning-first publication","usage":"code-standards maintain rules prepare [-h] selector [--check]"},{"commands":[],"name":"verify","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"positional","metavar":"selector","names":["selector"],"repeatable":false,"required":true,"summary":"canonical ENGINE:ID selector"}],"path":["maintain","rules","verify"],"summary":"validate one registered rule's authored files and public examples","usage":"code-standards maintain rules verify [-h] selector"},{"commands":[],"name":"changes","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"BEFORE","names":["--before"],"repeatable":false,"required":true,"summary":""},{"choices":[],"kind":"option","metavar":"AFTER","names":["--after"],"repeatable":false,"required":true,"summary":""},{"choices":["json","text"],"kind":"option","metavar":"OUTPUT_FORMAT","names":["--format"],"repeatable":false,"required":false,"summary":""}],"path":["maintain","rules","changes"],"summary":"compare rule inventory and policy between two Git revisions","usage":"code-standards maintain rules changes [-h] --before BEFORE --after AFTER [--format OUTPUT_FORMAT]"},{"commands":[],"name":"evaluate","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":"SELECTED_RULES","names":["--rule"],"repeatable":true,"required":true,"summary":"canonical ENGINE:ID selector (repeatable)"},{"choices":["corpus","effective"],"kind":"option","metavar":"EVALUATION_SCOPE","names":["--scope"],"repeatable":false,"required":false,"summary":"corpus ignores baselines/rule exclusions; effective applies adopted repository policy"},{"choices":["json","text"],"kind":"option","metavar":"OUTPUT_FORMAT","names":["--format"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":"OUTPUT","names":["--output"],"repeatable":false,"required":false,"summary":""},{"choices":[],"kind":"option","metavar":null,"names":["--trust-repository-code"],"repeatable":false,"required":false,"summary":"allow executable repository ESLint configuration"},{"choices":[],"kind":"positional","metavar":"files","names":["files"],"repeatable":true,"required":false,"summary":""}],"path":["maintain","rules","evaluate"],"summary":"calibrate selected custom rules; findings exit 1 and invalid input or execution exits 2","usage":"code-standards maintain rules evaluate [-h] --rule SELECTED_RULES ... [--scope EVALUATION_SCOPE] [--format OUTPUT_FORMAT] [--output OUTPUT] [--trust-repository-code] [files ...]"}],"name":"rules","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","rules"],"summary":"inspect live custom rules","usage":"code-standards maintain rules [-h] {manifest,check,sync,new,stage-warning,prepare,verify,changes,evaluate}"},{"commands":[{"commands":[],"name":"check","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","catalog","check"],"summary":"verify the public catalog matches every live rule","usage":"code-standards maintain catalog check [-h]"},{"commands":[],"name":"sync","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","catalog","sync"],"summary":"update the public catalog from source-owned rule metadata","usage":"code-standards maintain catalog sync [-h]"}],"name":"catalog","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","catalog"],"summary":"maintain the source-derived public rule catalog","usage":"code-standards maintain catalog [-h] {check,sync}"},{"commands":[{"commands":[],"name":"check","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","cli-reference","check"],"summary":"verify the shipped reference matches the parser graph","usage":"code-standards maintain cli-reference check [-h]"},{"commands":[],"name":"sync","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","cli-reference","sync"],"summary":"update the shipped reference from the parser graph","usage":"code-standards maintain cli-reference sync [-h]"}],"name":"cli-reference","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain","cli-reference"],"summary":"maintain the source-derived CLI reference","usage":"code-standards maintain cli-reference [-h] {check,sync}"}],"name":"maintain","options":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"}],"path":["maintain"],"summary":"repository policy, hooks, rule ledgers, and releases","usage":"code-standards maintain [-h] {setup,release,check,sync-ledger,docs,comment-corpus,hooks,rules,catalog,cli-reference}"}],"epilog":"Start with `code-standards setup`, then use `code-standards check`.","globalOptions":[{"choices":[],"kind":"option","metavar":null,"names":["-h","--help"],"repeatable":false,"required":false,"summary":"show this help message and exit"},{"choices":[],"kind":"option","metavar":null,"names":["--version"],"repeatable":false,"required":false,"summary":"show program's version number and exit"},{"choices":[],"kind":"option","metavar":"DEST","names":["--root"],"repeatable":false,"required":false,"summary":"repository root shared by the selected command (default: current directory)"}],"launcher":{"install":"uv tool install --python 3.14 code-standards","runLatest":"uvx --no-config --isolated --python 3.14 --from code-standards code-standards"},"program":"code-standards","schemaVersion":1,"summary":"Adopt, check, fix, diagnose, and update sarj-ai standards (v7.1.0).","version":"7.1.0"}

{code_standards-7.0.4 → code_standards-7.1.0}/src/sarj_standards/configs/doctor.config.json

@@ -16,6 +16,7 @@
   },
   "serverAuthFunctionNames": ["forRequest"],
   "share": false,
+  "warnings": false,
   "supplyChain": {
     "enabled": false
   }

{code_standards-7.0.4 → code_standards-7.1.0}/src/sarj_standards/configs/eslint.application.mjs

@@ -282,7 +282,9 @@ const UNICORN_MODERNISATION_RULES = {
   "unicorn/prefer-import-meta-properties": "error",
   "unicorn/prefer-iterable-in-constructor": "error",
   "unicorn/prefer-iterator-concat": "error",
+  "unicorn/prefer-iterator-helpers": "error",
   "unicorn/prefer-iterator-to-array": "error",
+  "unicorn/prefer-iterator-to-array-at-end": "error",
   "unicorn/prefer-map-from-entries": "error",
   "unicorn/prefer-math-abs": "error",
   "unicorn/prefer-math-constants": "error",
@@ -747,6 +749,8 @@ export function createConfig(options = {}) {
       // schema changes. Requiring an identical shape keeps the diagnostic tied
       // to structural evidence instead of name correlation.
       "@sarj/prefer-zod-infer": "error",
+      "@sarj/interface-contract-members-private": "error",
+      "@sarj/prefer-ecmascript-private-members": "error",
 
       // Maintained upstream rules own these concerns instead of local copies.
       // `.nullable().optional()` is exactly `.nullish()`, so prefer-nullish
@@ -943,12 +947,12 @@ export function createConfig(options = {}) {
       "@sarj/no-raw-env": "error",
       "@sarj/no-sentinel-return-on-catch": "error",
       "@sarj/no-log-only-catch": "error",
-      "@sarj/no-bare-return-from-test-catch": "warn",
-      "@sarj/no-dangerously-allow-svg": "warn",
-      "@sarj/no-duplicate-lifecycle-refresh-listeners": "warn",
-      "@sarj/no-production-browser-source-maps": "warn",
-      "@sarj/no-router-refresh-polling": "warn",
-      "@sarj/no-server-env-in-client-component": "warn",
+      "@sarj/no-bare-return-from-test-catch": "error",
+      "@sarj/no-dangerously-allow-svg": "error",
+      "@sarj/no-duplicate-lifecycle-refresh-listeners": "error",
+      "@sarj/no-production-browser-source-maps": "error",
+      "@sarj/no-router-refresh-polling": "error",
+      "@sarj/no-server-env-in-client-component": "error",
       "@sarj/no-long-comment": "error",
       "@sarj/no-vague-suppression-description": "error",
       "@sarj/no-generic-single-export-module": "error",
@@ -984,11 +988,11 @@ export function createConfig(options = {}) {
       "@sarj/prefer-non-nullable-collection": "error",
       "@sarj/prefer-await-in-async-return": "error",
       "@sarj/no-sleep-in-test-body": "error",
-      "@sarj/iac-source-coupled-test": "warn",
-      "@sarj/repeated-static-call-cases": "warn",
-      "@sarj/require-use-form-default-values": "warn",
-      "@sarj/require-use-server-in-actions-file": "warn",
-      "@sarj/source-coupled-test": "warn",
+      "@sarj/iac-source-coupled-test": "error",
+      "@sarj/repeated-static-call-cases": "error",
+      "@sarj/require-use-form-default-values": "error",
+      "@sarj/require-use-server-in-actions-file": "error",
+      "@sarj/source-coupled-test": "error",
       "@sarj/no-positional-tuple-return": "error",
       "@sarj/no-restated-comment": "error",
       "@sarj/no-restated-jsdoc": "error",
@@ -1004,7 +1008,7 @@ export function createConfig(options = {}) {
       "@sarj/prefer-whole-object-assertion": "error",
       "@sarj/duplicate-test-body": "error",
       "@sarj/test-loops-over-literal-cases": "error",
-      "@sarj/test-phase-label-comment": "warn",
+      "@sarj/test-phase-label-comment": "error",
       // Both architectural rules stay enabled in the shared baseline. The
       // fetch rule ships conservative client/service defaults; consumers can
       // replace its `allow` list. The storage rule is intentionally inert until

{code_standards-7.0.4 → code_standards-7.1.0}/src/sarj_standards/configs/eslint.peers.json

@@ -18,7 +18,7 @@
   "peers": {
     "@eslint-community/eslint-plugin-eslint-comments": "4.7.2",
     "@eslint/compat": "2.1.0",
-    "@sarj/eslint-plugin": "15.12.1",
+    "@sarj/eslint-plugin": "15.13.0",
     "eslint": "10.8.1",
     "eslint-plugin-better-tailwindcss": "4.7.0",
     "eslint-plugin-perfectionist": "5.10.1",