sarj-standards-bootstrap 1.0.1__tar.gz

sarj_standards_bootstrap-1.0.1/.gitignore

@@ -0,0 +1,40 @@
+node_modules/
+.astro/
+dist/
+build/
+*.tgz
+.npm/
+*.tsbuildinfo
+.turbo/
+.tsup/
+.vitest-cache/
+.eslintcache
+coverage/
+
+__pycache__/
+*.py[co]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.basedpyright/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.venv/
+venv/
+*.egg-info/
+
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+.zed/
+*.swp
+
+# Claude Code local state (shared settings.json is tracked)
+.claude/*
+!.claude/settings.json
+.worktrees/
+.sarj-private-refs.toml
+.sarj-standards-rollout.toml

sarj_standards_bootstrap-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sarj-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sarj_standards_bootstrap-1.0.1/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: sarj-standards-bootstrap
+Version: 1.0.1
+Summary: Manifest-driven launcher for an exact Sarj Standards bundle.
+Project-URL: Homepage, https://code-standards.sarj.ai/
+Project-URL: Documentation, https://code-standards.sarj.ai/cli/
+Project-URL: Changelog, https://github.com/sarj-ai/standards/releases
+Project-URL: Repository, https://github.com/sarj-ai/standards
+Project-URL: Issues, https://github.com/sarj-ai/standards/issues
+Author: sarj-ai
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+<!-- Generated by `sarj-standards maintain docs sync`; do not edit. -->
+
+# sarj-standards-bootstrap
+
+Manifest-driven launcher for an exact Sarj Standards bundle.
+
+```bash
+uv tool install sarj-standards-bootstrap
+```
+
+Generated CI and hooks pin this protocol package exactly; ordinary Standards upgrades change only `.sarj-standards.toml`.
+
+```bash
+uvx --no-config --isolated --python 3.14 --from sarj-standards-bootstrap==1.0.1 sarj-standards check
+```
+
+The bootstrap deliberately inherits UV/PIP registry, proxy, certificate, cache, and offline environment policy. `--no-config --isolated` prevents consumer project configuration and installed tools from changing the selected bootstrap or Standards bundle.
+
+[Documentation](https://code-standards.sarj.ai/) · [Source](https://github.com/sarj-ai/standards)

sarj_standards_bootstrap-1.0.1/README.md

@@ -0,0 +1,19 @@
+<!-- Generated by `sarj-standards maintain docs sync`; do not edit. -->
+
+# sarj-standards-bootstrap
+
+Manifest-driven launcher for an exact Sarj Standards bundle.
+
+```bash
+uv tool install sarj-standards-bootstrap
+```
+
+Generated CI and hooks pin this protocol package exactly; ordinary Standards upgrades change only `.sarj-standards.toml`.
+
+```bash
+uvx --no-config --isolated --python 3.14 --from sarj-standards-bootstrap==1.0.1 sarj-standards check
+```
+
+The bootstrap deliberately inherits UV/PIP registry, proxy, certificate, cache, and offline environment policy. `--no-config --isolated` prevents consumer project configuration and installed tools from changing the selected bootstrap or Standards bundle.
+
+[Documentation](https://code-standards.sarj.ai/) · [Source](https://github.com/sarj-ai/standards)

sarj_standards_bootstrap-1.0.1/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "sarj-standards-bootstrap"
+version = "1.0.1"
+description = "Manifest-driven launcher for an exact Sarj Standards bundle."
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "sarj-ai" }]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = []
+
+[project.scripts]
+sarj-standards = "sarj_standards_bootstrap:main"
+
+[project.urls]
+Homepage = "https://code-standards.sarj.ai/"
+Documentation = "https://code-standards.sarj.ai/cli/"
+Changelog = "https://github.com/sarj-ai/standards/releases"
+Repository = "https://github.com/sarj-ai/standards"
+Issues = "https://github.com/sarj-ai/standards/issues"
+
+[dependency-groups]
+dev = [
+  "basedpyright>=1.39",
+  "pytest>=9.0",
+  "ruff>=0.16.1",
+]
+
+[build-system]
+requires = ["hatchling==1.31.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sarj_standards_bootstrap"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src",
+  "README.md",
+  "LICENSE",
+  "pyproject.toml",
+]
+exclude = [
+  "tests/",
+  "**/__pycache__/",
+  "**/*.pyc",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+extend = "../../.ruff-strict.toml"

