stackops 8.104__tar.gz → 26.6.1__tar.gz

{stackops-8.104/src/stackops.egg-info → stackops-26.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackops
-Version: 8.104
+Version: 26.6.1
 Summary: Developer Stack Manager
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{stackops-8.104 → stackops-26.6.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stackops"
-version = "8.104"
+version = "26.6.1"
 description = "Developer Stack Manager"
 readme = "README.md"
 license = {text = "Apache 2.0"}

stackops-26.6.1/src/manual/test_stackops_skill_refs.py

@@ -0,0 +1,74 @@
+from datetime import date
+
+from typer.testing import CliRunner
+
+from stackops.scripts.python.helpers.helpers_devops import cli_self_assets, stackops_skill_refs
+
+
+SAMPLE_GRAPH = {
+    "root": {
+        "kind": "root",
+        "name": "stackops",
+        "source": {"file": "src/stackops/scripts/python/stackops_entry.py"},
+        "children": [
+            {
+                "kind": "group",
+                "name": "devops",
+                "fullPath": "devops",
+                "source": {
+                    "file": "src/stackops/scripts/python/stackops_entry.py",
+                    "dispatches_to": "stackops.scripts.python.devops.get_app",
+                },
+                "aliases": [{"name": "d", "hidden": True}],
+                "children": [
+                    {
+                        "kind": "command",
+                        "name": "install",
+                        "fullPath": "devops install",
+                        "source": {"file": "src/stackops/scripts/python/devops.py", "callable": "install"},
+                    }
+                ],
+            },
+            {
+                "kind": "group",
+                "name": "type-fix",
+                "fullPath": "utils pyproject type-fix",
+                "source": {
+                    "file": "src/stackops/scripts/python/helpers/helpers_utils/pyproject_utils_app.py",
+                    "dispatches_to": "stackops.scripts.python.helpers.helpers_utils.type_fix.get_app",
+                },
+                "children": [],
+            },
+        ],
+    }
+}
+
+
+def test_cli_map_uses_canonical_tree_without_alias_nodes() -> None:
+    rendered = stackops_skill_refs.render_cli_map(
+        cli_graph_payload=SAMPLE_GRAPH,
+        project_scripts={"devops": "stackops.scripts.python.devops:main"},
+        generated_on=date(2026, 6, 9),
+    )
+
+    assert "Regenerated from `src/stackops/scripts/python/graph/cli_graph.json` on 2026-06-09." in rendered
+    assert "- `devops` -> `stackops.scripts.python.devops:main`" in rendered
+    assert "├─ devops" in rendered
+    assert "│  └─ install" in rendered
+    assert "└─ type-fix (callback group)" in rendered
+    assert "\n├─ d\n" not in rendered
+
+
+def test_source_map_links_groups_and_leaf_commands() -> None:
+    rendered = stackops_skill_refs.render_source_map(cli_graph_payload=SAMPLE_GRAPH, generated_on=date(2026, 6, 9))
+
+    assert "- `devops` -> `src/stackops/scripts/python/stackops_entry.py` -> `stackops.scripts.python.devops.get_app` via `devops`" in rendered
+    assert "- `devops install` -> `src/stackops/scripts/python/devops.py` -> `install`" in rendered
+    assert "devops self build-assets update-skill-refs" in rendered
+
+
+def test_update_skill_refs_command_is_registered() -> None:
+    result = CliRunner().invoke(cli_self_assets.get_app(), ["--help"])
+
+    assert result.exit_code == 0
+    assert "update-skill-refs" in result.stdout

stackops-26.6.1/src/manual/test_stackops_versioning.py

@@ -0,0 +1,42 @@
+from datetime import date
+
+import pytest
+
+from stackops.utils.upgrade_packages import (
+    format_stackops_display_version,
+    get_next_stackops_version,
+    parse_stackops_calver,
+)
+
+
+def test_legacy_version_migrates_to_current_calver_month() -> None:
+    assert get_next_stackops_version("8.104", today=date(2026, 6, 9)) == "26.6"
+
+
+def test_same_month_releases_increment_unbounded_release_number() -> None:
+    assert get_next_stackops_version("26.6", today=date(2026, 6, 9)) == "26.6.1"
+    assert get_next_stackops_version("26.6.500", today=date(2026, 6, 9)) == "26.6.501"
+
+
+def test_new_month_release_resets_to_month_base_version() -> None:
+    assert get_next_stackops_version("26.6.500", today=date(2026, 7, 1)) == "26.7"
+    assert get_next_stackops_version("25.12.4", today=date(2026, 1, 1)) == "26.1"
+
+
+def test_future_month_version_is_rejected_to_avoid_downgrade() -> None:
+    with pytest.raises(ValueError, match="later than today's release month"):
+        get_next_stackops_version("26.7", today=date(2026, 6, 9))
+
+
+def test_display_version_keeps_v_prefix_and_canonical_month() -> None:
+    assert format_stackops_display_version("26.6") == "v26.6"
+    assert format_stackops_display_version("26.6.1") == "v26.6.1"
+
+
+def test_calver_parser_accepts_tag_style_and_rejects_invalid_months() -> None:
+    parsed = parse_stackops_calver("v26.6.500")
+    assert parsed is not None
+    assert parsed.year == 26
+    assert parsed.month == 6
+    assert parsed.release == 500
+    assert parse_stackops_calver("8.104") is None

stackops-26.6.1/src/stackops/cluster/sessions_managers/helpers/__init__.py

@@ -0,0 +1 @@
+"""Session manager helper APIs."""

stackops-26.6.1/src/stackops/cluster/sessions_managers/tmux/tmux_utils/__init__.py

@@ -0,0 +1 @@
+"""tmux session manager utility APIs."""

stackops-26.6.1/src/stackops/cluster/sessions_managers/windows_terminal/wt_utils/__init__.py

@@ -0,0 +1 @@
+"""Windows Terminal session manager utility APIs."""

stackops-26.6.1/src/stackops/cluster/sessions_managers/zellij/zellij_utils/__init__.py

@@ -0,0 +1 @@
+"""Zellij session manager utility APIs."""

{stackops-8.104 → stackops-26.6.1}/src/stackops/jobs/installer/checks/security_cli.py

@@ -38,13 +38,14 @@ def scan(
     path: Annotated[
         Path | None,
         typer.Option(
-            "--path", help="Optional file path to scan instead of installed apps", exists=True, file_okay=True, dir_okay=False, resolve_path=True
+            "--path", "-p", help="Optional file path to scan instead of installed apps", exists=True, file_okay=True, dir_okay=False, resolve_path=True
         ),
     ] = None,
     record: Annotated[
         bool | None,
         typer.Option(
             "--record",
+            "-r",
             help="Write scan results to the saved repo reports. Installed-app scans already record by default.",
         ),
     ] = None,
@@ -130,7 +131,7 @@ def report(
     format_type: Annotated[
         ReportFormat, typer.Option("--format", "-f", help="Output format for apps or engines views", case_sensitive=False, show_choices=True)
     ] = "table",
-    summarize: Annotated[bool, typer.Option("--summarize", hidden=True)] = False,
+    summarize: Annotated[bool, typer.Option("--summarize", "-s", hidden=True)] = False,
 ) -> None:
     resolved_view = _resolve_report_view(view, summarize)
     if resolved_view == "options":

{stackops-8.104 → stackops-26.6.1}/src/stackops/jobs/scripts_dynamic/download_stackops_offline_installer.json

@@ -1,5 +1,5 @@
 {
-  "linux-x64": "https://drive.google.com/open?id=1AgHG8wkcNaJw2RvRrswUWu9dArJjZw2L",
+  "linux-x64": "https://drive.google.com/open?id=1cbusvFVXO36KMxax2H9DG8dG_tFGWtht",
   "linux-arm": null,
   "macos-x64": null,
   "macos-arm": null,

{stackops-8.104 → stackops-26.6.1}/src/stackops/jobs/scripts_dynamic/download_stackops_offline_installer.py

@@ -17,7 +17,12 @@ URL_MAP_FALLBACK_URL: Final[str] = (
     "https://raw.githubusercontent.com/thisismygitrepo/stackops/refs/heads/main/"
     f"src/stackops/jobs/scripts_dynamic/{URL_MAP_FILE_NAME}"
 )
-DEFAULT_OUTPUT_DIR: Final[Path] = Path.home().joinpath("tmp_results", "installer", "stackops-offline-installer")
+DEFAULT_OUTPUT_DIR: Final[Path] = Path.home().joinpath(
+    ".config",
+    "stackops",
+    "offline_installers",
+    "stackops-offline-installer",
+)
 KNOWN_TARGETS: Final[tuple[str, ...]] = (
     "linux-x64",
     "linux-arm",
@@ -35,15 +40,23 @@ class InstallerTarget:
 
 
 def main() -> None:
+    download_installer(target_key=None, output_dir=None)
+
+
+def download_installer(*, target_key: str | None, output_dir: Path | None) -> Path:
     url_map = _load_url_map()
     targets = _build_targets(url_map=url_map)
-    selected_target = _prompt_for_target(targets=targets)
+    if target_key is None:
+        selected_target = _prompt_for_target(targets=targets)
+    else:
+        selected_target = _resolve_target(targets=targets, target_key=target_key)
     if selected_target.url is None:
         raise RuntimeError(f"No Google Drive URL is configured yet for {selected_target.pair}.")
-    output_dir = DEFAULT_OUTPUT_DIR.expanduser().resolve()
-    print(f"Downloading {selected_target.pair} offline installer into {output_dir}")
-    _download_and_extract(url=selected_target.url, output_dir=output_dir)
-    print(f"Offline installer extracted to {output_dir}")
+    resolved_output_dir = (output_dir or DEFAULT_OUTPUT_DIR).expanduser().resolve()
+    print(f"Downloading {selected_target.pair} offline installer into {resolved_output_dir}")
+    _download_and_extract(url=selected_target.url, output_dir=resolved_output_dir)
+    print(f"Offline installer extracted to {resolved_output_dir}")
+    return resolved_output_dir
 
 
 def _load_url_map() -> dict[str, str | None]:
@@ -91,6 +104,14 @@ def _prompt_for_target(*, targets: list[InstallerTarget]) -> InstallerTarget:
         print("Choice out of range.")
 
 
+def _resolve_target(*, targets: list[InstallerTarget], target_key: str) -> InstallerTarget:
+    for target in targets:
+        if target.pair == target_key:
+            return target
+    supported_targets = ", ".join(target.pair for target in targets)
+    raise RuntimeError(f"Unsupported offline installer target: {target_key}. Supported targets: {supported_targets}")
+
+
 def _download_and_extract(*, url: str, output_dir: Path) -> None:
     if output_dir.exists():
         shutil.rmtree(output_dir)

{stackops-8.104 → stackops-26.6.1}/src/stackops/profile/create_links.py

@@ -14,7 +14,7 @@ from rich.text import Text
 from rich.table import Table
 
 from stackops.utils.links import symlink_map, copy_map
-from stackops.profile.create_links_export import DIRECTION_STRICT, ON_CONFLICT_STRICT
+from stackops.profile.create_links_export import CONFIG_SOURCE_LOOSE, CONFIG_SOURCE_MAP, DIRECTION_STRICT, ON_CONFLICT_STRICT
 from stackops.profile.dotfiles_mapper import (
     LIBRARY_MAPPER_PATH,
     USER_MAPPER_PATH,
@@ -29,7 +29,7 @@ from stackops.utils.source_of_truth import CONFIG_ROOT, DOTFILES_SSH_CREDS_ROOT,
 import platform
 import subprocess
 import io
-from typing import Any, TypedDict, Literal, TypeAlias
+from typing import Any, TypedDict, Literal
 
 
 system = platform.system()  # Linux or Windows
@@ -39,10 +39,6 @@ MAX_ERROR_TABLE_CHARS = 30
 
 console = Console()
 
-REPO_ALIASES = {
-    "l": "library",
-    "i": "user",
-}
 ON_CONFLICT_UP_COPY_MAP: dict[ON_CONFLICT_STRICT, ON_CONFLICT_STRICT] = {
     "throw-error": "throw-error",
     "overwrite-self-managed": "overwrite-default-path",
@@ -66,10 +62,6 @@ def _normalize_os_name(value: str) -> OsName:
             raise ValueError(f"Unsupported operating system: {value!r}. Expected one of: {expected_values}.")
 
 
-def _normalize_repo_name(value: str) -> str:
-    return REPO_ALIASES.get(value.strip().lower(), value.strip().lower())
-
-
 def _parse_os_field(os_field: OsField) -> set[OsName]:
     return set(os_field)
 
@@ -95,12 +87,9 @@ class MapperFileData(TypedDict):
     public: dict[str, list[ConfigMapper]]
     private: dict[str, list[ConfigMapper]]
 
-RepoLoose: TypeAlias = Literal["user", "library", "all"]
-
-
-def read_mapper(repo: RepoLoose) -> MapperFileData:
-    repo_key = _normalize_repo_name(repo)
-    match repo_key:
+def read_mapper(source: CONFIG_SOURCE_LOOSE) -> MapperFileData:
+    source_key = CONFIG_SOURCE_MAP[source]
+    match source_key:
         case "user":
             mapper_path = USER_MAPPER_PATH
         case "library":
@@ -110,13 +99,13 @@ def read_mapper(repo: RepoLoose) -> MapperFileData:
             if not USER_MAPPER_PATH.exists():
                 user_mapper: MapperFileData = {"public": {}, "private": {}}
             else:
-                user_mapper = read_mapper(repo="user")
-            library_mapper = read_mapper(repo="library")
+                user_mapper = read_mapper(source="user")
+            library_mapper = read_mapper(source="library")
             merged_public: dict[str, list[ConfigMapper]] = {**library_mapper["public"], **user_mapper["public"]}
             merged_private: dict[str, list[ConfigMapper]] = {**library_mapper["private"], **user_mapper["private"]}
             return {"public": merged_public, "private": merged_private}
         case _:
-            raise ValueError(f"Unsupported repo value: {repo}")
+            raise ValueError(f"Unsupported config source value: {source}")
     mapper_data: MapperDocument = load_dotfiles_mapper(mapper_path)
     public: dict[str, list[ConfigMapper]] = {}
     private: dict[str, list[ConfigMapper]] = {}

{stackops-8.104 → stackops-26.6.1}/src/stackops/profile/create_links_export.py

@@ -35,9 +35,9 @@ SENSITIVITY_MAP: dict[SENSITIVITY_LOOSE, SENSITIVITY_STRICT] = {
     "a": "all",
 }
 
-REPO_STRICT: TypeAlias = Literal["library", "user", "all"]
-REPO_LOOSE: TypeAlias = Literal["library", "l", "user", "u", "all", "a"]
-REPO_MAP: dict[REPO_LOOSE, REPO_STRICT] = {
+CONFIG_SOURCE_STRICT: TypeAlias = Literal["library", "user", "all"]
+CONFIG_SOURCE_LOOSE: TypeAlias = Literal["library", "l", "user", "u", "all", "a"]
+CONFIG_SOURCE_MAP: dict[CONFIG_SOURCE_LOOSE, CONFIG_SOURCE_STRICT] = {
     "library": "library",
     "l": "library",
     "user": "user",
@@ -45,6 +45,14 @@ REPO_MAP: dict[REPO_LOOSE, REPO_STRICT] = {
     "a": "all",
     "all": "all",
 }
+CONFIG_FILE_SOURCE_STRICT: TypeAlias = Literal["library", "user"]
+CONFIG_FILE_SOURCE_LOOSE: TypeAlias = Literal["library", "l", "user", "u"]
+CONFIG_FILE_SOURCE_MAP: dict[CONFIG_FILE_SOURCE_LOOSE, CONFIG_FILE_SOURCE_STRICT] = {
+    "library": "library",
+    "l": "library",
+    "user": "user",
+    "u": "user",
+}
 
 METHOD_STRICT: TypeAlias = Literal["symlink", "copy"]
 METHOD_LOOSE: TypeAlias = Literal["symlink", "s", "copy", "c"]
@@ -77,7 +85,7 @@ def main_from_parser(
     ],
     sensitivity: Annotated[SENSITIVITY_LOOSE, typer.Option(..., "--sensitivity", "-s", help="Sensitivity of the configuration files to manage.")] = "all",
     method: Annotated[METHOD_LOOSE, typer.Option(..., "--method", "-m", help="Method to use for linking files")] = "symlink",
-    repo: Annotated[REPO_LOOSE, typer.Option(..., "--repo", "-r", help="Mapper source to use for config files.")] = "library",
+    source: Annotated[CONFIG_SOURCE_LOOSE, typer.Option(..., "--source", help="Mapper source to use for config files.")] = "library",
     on_conflict: Annotated[ON_CONFLICT_LOOSE, typer.Option(..., "--on-conflict", "-c", help="Action to take on conflict")] = "throw-error",
     which: Annotated[str | None, typer.Option(..., "--which", "-w", help="Specific items to process ('all' for all items) (default is None, selection is interactive)")] = None,
 ) -> None:
@@ -102,8 +110,8 @@ def main_from_parser(
             merged_mapper[program_name] = list(program_files)
         return merged_mapper
 
-    repo_key = REPO_MAP[repo]
-    mapper_full_obj = read_mapper(repo=repo_key)
+    source_key = CONFIG_SOURCE_MAP[source]
+    mapper_full_obj = read_mapper(source=source_key)
     mapper_full: dict[str, list[ConfigMapper]]
     sensitivity_key = SENSITIVITY_MAP[sensitivity]
     if sensitivity_key == "private":

{stackops-8.104 → stackops-26.6.1}/src/stackops/scripts/python/agents_parallel_commands.py

@@ -60,7 +60,7 @@ def agents_create(
     save_as_yaml: Annotated[
         bool,
         typer.Option(
-            ..., "--save-as-yaml", help="Save or update this create configuration in repo .stackops/agents/parallel.yaml under the resolved job name."
+            ..., "--save-as-yaml", "-y", help="Save or update this create configuration in repo .stackops/agents/parallel.yaml under the resolved job name."
         ),
     ] = False,
     interactive: Annotated[
@@ -105,9 +105,9 @@ def collect(
     agent_dir: Annotated[str, typer.Argument(..., help="Path to the agent directory containing the prompts folder")],
     output_path: Annotated[str, typer.Argument(..., help="Path to write the concatenated material files")],
     separator: Annotated[
-        str, typer.Option(..., help="Separator to use when concatenating material files. Supports escaped values like '\\n'.")
+        str, typer.Option(..., "--separator", "-s", help="Separator to use when concatenating material files. Supports escaped values like '\\n'.")
     ] = "\n",
-    pattern: Annotated[str | None, typer.Option(..., help="Pattern to match material files (e.g., 'res.txt')")] = None,
+    pattern: Annotated[str | None, typer.Option(..., "--pattern", "-p", help="Pattern to match material files (e.g., 'res.txt')")] = None,
 ) -> None:
     """Collect all material files from an agent directory and concatenate them."""
     from stackops.scripts.python.helpers.helpers_agents.agents_impl import collect as impl

{stackops-8.104 → stackops-26.6.1}/src/stackops/scripts/python/ai/solutions/opencode/opencode.jsonc

@@ -7,22 +7,25 @@
   ],
   "permission": {
     "*": "ask",
-    "external_directory": "allow",
+    "bash": "allow",
     "edit": "allow",
-    "task": "allow",
-    "webfetch": "allow",
-    "websearch": "allow",
-    "codesearch": "allow",
-    "bash": {
-      "*": "allow",
-      "git *": "allow"
-    },
     "read": {
       "*": "allow",
       "*.env": "deny",
       "*.env.*": "deny",
       "*.env.example": "allow"
-    }
+    },
+    "grep": "allow",
+    "glob": "allow",
+    "lsp": "allow",
+    "skill": "allow",
+    "todowrite": "allow",
+    "webfetch": "allow",
+    "websearch": "allow",
+    "question": "allow",
+    "task": "allow",
+    "external_directory": "allow",
+    "codesearch": "allow"
   },
   "mcp": {
     "context7": {

{stackops-8.104 → stackops-26.6.1}/src/stackops/scripts/python/cloud.py

@@ -34,7 +34,7 @@ def copy(
     record: Annotated[bool, typer.Option("--record", "-m", help="📝 Record an upload in user mapper/data.yaml. Requires --record-name.")] = False,
     record_group: Annotated[str, typer.Option("--record-group", "-g", help="🗂 Group name for --record in mapper/data.yaml.")] = "default",
     record_name: Annotated[str | None, typer.Option("--record-name", "-n", help="🏷 Entry name for --record in mapper/data.yaml. Required when using --record.")] = None,
-    record_os: Annotated[str, typer.Option("--record-os", help="💻 OS filter for --record. Comma-separated: linux,darwin,windows. Defaults to all.")] = DEFAULT_OS_FILTER,
+    record_os: Annotated[str, typer.Option("--record-os", "-F", help="💻 OS filter for --record. Comma-separated: linux,darwin,windows. Defaults to all.")] = DEFAULT_OS_FILTER,
     rel2home: Annotated[bool, typer.Option("--relative2home", "-r", help="🏠 Relative to `myhome` folder")] = defaults["rel2home"],
     root: Annotated[str, typer.Option("--root", "-R", help="🌳 Remote root.")] = defaults["root"],
     pwd: Annotated[str | None, typer.Option("--password", "-p", help="🔒 Symmetric GPG encryption password. Implies --encrypt --encryption symmetric.")] = defaults["pwd"],