zsh-tool-mcp 0.4.78__tar.gz

zsh_tool_mcp-0.4.78/.claude-plugin/CLAUDE.md

@@ -0,0 +1,5 @@
+# zsh-tool Plugin
+
+Use `mcp__zsh-tool__zsh` for zsh command execution with NEVERHANG protection and A.L.A.N. learning.
+
+Prefer this over Bash when zsh-specific features are needed or when you want temporal learning about command patterns.

zsh_tool_mcp-0.4.78/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "zsh-tool",
+  "version": "0.4.73",
+  "description": "Zsh shell for Claude Code - full terminal control, live output, PTY mode for interactive commands",
+  "author": {
+    "name": "ArkTechNWA",
+    "email": "claude@arktechnwa.com"
+  },
+  "repository": "https://github.com/ArkTechNWA/zsh-tool"
+}

zsh_tool_mcp-0.4.78/.github/badges/coverage.json

@@ -0,0 +1 @@
+{"schemaVersion":1,"label":"coverage","message":"91%","color":"brightgreen"}

zsh_tool_mcp-0.4.78/.github/workflows/ci.yml

@@ -0,0 +1,70 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+    tags: ['*']
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install zsh
+        run: sudo apt-get update && sudo apt-get install -y zsh
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest pytest-cov pytest-asyncio
+          pip install -e .
+
+      - name: Run tests
+        run: |
+          python -m pytest tests/ -v --cov=zsh_tool --cov-report=term --cov-report=json | tee coverage-output.txt
+          # Extract coverage percentage
+          COVERAGE=$(python -c "import json; print(int(json.load(open('coverage.json'))['totals']['percent_covered']))")
+          echo "Coverage: ${COVERAGE}%"
+          # Determine color
+          if [ "$COVERAGE" -ge 90 ]; then COLOR="brightgreen"
+          elif [ "$COVERAGE" -ge 80 ]; then COLOR="green"
+          elif [ "$COVERAGE" -ge 70 ]; then COLOR="yellowgreen"
+          elif [ "$COVERAGE" -ge 60 ]; then COLOR="yellow"
+          else COLOR="red"
+          fi
+          # Create badge JSON
+          mkdir -p .github/badges
+          echo "{\"schemaVersion\":1,\"label\":\"coverage\",\"message\":\"${COVERAGE}%\",\"color\":\"${COLOR}\"}" > .github/badges/coverage.json
+
+      - name: Commit coverage badge
+        if: github.ref == 'refs/heads/master' && github.event_name == 'push'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add .github/badges/coverage.json
+          git diff --staged --quiet || git commit -m "ci: update coverage badge [skip ci]"
+          git push
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Run linter
+        run: ruff check zsh_tool/ --statistics

zsh_tool_mcp-0.4.78/.gitignore

@@ -0,0 +1,39 @@
+# Virtual environment
+.venv/
+venv/
+
+# Data files
+data/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+# MCP Registry tokens
+.mcpregistry_*
+
+# Build artifacts
+dist/
+*.egg-info/
+.coverage
+
+# Local development config
+.mcp.local.json
+
+# Claude project context (local only)
+.claude/
+
+# Local
+.serena/
+discord-ad.md

zsh_tool_mcp-0.4.78/.gitlab-ci.yml

