stackops 26.9.4__tar.gz → 26.10__tar.gz

stackops-26.10/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: stackops
+Version: 26.10
+Summary: Developer Stack Manager
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/stackops
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/stackops/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fire>=0.7.1
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: textual>=8.2.7
+Requires-Dist: typer>=0.27.2
+Provides-Extra: windows
+Provides-Extra: plot
+Requires-Dist: duckdb>=1.5.4; extra == "plot"
+Requires-Dist: duckdb-engine>=0.17.0; extra == "plot"
+Requires-Dist: ipykernel>=7.3.0; extra == "plot"
+Requires-Dist: ipython>=9.15.0; extra == "plot"
+Requires-Dist: jupyterlab>=4.6.0; extra == "plot"
+Requires-Dist: kaleido>=1.3.0; extra == "plot"
+Requires-Dist: matplotlib>=3.11.0; extra == "plot"
+Requires-Dist: nbformat>=5.10.4; extra == "plot"
+Requires-Dist: numpy>=2.5.0; extra == "plot"
+Requires-Dist: plotly>=6.8.0; extra == "plot"
+Requires-Dist: polars>=1.42.0; extra == "plot"
+Requires-Dist: python-magic>=0.4.27; extra == "plot"
+Requires-Dist: sqlalchemy>=2.0.51; extra == "plot"
+
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Developer workstation and workflow CLI.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps coordinates packages, configuration, repositories, data, terminal layouts, and coding-agent resources around the tools you already use. Install selected packages, synchronize declared configuration, or launch an authored tmux workspace through focused commands. Available installers and integrations vary by operating system and external tool.
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+```
+
+</details>
+
+
+## Codex Skill
+
+Install the StackOps skill for Codex with:
+
+```bash
+bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes
+```
+
+
+## Start with a workflow
+
+Inspect the commands for the workflow you need:
+
+```bash
+devops install --help
+devops config dotfiles sync --help
+terminal run --help
+```
+
+The [quickstart](https://thisismygitrepo.github.io/stackops/quickstart/) shows a selected-package example and configuration options.
+
+## Optional workstation setup
+
+This broader setup installs system and terminal package groups, copies bundled assets, applies public configuration mappings, and configures the default shell. Use it when you want those workstation conventions; existing customized systems can use individual commands instead. Package-group behavior depends on the platform and may invoke privileged package managers.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config dotfiles sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict throw-error \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+The scripted sync above copies configuration and stops on conflicts. The public copy/symlink choices in `devops config interactive` use `overwrite-default-path` and can replace existing targets; they are a different setup choice.
+
+
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, SSH transfer, and OneDrive helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the command families.
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.10/README.md

@@ -0,0 +1,123 @@
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Developer workstation and workflow CLI.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps coordinates packages, configuration, repositories, data, terminal layouts, and coding-agent resources around the tools you already use. Install selected packages, synchronize declared configuration, or launch an authored tmux workspace through focused commands. Available installers and integrations vary by operating system and external tool.
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+```
+
+</details>
+
+
+## Codex Skill
+
+Install the StackOps skill for Codex with:
+
+```bash
+bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes
+```
+
+
+## Start with a workflow
+
+Inspect the commands for the workflow you need:
+
+```bash
+devops install --help
+devops config dotfiles sync --help
+terminal run --help
+```
+
+The [quickstart](https://thisismygitrepo.github.io/stackops/quickstart/) shows a selected-package example and configuration options.
+
+## Optional workstation setup
+
+This broader setup installs system and terminal package groups, copies bundled assets, applies public configuration mappings, and configures the default shell. Use it when you want those workstation conventions; existing customized systems can use individual commands instead. Package-group behavior depends on the platform and may invoke privileged package managers.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config dotfiles sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict throw-error \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+The scripted sync above copies configuration and stops on conflicts. The public copy/symlink choices in `devops config interactive` use `overwrite-default-path` and can replace existing targets; they are a different setup choice.
+
+
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, SSH transfer, and OneDrive helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the command families.
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.10/pyproject.toml

@@ -0,0 +1,179 @@
+[build-system]
+requires = ["setuptools>=80", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "stackops"
+version = "26.10"
+description = "Developer Stack Manager"
+readme = "README.md"
+license = {text = "Apache 2.0"}
+authors = [
+    {name = "Alex Al-Saffar", email = "programmer@usa.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "fire>=0.7.1",
+    "gitpython>=3.1.46",
+    "psutil>=7.2.2",
+    "pyyaml>=6.0.3",
+    "questionary>=2.1.1",
+    "randomname>=0.2.1",
+    "requests>=2.32.5",
+    "rich>=14.3.3",
+    "tenacity>=9.1.4",
+    "textual>=8.2.7",
+    "typer>=0.27.2",
+]
+
+[project.optional-dependencies]
+windows = []
+plot = [
+    "duckdb>=1.5.4",
+    "duckdb-engine>=0.17.0",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
+    "nbformat>=5.10.4",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.51",
+]
+
+
+[project.urls]
+"Homepage" = "https://github.com/thisismygitrepo/stackops"
+"Bug Tracker" = "https://github.com/thisismygitrepo/stackops/issues"
+
+[project.scripts]
+devops = "stackops.scripts.python.devops:main"
+cloud = "stackops.scripts.python.cloud:main"
+fire = "stackops.scripts.python.fire_jobs:main"
+agents = "stackops.scripts.python.agents:main"
+terminal = "stackops.scripts.python.terminal:main"
+preview = "stackops.scripts.python.preview:main"
+utils = "stackops.scripts.python.utils:main"
+stackops = "stackops.scripts.python.stackops_entry:main"
+seek = "stackops.scripts.python.seek:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+stackops = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1", "**/*.txt", "utils/schemas/**/*.json", "utils/schemas/**/*.yaml"]
+
+[dependency-groups]
+dev = [
+    "aider>=0.2.6",
+    "build>=1.5.0",
+    "cleanpy>=0.5.1",
+    "cowsay>=6.1",
+    "duckdb>=1.5.4",
+    "gdown>=6.1.0",
+    "griffe>=2.1.0",
+    "ipdb>=0.13.13",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jsonschema>=4.26.0",
+    "kaleido>=1.3.0",
+    "marimo>=0.23.11",
+    "matplotlib>=3.11.0",
+    "mkdocstrings>=1.0.4",
+    "mkdocstrings-python>=2.0.5",
+    "mypy>=2.1.0",
+    "numpy>=2.5.0",
+    "pandas>=3.0.3",
+    "paramiko>=5.0.0",
+    "playwright>=1.62.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "pre-commit>=4.6.0",
+    "pudb>=2025.1.5",
+    "py7zr>=1.1.3",
+    "pydantic>=2.13.4",
+    "pydeps>=3.0.6",
+    "pyinstaller>=6.21.0",
+    "pylint>=4.0.6",
+    "pylsp-mypy>=0.7.3",
+    "pymupdf>=1.27.2.3",
+    "pypdf>=6.14.2",
+    "pyrefly>=1.1.1",
+    "pyright>=1.1.411",
+    "pytest>=9.1.1",
+    "python-lsp-server[mypy]>=1.14.0",
+    "qrcode>=8.2",
+    "ruff>=0.15.20",
+    "ruff-lsp>=0.0.62",
+    "sqlalchemy>=2.0.51",
+    "trogon>=0.6.0",
+    "ty>=0.0.55",
+    "types-mysqlclient>=2.2.0.20260508",
+    "types-paramiko>=5.0.0.20260617",
+    "types-pytz>=2026.2.0.20260518",
+    "types-pyyaml>=6.0.12.20260518",
+    "types-requests>=2.33.0.20260518",
+    "types-sqlalchemy>=1.4.53.38",
+    "types-toml>=0.10.8.20260518",
+    "types-urllib3>=1.26.25.14",
+    "vt-py>=0.22.0",
+    "yapf>=0.43.0",
+    "zensical>=0.0.46",
+]
+other = [
+    "duckdb-engine>=0.17.0",
+    "pycrucible>=0.4.6",
+    "vt-py>=0.22.0",
+]
+plot = [
+    "duckdb>=1.5.4",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
+    "nbformat>=5.10.4",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.51",
+]
+
+
+# [tool.uv]
+# default-groups = []
+
+[tool.pycrucible]
+entry = "src/stackops/scripts/python/devops.py"
+[tool.pycrucible.options]
+debug = false
+extract_to_temp = false
+delete_after_run = false
+offline_mode = false
+
+[tool.pycrucible.patterns]
+include = [
+    "**/*.py",
+    "**/*.ps1",
+    "**/*.sh",
+    "**/*.md",
+]
+exclude = [
+    "**/__pycache__/**",
+]

stackops-26.10/src/stackops/agents/prompts/prompts.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "StackOps prompts.yaml",
+  "description": "Named prompt and context entries used by `agents run`.",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/definitions/promptEntry"
+  },
+  "definitions": {
+    "promptEntry": {
+      "description": "Prompt text, a prompt object, or a nested namespace of prompt entries.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "description": {
+              "description": "Human-facing description. Ignored when StackOps builds prompt text.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "desc": {
+              "description": "Short human-facing description. Ignored when StackOps builds prompt text.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "desciption": {
+              "description": "Legacy misspelling accepted by StackOps and ignored when building prompt text.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "group": {
+              "description": "Optional category used to filter prompt selection with `agents run-prompt --group`. Ignored when StackOps builds prompt text.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "agent": {
+              "description": "Optional preferred agent label. Ignored when StackOps builds prompt text.",
+              "enum": [
+                "agy",
+                "cursor-agent",
+                "claude",
+                "qwen",
+                "copilot",
+                "codex",
+                "cortex",
+                "forge",
+                "crush",
+                "q",
+                "opencode",
+                "kilocode",
+                "cline",
+                "auggie",
+                "oz",
+                "droid",
+                "pi",
+                null
+              ]
+            },
+            "prompt": {
+              "description": "Prompt or context text.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "directory": {
+              "description": "Working directory displayed with this prompt.",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "additionalProperties": {
+            "$ref": "#/definitions/promptEntry"
+          }
+        }
+      ]
+    }
+  }
+}