sarj_standards_bootstrap-1.0.1/src/sarj_standards_bootstrap/__init__.py

@@ -0,0 +1,6 @@
+"""Manifest-driven launcher for Sarj Standards."""
+
+from sarj_standards_bootstrap.cli import main
+
+
+__all__ = ["main"]

sarj_standards_bootstrap-1.0.1/src/sarj_standards_bootstrap/cli.py

@@ -0,0 +1,189 @@
+"""Resolve and execute the exact Standards bundle selected by a repository."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+import os
+from pathlib import Path
+import re
+import shutil
+import subprocess  # ruff: ignore[suspicious-subprocess-import] -- Windows cannot replace the current process.
+import sys
+import tomllib
+from typing import TYPE_CHECKING, Final, NoReturn
+
+
+if TYPE_CHECKING:
+    from collections.abc import Mapping, Sequence
+
+
+MANIFEST_NAME: Final = ".sarj-standards.toml"
+MANIFEST_SCHEMA: Final = 3
+TOOL_PYTHON: Final = "3.14"
+_VERSION: Final = re.compile(r"(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\Z")
+
+
+class BootstrapError(ValueError):
+    """A concise consumer-facing bootstrap failure."""
+
+
+@dataclass(frozen=True, slots=True)
+class ParsedArguments:
+    """Bootstrap-owned root and untouched Standards arguments."""
+
+    root: Path | None
+    forwarded: tuple[str, ...]
+
+
+def explicit_root(arguments: Sequence[str], *, cwd: Path) -> ParsedArguments:
+    """Remove one optional global root argument from forwarded arguments."""
+    root: Path | None = None
+    forwarded: list[str] = []
+    index = 0
+    while index < len(arguments):
+        argument = arguments[index]
+        if argument == "--":
+            forwarded.extend(arguments[index:])
+            break
+        if argument == "--root":
+            if root is not None:
+                message = "--root may be specified only once"
+                raise BootstrapError(message)
+            index += 1
+            if index >= len(arguments):
+                message = "--root requires a directory"
+                raise BootstrapError(message)
+            root = (cwd / arguments[index]).resolve()
+        elif argument.startswith("--root="):
+            if root is not None:
+                message = "--root may be specified only once"
+                raise BootstrapError(message)
+            value = argument.partition("=")[2]
+            if not value:
+                message = "--root requires a directory"
+                raise BootstrapError(message)
+            root = (cwd / value).resolve()
+        else:
+            forwarded.append(argument)
+        index += 1
+    return ParsedArguments(root, tuple(forwarded))
+
+
+def find_root(start: Path) -> Path:
+    """Find the nearest manifest at or above the invocation directory."""
+    current = start.resolve()
+    for candidate in (current, *current.parents):
+        if (candidate / MANIFEST_NAME).is_file():
+            return candidate
+    message = f"no {MANIFEST_NAME} found at or above {current}"
+    raise BootstrapError(message)
+
+
+def table(value: object) -> Mapping[str, object]:
+    """Narrow one untyped TOML document to a string-keyed table."""
+    if not isinstance(value, dict):
+        message = f"{MANIFEST_NAME} must contain a TOML table"
+        raise BootstrapError(message)
+    entries: dict[str, object] = {}
+    for key, item in value.items():  # pyright: ignore[reportUnknownVariableType]
+        if isinstance(key, str):
+            entries[key] = item  # ruff: ignore[manual-dict-comprehension] — pyright needs explicit narrowing.
+    return entries
+
+
+def bundle(root: Path) -> str:
+    """Read the exact bundle selected by one repository manifest."""
+    manifest = root / MANIFEST_NAME
+    try:
+        with manifest.open("rb") as stream:
+            document: object = tomllib.load(stream)
+    except FileNotFoundError as exc:
+        message = f"{manifest} does not exist"
+        raise BootstrapError(message) from exc
+    except OSError as exc:
+        message = f"cannot read {manifest}: {exc}"
+        raise BootstrapError(message) from exc
+    except tomllib.TOMLDecodeError as exc:
+        message = f"{manifest} is not valid TOML: {exc}"
+        raise BootstrapError(message) from exc
+    data = table(document)
+    schema = data.get("schema")
+    if schema != MANIFEST_SCHEMA:
+        message = f"{manifest} schema must equal {MANIFEST_SCHEMA}, got {schema!r}"
+        raise BootstrapError(message)
+    selected_bundle = data.get("bundle")
+    if not isinstance(selected_bundle, str) or _VERSION.fullmatch(selected_bundle) is None:
+        message = f"{manifest} bundle must be one exact canonical X.Y.Z release"
+        raise BootstrapError(message)
+    return selected_bundle
+
+
+def command(uvx: str, root: Path, selected_bundle: str, arguments: Sequence[str]) -> tuple[str, ...]:
+    """Build the exact isolated Standards invocation."""
+    return (
+        uvx,
+        "--no-config",
+        "--isolated",
+        "--python",
+        TOOL_PYTHON,
+        "--from",
+        f"sarj-standards=={selected_bundle}",
+        "sarj-standards",
+        "--root",
+        str(root),
+        *arguments,
+    )
+
+
+def execute(exact_command: Sequence[str], environment: Mapping[str, str], *, platform: str = os.name) -> NoReturn:
+    """Transfer control to Standards while preserving its process result on every OS."""
+    arguments = tuple(exact_command)
+    if platform == "nt":
+        completed = subprocess.run(  # ruff: ignore[subprocess-without-shell-equals-true] -- fixed argv; no consumer shell.
+            arguments,
+            env=environment,
+            check=False,
+            shell=False,
+        )
+        raise SystemExit(completed.returncode)
+    os.execvpe(  # ruff: ignore[start-process-with-no-shell] -- POSIX replacement preserves signals and exit status.
+        arguments[0],
+        arguments,
+        dict(environment),
+    )
+
+
+def run(arguments: Sequence[str], *, cwd: Path) -> NoReturn:
+    """Replace this bootstrap process with the exact Standards process."""
+    parsed = explicit_root(arguments, cwd=cwd)
+    explicit = parsed.root
+    if explicit is not None:
+        if not explicit.is_dir():
+            message = f"--root {explicit} is not a directory"
+            raise BootstrapError(message)
+        root = explicit
+    else:
+        root = find_root(cwd)
+    selected_bundle = bundle(root)
+    uvx = shutil.which("uvx")
+    if uvx is None:
+        message = "uvx is required; install uv and retry"
+        raise BootstrapError(message)
+    exact_command = command(uvx, root, selected_bundle, parsed.forwarded)
+    try:
+        execute(
+            exact_command,
+            os.environ.copy(),  # ruff: ignore[banned-api] -- inherit registry, certificate, cache, proxy, and offline policy.
+        )
+    except OSError as exc:
+        message = f"could not execute Standards {selected_bundle}: {exc}"
+        raise BootstrapError(message) from exc
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Launch the exact Standards bundle declared by the repository."""
+    try:
+        run(sys.argv[1:] if argv is None else argv, cwd=Path.cwd())
+    except BootstrapError as exc:
+        sys.stderr.write(f"sarj-standards bootstrap: {exc}\n")
+        return 2