stackops 26.11.1__tar.gz → 26.11.2__tar.gz

{stackops-26.11.1 → stackops-26.11.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stackops
-Version: 26.11.1
+Version: 26.11.2
 Summary: Developer Stack Manager
 Project-URL: Homepage, https://github.com/thisismygitrepo/stackops
 Project-URL: Bug Tracker, https://github.com/thisismygitrepo/stackops/issues

{stackops-26.11.1 → stackops-26.11.2}/jobs/dockers/Dockerfile_slim

@@ -14,7 +14,7 @@ RUN curl -LsSf https://astral.sh/uv/install.sh | sh
 WORKDIR /app
 COPY . /app
 RUN /root/.local/bin/uv tool install --python 3.14 --editable .
-# RUN /root/.local/bin/uv tool install --python 3.14 stackops>=26.11.1
+# RUN /root/.local/bin/uv tool install --python 3.14 stackops>=26.11.2
 
 RUN /root/.local/bin/devops software install --group sysabc
 RUN /root/.local/bin/devops software install --group termabc

{stackops-26.11.1 → stackops-26.11.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stackops"
-version = "26.11.1"
+version = "26.11.2"
 description = "Developer Stack Manager"
 readme = "README.md"
 license = {text = "Apache 2.0"}

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/cluster/scheduler.py

@@ -173,11 +173,8 @@ class CacheMemory[T]():
             self.time_produced = datetime.now()
         else:
             age = datetime.now() - self.time_produced
-            if (age > self.expire) or (fresh and (age.total_seconds() > tolerance_seconds)):
-                if not fresh:
-                    self.logger.warning(f"""🔄 CACHE STALE 📦 {self.name} cache: Populating fresh cache from source func. """ + f"""⏱️  Age = {age} > Expiry {self.expire} """ )
-                else:
-                    self.logger.warning(f"""⚠️ Fresh flag raised, age = {age} > {tolerance_seconds} seconds of tolerance. Updating {self.name} cache from source func.""")
+            if age > self.expire:
+                self.logger.warning(f"""🔄 CACHE STALE 📦 {self.name} cache: Populating fresh cache from source func. """ + f"""⏱️  Age = {age} > Expiry {self.expire} """ )
                 t0 = time.time()
                 self.cache = self.source_func()
                 self.logger.warning(f"⏱️  Cache population took {time.time() - t0:.2f} seconds.")

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/cluster/sessions_managers/tmux/tmux_local_manager.py

@@ -134,9 +134,7 @@ class TmuxLocalManager:
         for manager in self.managers:
             session_name = manager.session_name or "default"
             session_status = check_tmux_session_status(session_name)
-            commands_status: dict[str, CommandStatus] = {}
-            if manager.layout_config:
-                commands_status = build_unknown_commands_status(manager.layout_config)
+            commands_status = build_unknown_commands_status(manager.layout_config)
             summary: TmuxLayoutSummary = {
                 "total_commands": len(commands_status),
                 "running_commands": sum(1 for status in commands_status.values() if status.get("running", False)),

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/profile/dotfiles_collect_plan.py

@@ -139,6 +139,10 @@ def _build_catalog(personal_catalog: MapperDocument, library_mapper: MapperDocum
     return catalog, packaged_paths
 
 
+def _without_note(entry: RawMapperEntry) -> dict[str, object]:
+    return {key: value for key, value in entry.items() if key != "note"}
+
+
 def plan_collect(
     *, personal_catalog: MapperDocument, library_mapper: MapperDocument, user_mapper: MapperDocument, current_os: OsName
 ) -> list[CollectEntryPlan]:
@@ -146,7 +150,10 @@ def plan_collect(
     previously_collected_groups = {
         group
         for group, section in user_mapper.items()
-        if group in catalog and all(catalog[group].get(name) == entry for name, entry in section.items())
+        if group in catalog
+        and all(
+            name in catalog[group] and _without_note(catalog[group][name]) == _without_note(entry) for name, entry in section.items()
+        )
     }
     claimed_entries = [entry for group, section in user_mapper.items() if group not in previously_collected_groups for entry in section.values()]
     claimed_originals = [Path(entry["original"]).expanduser().absolute() for entry in claimed_entries]

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/profile/dotfiles_mapper.py

@@ -22,7 +22,8 @@ DEFAULT_DOTFILE_MAPPER_HEADER = (
     f"# yaml-language-server: $schema=./{mapper_assets.MAPPER_DOTFILES_SCHEMA_PATH_REFERENCE}\n"
     "# User-defined config file mappings\n"
     "# Managed by `devops config dotfiles` commands\n"
-    "# os must be an explicit YAML list containing one or more of: linux, darwin, windows"
+    "# os must be an explicit YAML list containing one or more of: linux, darwin, windows\n"
+    "# note is an optional free-text field per entry; it is kept when commands rewrite this file, # comments are not"
 )
 
 type OsField = list[OsName]
@@ -36,6 +37,7 @@ class RawMapperEntry(TypedDict):
     os: OsField
     contents: NotRequired[bool]
     copy: NotRequired[bool]
+    note: NotRequired[str]
 
 
 def _require_mapping(value: object, *, context: str) -> Mapping[object, object]:
@@ -107,6 +109,8 @@ def _normalize_mapper_entry(entry_value: object, *, context: str) -> RawMapperEn
         normalized_entry["contents"] = _require_bool(entry_mapping["contents"], context=f"{context}.contents")
     if "copy" in entry_mapping:
         normalized_entry["copy"] = _require_bool(entry_mapping["copy"], context=f"{context}.copy")
+    if "note" in entry_mapping:
+        normalized_entry["note"] = _require_str(entry_mapping["note"], context=f"{context}.note")
     return normalized_entry
 
 

stackops-26.11.2/src/stackops/scripts/python/ai/scripts/constants.py

@@ -0,0 +1,13 @@
+from typing import Final, Literal
+
+type CheckerName = Literal["pyright", "mypy", "pylint", "pyrefly", "ty", "ruff"]
+
+TYPE_CHECK_TOOLS_ENV_VAR: Final[str] = "STACKOPS_TYPE_CHECK_TOOLS"
+TYPE_CHECK_TOOL_NAMES: Final[tuple[CheckerName, ...]] = (
+    "pyright",
+    "mypy",
+    "pylint",
+    "pyrefly",
+    "ty",
+    "ruff",
+)

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/ai/scripts/models.py

@@ -1,8 +1,13 @@
+import os
 import subprocess
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Final, TextIO
 
+from stackops.scripts.python.ai.scripts.constants import (
+    CheckerName,
+    TYPE_CHECK_TOOLS_ENV_VAR,
+)
 from stackops.scripts.python.ai.scripts import models_diagnostics as models_diagnostics_module
 from stackops.scripts.python.ai.scripts import (
     models_config as models_config_module,
@@ -124,14 +129,19 @@ TYPE_CHECK_EXCLUDED_DIRECTORIES: Final[tuple[str, ...]] = (
     load_type_check_excluded_directories()
 )
 LATEST_TYPE_CHECK_TOOLS: Final[bool] = load_latest_type_check_tools()
+SELECTED_TYPE_CHECK_TOOLS: Final[tuple[CheckerName, ...]] = (
+    models_config_module.parse_type_check_tools(os.environ.get(TYPE_CHECK_TOOLS_ENV_VAR))
+)
 TOOL_VERSION_SPECS: Final[tuple[ToolVersionSpec, ...]] = build_tool_version_specs(
-    latest=LATEST_TYPE_CHECK_TOOLS
+    latest=LATEST_TYPE_CHECK_TOOLS, selected_tools=SELECTED_TYPE_CHECK_TOOLS
 )
 CLEANUP_COMMANDS: Final[tuple[tuple[str, ...], ...]] = build_cleanup_commands(
-    excluded_directories=TYPE_CHECK_EXCLUDED_DIRECTORIES, latest=LATEST_TYPE_CHECK_TOOLS
+    excluded_directories=TYPE_CHECK_EXCLUDED_DIRECTORIES, latest=LATEST_TYPE_CHECK_TOOLS,
+    selected_tools=SELECTED_TYPE_CHECK_TOOLS,
 )
 CHECKER_SPECS: Final[tuple[ToolSpec, ...]] = build_checker_specs(
-    excluded_directories=TYPE_CHECK_EXCLUDED_DIRECTORIES, latest=LATEST_TYPE_CHECK_TOOLS
+    excluded_directories=TYPE_CHECK_EXCLUDED_DIRECTORIES, latest=LATEST_TYPE_CHECK_TOOLS,
+    selected_tools=SELECTED_TYPE_CHECK_TOOLS,
 )
 
 __all__ = (

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/ai/scripts/models_config.py

@@ -7,6 +7,10 @@ import tomllib
 from pathlib import Path
 from typing import Final, cast
 
+from stackops.scripts.python.ai.scripts.constants import (
+    CheckerName,
+    TYPE_CHECK_TOOL_NAMES,
+)
 from stackops.scripts.python.ai.scripts.models_core import REPORTS_DIR, ToolSpec
 
 
@@ -18,6 +22,18 @@ PYPROJECT_PATH: Final[Path] = Path("pyproject.toml")
 PYRIGHT_CONFIG_OVERRIDE_PATH: Final[Path] = Path(".pyright.type-check.override.json")
 
 
+def parse_type_check_tools(value: str | None) -> tuple[CheckerName, ...]:
+    if value is None:
+        return TYPE_CHECK_TOOL_NAMES
+    names = tuple(dict.fromkeys(name.strip() for name in value.split(",")))
+    invalid_names = tuple(name for name in names if name not in TYPE_CHECK_TOOL_NAMES)
+    if invalid_names:
+        invalid = ", ".join(repr(name) for name in invalid_names)
+        available = ", ".join(TYPE_CHECK_TOOL_NAMES)
+        raise ValueError(f"""Unknown tool(s): {invalid}. Choose from: {available}.""")
+    return cast(tuple[CheckerName, ...], names)
+
+
 def _remove_generated_file(path: Path) -> None:
     path.unlink(missing_ok=True)
 
@@ -174,6 +190,7 @@ def _ensure_pyright_config_override(excluded_directories: tuple[str, ...]) -> Pa
 def build_cleanup_commands(
     excluded_directories: tuple[str, ...],
     latest: bool,
+    selected_tools: tuple[CheckerName, ...],
 ) -> tuple[tuple[str, ...], ...]:
     excluded_patterns = tuple(
         _build_directory_regex(directory) for directory in excluded_directories
@@ -184,6 +201,8 @@ def build_cleanup_commands(
         command=cleanpy_command, option="--exclude", values=excluded_patterns
     )
     cleanpy_command.append(".")
+    if "ruff" not in selected_tools:
+        return (tuple(cleanpy_command),)
     ruff_fix_command = build_uv_tool_command(package="ruff", latest=latest)
     ruff_fix_command.extend(("ruff", "check", "--fix"))
     if len(excluded_directories) > 0:
@@ -204,6 +223,7 @@ def build_cleanup_commands(
 def build_checker_specs(
     excluded_directories: tuple[str, ...],
     latest: bool,
+    selected_tools: tuple[CheckerName, ...],
 ) -> tuple[ToolSpec, ...]:
     excluded_patterns = tuple(
         _build_directory_regex(directory) for directory in excluded_directories
@@ -212,7 +232,7 @@ def build_checker_specs(
     pyright_command = build_uv_tool_command(package="pyright", latest=latest)
     pyright_command.extend(("pyright", "--outputjson", "--threads", "10"))
     pyright_temporary_paths: tuple[Path, ...] = ()
-    if len(excluded_directories) > 0:
+    if "pyright" in selected_tools and len(excluded_directories) > 0:
         pyright_config_override_path = _ensure_pyright_config_override(
             excluded_directories
         )
@@ -270,7 +290,7 @@ def build_checker_specs(
             values=excluded_directories,
         )
     ruff_command.append(".")
-    return (
+    specs = (
         ToolSpec(
             slug="pyright",
             title="Pyright Type Checker",
@@ -320,3 +340,4 @@ def build_checker_specs(
             temporary_paths=(),
         ),
     )
+    return tuple(spec for spec in specs if spec.slug in selected_tools)

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/ai/scripts/tool_versions.py

@@ -7,6 +7,7 @@ from rich.panel import Panel
 from rich.table import Table
 from rich.text import Text
 
+from stackops.scripts.python.ai.scripts.constants import CheckerName
 from stackops.scripts.python.ai.scripts.models_config import build_uv_tool_command
 
 
@@ -26,8 +27,10 @@ class ToolVersionResolutionError(RuntimeError):
     pass
 
 
-def build_tool_version_specs(latest: bool) -> tuple[ToolVersionSpec, ...]:
-    return (
+def build_tool_version_specs(
+    latest: bool, selected_tools: tuple[CheckerName, ...]
+) -> tuple[ToolVersionSpec, ...]:
+    specs = (
         ToolVersionSpec(
             title="Cleanpy",
             command=(
@@ -86,6 +89,10 @@ def build_tool_version_specs(latest: bool) -> tuple[ToolVersionSpec, ...]:
             ),
         ),
     )
+    return tuple(
+        spec for spec in specs
+        if spec.title == "Cleanpy" or spec.title.lower() in selected_tools
+    )
 
 
 def _resolve_tool_version(

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/graph/cli_graph_policy.py

@@ -1,6 +1,6 @@
 """Static CLI signature policy enforced at graph build time."""
 
-from typing import Any
+from typing import Any, cast
 
 CANONICAL_SHORTS: dict[str, str] = {
     "--all": "-a",
@@ -91,7 +91,10 @@ def _iter_commands(node: dict[str, Any]) -> list[dict[str, Any]]:
     commands: list[dict[str, Any]] = []
     if node.get("kind") == "command":
         commands.append(node)
-    kids: dict[str, dict[str, object]] | list[dict[str, object]] | None = node.get("children")
+    kids = cast(
+        dict[str, dict[str, object]] | list[dict[str, object]] | None,
+        node.get("children"),
+    )
     if isinstance(kids, dict):
         kids = list(kids.values())
     elif kids is None:
@@ -102,7 +105,7 @@ def _iter_commands(node: dict[str, Any]) -> list[dict[str, Any]]:
 
 
 def _option_decls(param: dict[str, Any]) -> tuple[list[str], list[str]]:
-    decls: list[str] = param.get("typer", {}).get("param_decls", [])
+    decls = cast(list[str], param.get("typer", {}).get("param_decls", []))
     longs = [d for d in decls if d.startswith("--")]
     shorts = [d for d in decls if d.startswith("-") and not d.startswith("--")]
     return longs, shorts
@@ -111,7 +114,7 @@ def _option_decls(param: dict[str, Any]) -> tuple[list[str], list[str]]:
 def validate_cli_graph(payload: dict[str, Any]) -> None:
     violations: list[str] = []
     for node in _iter_commands(payload["root"]):
-        path: str = node["fullPath"]
+        path = cast(str, node["fullPath"])
         seen_shorts: dict[str, str] = {}
         seen_longs: dict[str, str] = {}
         for param in node.get("signature", {}).get("parameters", []):
@@ -121,7 +124,7 @@ def validate_cli_graph(payload: dict[str, Any]) -> None:
             longs, shorts = _option_decls(param)
             primary_long = longs[0].split("/")[0] if longs else ""
             has_secondary = any("/" in d for d in longs + shorts)
-            name: str = param["name"]
+            name = cast(str, param["name"])
 
             if has_secondary and (path, primary_long) not in PAIRED_OPTION_ALLOWLIST:
                 violations.append(f"{path}: {name} declares paired flags; expose only the flag that changes the default")

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/graph/visualize/helpers_navigator/cli_graph_loader.py

@@ -5,7 +5,7 @@ Load and normalize CLI graph data for the command navigator.
 from dataclasses import dataclass
 import json
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 from stackops.scripts.python.graph.visualize.helpers_navigator.data_models import (
     CommandInfo,
@@ -69,34 +69,37 @@ def _build_node(node: dict[str, Any], parent_tokens: list[str], parent_name: str
 
 def _node_description(node: dict[str, Any]) -> str:
     if node.get("kind") == "group":
-        return (
+        return cast(
+            str,
             node.get("app", {}).get("help")
             or node.get("help")
             or node.get("doc")
-            or node.get("name", "")
+            or node.get("name", ""),
         )
-    return (
+    return cast(
+        str,
         node.get("short_help")
         or node.get("help")
         or node.get("doc")
-        or node.get("name", "")
+        or node.get("name", ""),
     )
 
 
 def _node_long_description(node: dict[str, Any], fallback: str) -> str:
     if node.get("kind") == "group":
-        return (
+        return cast(
+            str,
             node.get("app", {}).get("help")
             or node.get("help")
             or node.get("doc")
-            or fallback
+            or fallback,
         )
-    return node.get("help") or node.get("doc") or fallback
+    return cast(str, node.get("help") or node.get("doc") or fallback)
 
 
 def _node_module_path(node: dict[str, Any]) -> str:
     source = node.get("source") or {}
-    return source.get("dispatches_to") or source.get("module") or ""
+    return cast(str, source.get("dispatches_to") or source.get("module") or "")
 
 
 def _parse_signature(signature: dict[str, Any] | None) -> list[ArgumentInfo]:

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/graph/visualize/helpers_navigator/devops_navigator.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.14"
 # dependencies = [
-#     "stackops>=26.11.1",
+#     "stackops>=26.11.2",
 #     "textual",
 # ]
 # ///

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_agents/agents_create_inputs.py

@@ -248,7 +248,8 @@ def validate_agents_output_dir_cleanup(*, repo_root: Path, agents_dir_obj: Path)
     except json.JSONDecodeError as error:
         raise ValueError(f"Invalid StackOps agents ownership manifest: {manifest_path}") from error
     match manifest:
-        case {"agents_dir": str() as recorded_agents_dir}:
+        # Mapping patterns reject non-mappings; Pyrefly incorrectly infers a Never lookup.
+        case {"agents_dir": str() as recorded_agents_dir}:  # pyrefly: ignore[not-callable]
             recorded_agents_dir_resolved = Path(recorded_agents_dir).expanduser().resolve()
         case _:
             raise ValueError(f"Invalid StackOps agents ownership manifest: {manifest_path}")

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_agents/agents_doctor/cleanup_interactive.py

@@ -50,10 +50,10 @@ def prompt_cleanup_selection(*, console: Console, selection: CleanupSelection) -
         label="Agent", default=selection.agent,
         choices=("all", *DOCTOR_DEFINITION_BY_AGENT, *DOCTOR_AGENT_ALIASES),
     )
-    directory: str = typer.prompt(
+    directory = cast(str, typer.prompt(
         "Workspace directory", default=selection.directory,
         value_proc=_validate_directory,
-    )
+    ))
     guidance = Table.grid(padding=(0, 2))
     guidance.add_column(style="bold cyan", no_wrap=True)
     guidance.add_column(overflow="fold")
@@ -66,7 +66,7 @@ def prompt_cleanup_selection(*, console: Console, selection: CleanupSelection) -
         label="Scope", default=selection.scope, choices=get_args(CleanupScope),
     ))
     while True:
-        resource: str = typer.prompt("Resources", default=selection.resource)
+        resource = cast(str, typer.prompt("Resources", default=selection.resource))
         try:
             _focuses, include_workspace = resolve_cleanup_resources(requested_resources=resource)
             break

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_agents/agents_doctor/scanning.py

@@ -106,7 +106,7 @@ def _skill_name(*, skill_path: Path) -> str:
     name_match = re.search(r"^name:\s*(?P<name>.+?)\s*$", frontmatter_match.group("body"), flags=re.MULTILINE)
     if name_match is None:
         return skill_path.parent.name
-    return name_match.group("name").strip().strip("\"'")
+    return cast(str, name_match.group("name")).strip().strip("\"'")
 
 
 def scan_skill_roots(*, roots: Sequence[tuple[DoctorOrigin, Path, str]], recursive: bool, state: DoctorResourceState) -> tuple[DoctorResource, ...]:

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_agents/agents_doctor/tui_cleanup_browser.py

@@ -141,10 +141,10 @@ class CleanupBrowser(Vertical):
         if event.button.id == "cleanup-clear":
             self.cleanup_selected.clear()
         else:
-            self.cleanup_selected.update(
-                entry.removal for index in self.cleanup_visible
-                if (entry := self.cleanup_inventory.entries[index]).removal is not None and entry.origin in ("local", "global")
-            )
+            for index in self.cleanup_visible:
+                entry = self.cleanup_inventory.entries[index]
+                if entry.removal is not None and entry.origin in ("local", "global"):
+                    self.cleanup_selected.add(entry.removal)
         self.update_marks()
 
     def update_marks(self) -> None:

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_agents/agents_doctor/tui_depoison.py

@@ -80,7 +80,7 @@ class DepoisonApp(App[int]):
         self.set_cleanup_busy(True)
         self.scan_inventory()
 
-    @work
+    @work()
     async def scan_inventory(self) -> None:
         try:
             self.cleanup_context = await asyncio.to_thread(create_doctor_context, working_directory=Path(self.cleanup_selection.directory))
@@ -134,7 +134,7 @@ class DepoisonApp(App[int]):
             self.query_one("#cleanup-status", Static).update("Rechecking selected resources and building file diffs…")
             self.review_cleanup(inventory, self.cleanup_context)
 
-    @work
+    @work()
     async def review_cleanup(self, inventory: HookInventory, context: DoctorContext) -> None:
         try:
             self.cleanup_plan = await asyncio.to_thread(
@@ -157,7 +157,7 @@ class DepoisonApp(App[int]):
             self.query_one(CleanupResourceTable).focus()
             self.query_one("#cleanup-status", Static).update("Review closed. No changes applied.")
 
-    @work
+    @work()
     async def apply_reviewed_cleanup(self, plan: CleanupPlan, context: DoctorContext) -> None:
         try:
             result = await asyncio.to_thread(apply_cleanup_plan, plan=plan, home_directory=context.home_directory)

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_agents/agents_local/vllm_catalog.py

@@ -53,7 +53,7 @@ def discover_vllm_models(
         with requests.get(url, params=params, timeout=timeout) as response:
             response.raise_for_status()
             payload = cast(object, response.json())
-            url = response.links.get("next", {}).get("url")
+            url = cast(dict[str, dict[str, str]], response.links).get("next", {}).get("url")
         params = {}
         if not isinstance(payload, list):
             raise ValueError("Hugging Face model catalog must be a list.")

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_agents/agents_status_aoe.py

@@ -81,7 +81,7 @@ def read_aoe_inventory(*, options: StatusOptions) -> tuple[list[JsonObject], lis
         running = session_runtime is not None and session_runtime.get("state") != "dead"
         session: JsonObject = {**entry, "name": name, "id": session_id, "saved": not running, "workspaces": [], "window_count": int(running)}
         sessions.append(session)
-        if not running or session_runtime is None or options.sessions and not {name, title, session_id}.intersection(options.sessions):
+        if session_runtime is None or not running or options.sessions and not {name, title, session_id}.intersection(options.sessions):
             continue
         panes.append({
             **entry, **session_runtime, "session": name, "window_id": session_id, "name": title,

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_cloud/backup_config.py

@@ -39,6 +39,7 @@ DEFAULT_BACKUP_HEADER = f"""# yaml-language-server: $schema=./{mapper_assets.MAP
 #     rel2home: true           # true: path_local is interpreted relative to your home dir
 #     os:
 #       - linux                # linux | darwin | windows
+#     note: "work laptop only" # optional free text; kept when commands rewrite this file, # comments are not
 #
 # Selection behavior:
 # - `devops data sync` filters entries by the current OS using the `os` field.
@@ -61,7 +62,7 @@ DEFAULT_BACKUP_HEADER = f"""# yaml-language-server: $schema=./{mapper_assets.MAP
 #       - darwin
 """
 VALID_OS = frozenset(ALL_OS_VALUES)
-EXPECTED_BACKUP_FIELDS = frozenset({"path_local", "path_cloud", "share_url", "zip", "encryption", "rel2home", "os"})
+EXPECTED_BACKUP_FIELDS = frozenset({"path_local", "path_cloud", "share_url", "zip", "encryption", "rel2home", "os", "note"})
 OS_OUTPUT_ORDER: dict[OsName, int] = {value: index for index, value in enumerate(ALL_OS_VALUES)}
 
 
@@ -73,6 +74,7 @@ class BackupItem(TypedDict):
     encryption: EncryptionMode | None
     rel2home: bool
     os: set[OsName]
+    note: str | None
 
 
 BackupGroup = dict[str, BackupItem]
@@ -213,6 +215,7 @@ def _parse_backup_config(raw: Mapping[str, object]) -> BackupConfig:
                 "encryption": _parse_encryption_field(item, item_name=item_key),
                 "rel2home": _require_bool_field(item, "rel2home", item_key),
                 "os": _parse_os_field(item.get("os"), item_key),
+                "note": _nullable_str_field(item, "note", item_key),
             }
         if group_items:
             config[group_name] = group_items
@@ -284,6 +287,9 @@ def serialize_backup_config(config: BackupConfig) -> str:
             yaml_item["zip"] = item["zip"]
             yaml_item["rel2home"] = item["rel2home"]
             yaml_item["os"] = _serialize_os_values(item["os"])
+            note = item["note"]
+            if note is not None:
+                yaml_item["note"] = note
             yaml_group[item_name] = yaml_item
         document[group_name] = yaml_group
     yaml_body = yaml.safe_dump(document, sort_keys=False, default_flow_style=False, allow_unicode=False, width=1000)

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_cloud/backup_registration.py

@@ -75,6 +75,7 @@ def register_backup_entry(
     password: str | None,
     rel2home: bool | None,
     os: str,
+    note: str | None,
 ) -> BackupRegistrationResult:
     local_path = Path(path_local).expanduser().absolute()
     if not local_path.exists():
@@ -122,6 +123,8 @@ def register_backup_entry(
         group_entries = {}
         config[group_name] = group_entries
     replaced = resolved_entry_name in group_entries
+    previous_note = group_entries[resolved_entry_name]["note"] if replaced else None
+    resolved_note = previous_note if note is None else note.strip() or None
     entry: BackupItem = {
         "path_local": local_display,
         "path_cloud": cloud_value,
@@ -130,6 +133,7 @@ def register_backup_entry(
         "encryption": encryption_mode,
         "rel2home": resolved_rel2home,
         "os": set(os_tokens),
+        "note": resolved_note,
     }
     group_entries[resolved_entry_name] = entry
     write_backup_config(USER_BACKUP_PATH, config)

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_cloud/cloud_copy.py

@@ -178,6 +178,7 @@ def _record_upload(
         password=None,
         rel2home=rel2home,
         os=record_os,
+        note=None,
     )
 
 

{stackops-26.11.1 → stackops-26.11.2}/src/stackops/scripts/python/helpers/helpers_cloud/cloud_mount.py

@@ -152,11 +152,13 @@ def mount(
             if system_name == "Windows":
                 print("🪟 Creating mount directory on Windows...")
                 mount_loc_path.parent.mkdir(parents=True, exist_ok=True)
-            elif system_name == "Linux" or system_name == "Darwin":
+            elif system_name in ("Linux", "Darwin"):
                 printable_name = "Linux" if system_name == "Linux" else "macOS"
                 print(f"🐧 Creating mount directory on {printable_name}...")
                 try:
-                    recovered = prepare_unix_mount_directory(mount_path=mount_loc_path, system_name=system_name)
+                    recovered = prepare_unix_mount_directory(
+                        mount_path=mount_loc_path, system_name="Linux" if system_name == "Linux" else "Darwin"
+                    )
                     if recovered:
                         console.print(Text(f"""Detached disconnected mount at {mount_loc_path}.""", style="yellow"))
                     if not mount_loc_path.is_mount():
@@ -234,10 +236,10 @@ def mount(
         print("❌ Error: Unsupported platform")
         raise typer.Exit(code=1)
 
-    launcher = "rclone" if daemon else "mprocs" if system_name == "Windows" else "tmux"
+    launcher = "mprocs" if system_name == "Windows" else "tmux"
     try:
         for command in launch_commands:
-            subprocess.run(command, shell=not daemon, check=True)
+            subprocess.run(command, shell=True, check=True)
     except subprocess.CalledProcessError as error:
         error_console.print(Text(f"""❌ Cloud mount could not launch {launcher} (exit code {error.returncode}).
 Check the command output above and verify that {launcher} is installed and available in this terminal.""", style="red"))
@@ -247,7 +249,7 @@ Check the command output above and verify that {launcher} is installed and avail
         raise typer.Exit(code=1) from None
     # draw success box dynamically
     title1 = "✅ Cloud mount command completed successfully"
-    title2 = "Mounts are running in the background." if daemon else "Returned from cloud mount session."
+    title2 = "Returned from cloud mount session."
     console.print(Panel(f"{title1}\n{title2}", title="Success", border_style="green"))
     return []