stackops-26.10/src/stackops/agents/prompts/prompts.yaml

@@ -0,0 +1,36 @@
+# yaml-language-server: $schema=./prompts.schema.json
+# prompts.yaml used by `agents run-prompt`
+# Top-level keys show up in interactive selection.
+# Nested keys can be selected via --context-name with dot-path syntax (example: team.backend).
+# Each entry can be a plain string or an object with prompt metadata.
+# entryExample:
+#   prompt: replace me
+#   description: short label
+#   group: general
+
+renameTmuxTabs:
+  group: agents
+  description: Rename every tab in the current tmux session from its live activity.
+  prompt: |
+    Rename every window/tab in the current tmux session appropriately.
+
+    - Identify the current tmux session and limit all inspection and renaming to that session.
+    - Inspect every window before naming it. Use its pane working directories, foreground commands, titles, and recent visible output to infer its actual activity.
+    - Use concise, descriptive lower camel case names such as `javaScript`, with at most two words and no spaces, hyphens, underscores, or generic numbering.
+    - Give windows with the same working directory distinct activity-based names.
+    - Rename every window, including the current window. If a new window appears while working, inspect and rename it too.
+    - Do not interrupt running processes, send input to panes, change layouts, or switch the user's active window.
+    - Verify the final window list and report the resulting index-to-name mapping.
+
+findBugsOrImprovementRoom:
+  group: dev
+  description: a generic prompt to improve a repo.
+  prompt: |
+    Please find either bugs or room to improve this repo.
+    * The thing is, the repo is huge, so you need to split work to N agents. The use must specify a concrete value for N, if not, stop and ask them for the value. Once you find out the value, you need to undestand the repo at a fairly high level and figure out a way to distribute the workload on those sub agents.
+    * Create the sub agents with the latest Herdr CLI: create a workspace with one clearly named tab per agent. Use the same agent harness as you unless the user specifies another, e.g. codex, pi, omp, opencode etc.
+    * you wait until they all finish, then collect the results from them and pass on the final reports back to the user so they decide on what to do next.
+    * Notice that so far, we didn't fix anything or improve anything, it was just anaylsis,
+    * The user then might ask you to approve the bug fix suggestions or improvements suggestions, in which case you proceed to launch sub agents, one per improvment/bug fix (exactly one), they go in a separate Herdr workspace and are launched in separate tabs, and they must be instucted with additional caveat """please fix this only if you think it is genuinely a bug/improvment space, if you disagree please leave as is, also, please take into consideration complexity and speed, if solution adds too much complexity, we skip, if solution slow down things significantly, we skip too. We are not super fussy about correctness, we are more about practicality and performance and maintainability. Please write down a comment where needed that this is a design choice and we are aware of its implications or this is not strictly correct but we choose to do so for reason x and y.""". This gives us extra reassurance that first work was not hallucination because the prior agent was handling too much and missed details. The bug finding operation might have been done already and you are asked to start working on fixes, in which case the above applies.
+    * When finished, please don't close the Herdr workspaces or tabs, as user might want followup questions with those agents.
+