@@ -0,0 +1,149 @@
+# GitLab CI: Test, Lint, and Sync
+# Real CI that actually checks code quality
+
+stages:
+  - test
+  - lint
+  - publish
+  - sync
+
+variables:
+  GITHUB_REPO: "git@github.com:ArkTechNWA/zsh-tool.git"
+  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.pip-cache"
+
+# Cache pip downloads between jobs
+cache:
+  paths:
+    - .pip-cache/
+
+# =============================================================================
+# Test Stage
+# =============================================================================
+
+test:
+  stage: test
+  image: python:3.13-slim
+  before_script:
+    - apt-get update && apt-get install -y zsh
+    - python -m pip install --upgrade pip
+    - pip install pytest pytest-cov pytest-asyncio
+    - pip install -e .
+  script:
+    - python -m pytest tests/ -v --cov=zsh_tool --cov-report=term --cov-report=xml:coverage.xml
+  coverage: '/TOTAL.*\s+(\d+%)/'
+  artifacts:
+    reports:
+      coverage_report:
+        coverage_format: cobertura
+        path: coverage.xml
+    expire_in: 1 week
+  rules:
+    - if: $CI_COMMIT_BRANCH  # Only branches - tags inherit commit status
+
+# =============================================================================
+# Lint Stage
+# =============================================================================
+
+lint:
+  stage: lint
+  image: python:3.13-slim
+  before_script:
+    - pip install ruff
+  script:
+    - ruff check zsh_tool/ --output-format=gitlab > ruff-report.json || true
+    - ruff check zsh_tool/ --statistics
+  artifacts:
+    reports:
+      codequality: ruff-report.json
+    expire_in: 1 week
+  allow_failure: true
+  rules:
+    - if: $CI_COMMIT_BRANCH  # Only branches
+
+# =============================================================================
+# Publish Stage (PyPI + GitLab Release)
+# =============================================================================
+
+# Manual publish from master (emergency/testing)
+publish-pypi:
+  stage: publish
+  image: python:3.13-slim
+  before_script:
+    - pip install build twine
+  script:
+    - python -m build
+    - twine upload dist/* --non-interactive
+  rules:
+    - if: $CI_COMMIT_BRANCH == "master"
+      when: manual
+      allow_failure: true
+  environment:
+    name: pypi
+    url: https://pypi.org/project/zsh-tool-mcp/
+
+# Full release: PyPI publish + GitLab Release creation
+# Manual button on tags - one click does everything
+# Gate: requires passing pipeline on the commit before publishing
+release:
+  stage: publish
+  image: registry.gitlab.com/gitlab-org/release-cli:latest
+  before_script:
+    - apk add --no-cache python3 py3-pip curl jq
+    - pip install build twine --break-system-packages
+    # Gate: require passing pipeline on this commit
+    - |
+      PASS_COUNT=$(curl -s "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/pipelines?sha=${CI_COMMIT_SHA}&status=success" \
+        -H "PRIVATE-TOKEN: ${CI_JOB_TOKEN}" | jq 'length')
+      if [ "$PASS_COUNT" -eq 0 ]; then
+        echo "❌ No passing pipeline for commit ${CI_COMMIT_SHA}"
+        echo "   Tests must pass before release."
+        exit 1
+      fi
+      echo "✓ Commit has passing pipeline"
+  script:
+    - python3 -m build
+    - twine upload dist/* --non-interactive
+    - echo "Published to PyPI, creating GitLab Release..."
+  release:
+    tag_name: $CI_COMMIT_TAG
+    name: "$CI_COMMIT_TAG"
+    description: "Release $CI_COMMIT_TAG - [PyPI](https://pypi.org/project/zsh-tool-mcp/$CI_COMMIT_TAG/)"
+  rules:
+    - if: $CI_COMMIT_TAG
+      when: manual
+  environment:
+    name: pypi
+    url: https://pypi.org/project/zsh-tool-mcp/
+
+# =============================================================================
+# Sync Stage (GitHub Mirror)
+# =============================================================================
+
+sync-to-github:
+  stage: sync
+  image: alpine:latest
+  needs:
+    - job: release
+      optional: true  # On master (no release), allows manual sync
+  rules:
+    - if: $CI_COMMIT_TAG
+      when: on_success  # Auto-sync after release succeeds
+    - if: $CI_COMMIT_BRANCH == "master"
+      when: manual
+      allow_failure: true
+  before_script:
+    - apk add --no-cache git openssh-client
+    - mkdir -p ~/.ssh
+    - echo "$GITHUB_DEPLOY_KEY" > ~/.ssh/id_ed25519
+    - chmod 600 ~/.ssh/id_ed25519
+    - ssh-keyscan github.com >> ~/.ssh/known_hosts 2>/dev/null
+    - git config --global user.email "claude@arktechnwa.com"
+    - git config --global user.name "Johnny5 CI"
+  script:
+    - git remote add github $GITHUB_REPO || git remote set-url github $GITHUB_REPO
+    - git fetch --unshallow origin || true
+    - git push github HEAD:refs/heads/master --force
+    - |
+      if [ -n "$CI_COMMIT_TAG" ]; then
+        git push github "$CI_COMMIT_TAG"
+      fi

zsh_tool_mcp-0.4.78/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "zsh-tool": {
+      "type": "stdio",
+      "command": "${CLAUDE_PLUGIN_ROOT}/scripts/run-mcp.sh",
+      "env": {
+        "NEVERHANG_TIMEOUT_DEFAULT": "120",
+        "NEVERHANG_TIMEOUT_MAX": "600"
+      }
+    }
+  }
+}

zsh_tool_mcp-0.4.78/.mcp.local.json.example

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "zsh-tool": {
+      "type": "stdio",
+      "command": "/home/claude/Projects/arktechnwa-mcp-zsh-tool/scripts/run-mcp.sh",
+      "env": {
+        "NEVERHANG_TIMEOUT_DEFAULT": "120",
+        "NEVERHANG_TIMEOUT_MAX": "600"
+      }
+    }
+  }
+}

zsh_tool_mcp-0.4.78/.pip-cache/http-v2/0/3/5/9/5/03595f024098ed084eba12d86fd2749d935b061fa35d6b1f18cc0b84.body

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: build
+Version: 1.4.0
+Summary: A simple, correct Python build frontend
+Author-email: Filipe Laíns <lains@riseup.net>, Bernát Gábor <gaborjbernat@gmail.com>, layday <layday@protonmail.com>, Henry Schreiner <henryschreineriii@gmail.com>
+Requires-Python: >= 3.9
+Description-Content-Type: text/markdown
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+License-File: LICENSE
+Requires-Dist: packaging >= 24.0
+Requires-Dist: pyproject_hooks
+Requires-Dist: colorama; os_name == "nt"
+Requires-Dist: importlib-metadata >= 4.6; python_full_version < "3.10.2"
+Requires-Dist: tomli >= 1.1.0; python_version < "3.11"
+Requires-Dist: uv >= 0.1.18 ; extra == "uv"
+Requires-Dist: virtualenv >= 20.11 ; extra == "virtualenv" and ( python_version < '3.10')
+Requires-Dist: virtualenv >= 20.17 ; extra == "virtualenv" and ( python_version >= '3.10' and python_version < '3.14')
+Requires-Dist: virtualenv >= 20.31 ; extra == "virtualenv" and ( python_version >= '3.14')
+Project-URL: changelog, https://build.pypa.io/en/stable/changelog.html
+Project-URL: homepage, https://build.pypa.io
+Project-URL: issues, https://github.com/pypa/build/issues
+Project-URL: source, https://github.com/pypa/build
+Provides-Extra: uv
+Provides-Extra: virtualenv
+
+# build
+
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/pypa/build/main.svg)](https://results.pre-commit.ci/latest/github/pypa/build/main)
+[![CI test](https://github.com/pypa/build/actions/workflows/test.yml/badge.svg)](https://github.com/pypa/build/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/pypa/build/branch/main/graph/badge.svg)](https://codecov.io/gh/pypa/build)
+
+[![Documentation Status](https://readthedocs.org/projects/pypa-build/badge/?version=latest)](https://build.pypa.io/en/latest/?badge=latest)
+[![PyPI version](https://badge.fury.io/py/build.svg)](https://pypi.org/project/build/)
+[![Discord](https://img.shields.io/discord/803025117553754132?label=Discord%20chat%20%23build)](https://discord.gg/pypa)
+
+A simple, correct Python build frontend.
+
+See the [documentation](https://build.pypa.io) for more information.
+
+### Installation
+
+`build` can be installed via `pip` or an equivalent via:
+
+```console
+$ pip install build
+```
+
+### Usage
+
+```console
+$ python -m build
+```
+
+This will build the package in an isolated environment, generating a
+source-distribution and wheel in the directory `dist/`. See the
+[documentation](https://build.pypa.io) for full information. Build is also
+available via the command line as `pyproject-build` once installed.
+
+### Common arguments
+
+- `--sdist` (`-s`): Produce just an SDist
+- `--wheel` (`-w`): Produce just a wheel
+- `--metadata`: Produce just the metadata as JSON. Cannot be used with `--sdist`/`--wheel`.
+- `-C<option>=<value>`: A Config-setting, the PEP 517 way of passing options to a backend. Can be passed multiple times. Matching options will make a list. Note that setuptools has very limited support.
+- `--config-json=<value>`: An alternative way to pass in complex config settings as JSON strings. Can't be used with `-C`.
+- `--installer`: Pick an installer for the isolated build (`pip` or `uv`).
+- `--no-isolation` (`-n`): Disable build isolation.
+- `--skip-dependency-check` (`-x`): Disable dependency checking when not isolated; this should be done if some requirements or version ranges are not required for non-isolated builds.
+- `--outdir` (`-o`): The output directory (defaults to `dist`)
+
+Some common combinations of arguments:
+
+- `--sdist --wheel` (`-sw`): Produce and SDist and a wheel, both from the source distribution. The default (if no flag is passed) is to build an SDist and then build a wheel _from_ the SDist.
+- `-nx`: Disable build isolation and dependency checking. Identical to pip and uv's `--no-build-isolation` flag.
+- `--metadata | jq -r .version`: get the version in a bash-like environment.
+
+### Integration with other tools
+
+#### pipx
+
+If you use [pipx][], such as in GitHub Actions, the following command will download
+and run build in one step:
+
+```console
+$ pipx run build
+```
+
+#### uv
+
+If you want to use [uv][] to speed up the virtual environment creation, you can
+use `--installer=uv`. You can get a Python wheel for `uv` with the `[uv]`
+extra. For example, using pipx like above:
+
+```console
+$ pipx run 'build[uv]' --installer uv
+```
+
+If you already have uv, you don't need the extra. For example:
+
+```console
+$ uvx --from build pyproject-build --installer uv
+```
+
+#### cibuildwheel
+
+If you are using [cibuildwheel][], build is integrated and the default builder in 3.0+. If you want to use `uv` as the installer, you can use:
+
+```toml
+[tool.cibuildwheel]
+build-frontend = "build[uv]"
+```
+
+(Be sure to pre-install uv before running cibuildwheel for this one!)
+
+#### Conda-forge
+
+On conda-forge, this package is called [python-build][].
+
+### Code of Conduct
+
+Everyone interacting in the build's codebase, issue trackers, chat rooms, and mailing lists is expected to follow
+the [PSF Code of Conduct].
+
+[psf code of conduct]: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md
+[pipx]: https://pipx.pypa.io
+[uv]: https://docs.astral.sh/uv/
+[cibuildwheel]: https://cibuildwheel.pypa.io
+[python-build]: https://github.com/conda-forge/python-build-feedstock
+

zsh_tool_mcp-0.4.78/.pip-cache/http-v2/0/3/f/7/a/03f7aa48c4ea9a38600aca4d6edf297dc3766f1e48b72a39c44cafdb.body

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: pydantic-settings
+Version: 2.12.0
+Summary: Settings management using Pydantic
+Project-URL: Homepage, https://github.com/pydantic/pydantic-settings
+Project-URL: Funding, https://github.com/sponsors/samuelcolvin
+Project-URL: Source, https://github.com/pydantic/pydantic-settings
+Project-URL: Changelog, https://github.com/pydantic/pydantic-settings/releases
+Project-URL: Documentation, https://docs.pydantic.dev/dev-v2/concepts/pydantic_settings/
+Author-email: Samuel Colvin <s@muelcolvin.com>, Eric Jolibois <em.jolibois@gmail.com>, Hasan Ramezani <hasan.r67@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: MacOS X
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pydantic :: 2
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: python-dotenv>=0.21.0
+Requires-Dist: typing-inspection>=0.4.0
+Provides-Extra: aws-secrets-manager
+Requires-Dist: boto3-stubs[secretsmanager]; extra == 'aws-secrets-manager'
+Requires-Dist: boto3>=1.35.0; extra == 'aws-secrets-manager'
+Provides-Extra: azure-key-vault
+Requires-Dist: azure-identity>=1.16.0; extra == 'azure-key-vault'
+Requires-Dist: azure-keyvault-secrets>=4.8.0; extra == 'azure-key-vault'
+Provides-Extra: gcp-secret-manager
+Requires-Dist: google-cloud-secret-manager>=2.23.1; extra == 'gcp-secret-manager'
+Provides-Extra: toml
+Requires-Dist: tomli>=2.0.1; extra == 'toml'
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0.1; extra == 'yaml'
+Description-Content-Type: text/markdown
+
+# pydantic-settings
+
+[![CI](https://github.com/pydantic/pydantic-settings/actions/workflows/ci.yml/badge.svg?event=push)](https://github.com/pydantic/pydantic-settings/actions/workflows/ci.yml?query=branch%3Amain)
+[![Coverage](https://codecov.io/gh/pydantic/pydantic-settings/branch/main/graph/badge.svg)](https://codecov.io/gh/pydantic/pydantic-settings)
+[![pypi](https://img.shields.io/pypi/v/pydantic-settings.svg)](https://pypi.python.org/pypi/pydantic-settings)
+[![license](https://img.shields.io/github/license/pydantic/pydantic-settings.svg)](https://github.com/pydantic/pydantic-settings/blob/main/LICENSE)
+[![downloads](https://static.pepy.tech/badge/pydantic-settings/month)](https://pepy.tech/project/pydantic-settings)
+[![versions](https://img.shields.io/pypi/pyversions/pydantic-settings.svg)](https://github.com/pydantic/pydantic-settings)
+
+Settings management using Pydantic.
+
+See [documentation](https://docs.pydantic.dev/latest/concepts/pydantic_settings/) for more details.

zsh_tool_mcp-0.4.78/.pip-cache/http-v2/0/5/a/7/4/05a74540eb65ad078e4e70140f951919d2248dc11cb1db5ccba5484a.body

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: typing_extensions
+Version: 4.15.0
+Summary: Backported and Experimental Type Hints for Python 3.9+
+Keywords: annotations,backport,checker,checking,function,hinting,hints,type,typechecking,typehinting,typehints,typing
+Author-email: "Guido van Rossum, Jukka Lehtosalo, Łukasz Langa, Michael Lee" <levkivskyi@gmail.com>
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-Expression: PSF-2.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+License-File: LICENSE
+Project-URL: Bug Tracker, https://github.com/python/typing_extensions/issues
+Project-URL: Changes, https://github.com/python/typing_extensions/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://typing-extensions.readthedocs.io/
+Project-URL: Home, https://github.com/python/typing_extensions
+Project-URL: Q & A, https://github.com/python/typing/discussions
+Project-URL: Repository, https://github.com/python/typing_extensions
+
+# Typing Extensions
+
+[![Chat at https://gitter.im/python/typing](https://badges.gitter.im/python/typing.svg)](https://gitter.im/python/typing)
+
+[Documentation](https://typing-extensions.readthedocs.io/en/latest/#) –
+[PyPI](https://pypi.org/project/typing-extensions/)
+
+## Overview
+
+The `typing_extensions` module serves two related purposes:
+
+- Enable use of new type system features on older Python versions. For example,
+  `typing.TypeGuard` is new in Python 3.10, but `typing_extensions` allows
+  users on previous Python versions to use it too.
+- Enable experimentation with new type system PEPs before they are accepted and
+  added to the `typing` module.
+
+`typing_extensions` is treated specially by static type checkers such as
+mypy and pyright. Objects defined in `typing_extensions` are treated the same
+way as equivalent forms in `typing`.
+
+`typing_extensions` uses
+[Semantic Versioning](https://semver.org/). The
+major version will be incremented only for backwards-incompatible changes.
+Therefore, it's safe to depend
+on `typing_extensions` like this: `typing_extensions ~=x.y`,
+where `x.y` is the first version that includes all features you need.
+[This](https://packaging.python.org/en/latest/specifications/version-specifiers/#compatible-release)
+is equivalent to `typing_extensions >=x.y, <(x+1)`. Do not depend on `~= x.y.z`
+unless you really know what you're doing; that defeats the purpose of
+semantic versioning.
+
+## Included items
+
+See [the documentation](https://typing-extensions.readthedocs.io/en/latest/#) for a
+complete listing of module contents.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/python/typing_extensions/blob/main/CONTRIBUTING.md)
+for how to contribute to `typing_extensions`.
+