mg-shell 0.1.0__tar.gz

mg_shell-0.1.0/.env.example

@@ -0,0 +1,37 @@
+# Mindgard Shell — default environment variables
+# Copy this file to ~/.mindgard/.env (or ./.env) and fill in your values.
+# Variables are only set if not already present in the environment.
+
+# ── LLM API Keys ─────────────────────────────────────────────────
+# Used by the copilot, ask, macro writer, and other LLM-powered features.
+# You can also set these via 'model keys set <provider> <key>' inside the shell.
+
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+GOOGLE_API_KEY=
+
+# ── Langfuse — workflow integrations ─────────────────────────────
+# Used by mindgard-cli workflows (e.g. auto_vuln_hunter).
+
+LANGFUSE_SECRET_KEY=
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_HOST=https://cloud.langfuse.com
+
+# ── Langfuse — shell agentic telemetry ──────────────────────────
+# Separate keys for tracing copilot, ask, plan, macro, MCP, and NL
+# query agents.  Leave blank to disable telemetry (opt-in).
+
+MINDGARD_SHELL_LANGFUSE_SECRET_KEY=
+MINDGARD_SHELL_LANGFUSE_PUBLIC_KEY=
+MINDGARD_SHELL_LANGFUSE_HOST=https://cloud.langfuse.com
+
+# ── Mindgard API ─────────────────────────────────────────────────
+# Override the default API base URL (rarely needed).
+
+# MINDGARD_API_BASE=https://api.sandbox.mindgard.ai/api/v1
+
+# ── Local LLM ────────────────────────────────────────────────────
+# If you use Ollama, LM Studio, or another local provider.
+
+# OLLAMA_HOST=http://localhost:11434
+# LM_STUDIO_HOST=http://localhost:1234

mg_shell-0.1.0/.flake8

@@ -0,0 +1,13 @@
+[flake8]
+max-line-length = 120
+extend-ignore =
+    # E203: whitespace before ':' (conflicts with black)
+    E203,
+    # W503: line break before binary operator (conflicts with black)
+    W503,
+    # E501: line too long (black handles this)
+    E501,
+per-file-ignores =
+    # F401: imported but unused (re-export shims, __init__ files)
+    mindgard_shell/__init__.py:F401
+    tests/*:F811

mg_shell-0.1.0/.github/workflows/auto-release.yml

@@ -0,0 +1,196 @@
+name: Auto Release
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  detect:
+    runs-on: ubuntu-latest
+    outputs:
+      shell_version: ${{ steps.check.outputs.shell_version }}
+      cloud_version: ${{ steps.check.outputs.cloud_version }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Detect changed packages
+        id: check
+        run: |
+          check_package() {
+            local pkg="$1"; shift
+            local latest_tag
+            latest_tag=$(git tag -l "${pkg}/v*" --sort=-v:refname | head -1)
+
+            if [ -z "$latest_tag" ]; then
+              echo "${pkg}: no prior tag → v0.1.0"
+              echo "${pkg}_version=0.1.0" >> "$GITHUB_OUTPUT"
+              return
+            fi
+
+            # Check if any of the listed paths changed since last tag
+            if git diff --quiet "${latest_tag}"..HEAD -- "$@"; then
+              echo "${pkg}: no changes since ${latest_tag}"
+              return
+            fi
+
+            local version="${latest_tag#${pkg}/v}"
+            local major minor patch
+            IFS='.' read -r major minor patch <<< "$version"
+            patch=$((patch + 1))
+            local next="${major}.${minor}.${patch}"
+            echo "${pkg}: changes since ${latest_tag} → v${next}"
+            echo "${pkg}_version=${next}" >> "$GITHUB_OUTPUT"
+          }
+
+          check_package "shell" mindgard_shell/ pyproject.toml
+          check_package "cloud" mindgard-cloud/
+
+  release-shell:
+    needs: detect
+    if: needs.detect.outputs.shell_version
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+
+      - name: Bump version
+        run: |
+          VERSION="${{ needs.detect.outputs.shell_version }}"
+          sed -i "s/^version = \".*\"/version = \"${VERSION}\"/" pyproject.toml
+          sed -i "s/__version__ = \".*\"/__version__ = \"${VERSION}\"/" mindgard_shell/__init__.py
+
+      - name: Install and test
+        run: task install-dev && task test-shell
+
+      - name: Build
+        run: task build-shell
+
+      - name: Publish to TestPyPI
+        run: task test-publish-shell
+
+  publish-shell:
+    needs: [detect, release-shell]
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+
+      - name: Bump version
+        run: |
+          VERSION="${{ needs.detect.outputs.shell_version }}"
+          sed -i "s/^version = \".*\"/version = \"${VERSION}\"/" pyproject.toml
+          sed -i "s/__version__ = \".*\"/__version__ = \"${VERSION}\"/" mindgard_shell/__init__.py
+
+      - name: Build
+        run: task build-shell
+
+      - name: Publish to PyPI
+        run: task publish-shell
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          VERSION="${{ needs.detect.outputs.shell_version }}"
+          TAG="shell/v${VERSION}"
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -m "chore(shell): bump version to ${VERSION} [skip ci]" || true
+          git push origin main || true
+
+          gh release create "$TAG" dist/shell/* \
+            --target main \
+            --title "mg-shell v${VERSION}" \
+            --generate-notes
+
+  release-cloud:
+    needs: [detect, publish-shell]
+    if: needs.detect.outputs.cloud_version
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+
+      - name: Bump version
+        run: |
+          VERSION="${{ needs.detect.outputs.cloud_version }}"
+          sed -i "s/^version = \".*\"/version = \"${VERSION}\"/" mindgard-cloud/pyproject.toml
+          sed -i "s/VERSION: str = \".*\"/VERSION: str = \"${VERSION}\"/" mindgard-cloud/mindgard_cloud/lib/constants.py
+
+      - name: Install and test
+        run: task install-dev && task test-cloud
+
+      - name: Build
+        run: task build-cloud
+
+      - name: Publish to TestPyPI
+        run: task test-publish-cloud
+
+  publish-cloud:
+    needs: [detect, release-cloud]
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+
+      - name: Bump version
+        run: |
+          VERSION="${{ needs.detect.outputs.cloud_version }}"
+          sed -i "s/^version = \".*\"/version = \"${VERSION}\"/" mindgard-cloud/pyproject.toml
+          sed -i "s/VERSION: str = \".*\"/VERSION: str = \"${VERSION}\"/" mindgard-cloud/mindgard_cloud/lib/constants.py
+
+      - name: Build
+        run: task build-cloud
+
+      - name: Publish to PyPI
+        run: task publish-cloud
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          VERSION="${{ needs.detect.outputs.cloud_version }}"
+          TAG="cloud/v${VERSION}"
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -m "chore(cloud): bump version to ${VERSION} [skip ci]" || true
+          git push origin main || true
+
+          gh release create "$TAG" dist/mindgard-cloud/* \
+            --target main \
+            --title "mg-cloud v${VERSION}" \
+            --generate-notes

mg_shell-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish Plugin
+
+on:
+  workflow_dispatch:
+    inputs:
+      plugin:
+        description: 'Plugin directory to publish (e.g., mindgard-cloud)'
+        required: true
+        type: string
+      version:
+        description: 'Version tag (e.g., v0.2.0)'
+        required: true
+        type: string
+
+jobs:
+  publish:
+    name: Build and publish ${{ inputs.plugin }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+
+      - name: Install and test
+        run: task install-dev && task test-shell
+
+      - name: Build plugin
+        run: task build-plugin PLUGIN_DIR=${{ inputs.plugin }}
+
+      - name: Create release and upload .whl
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ inputs.plugin }}/${{ inputs.version }}
+          name: "${{ inputs.plugin }} ${{ inputs.version }}"
+          files: dist/${{ inputs.plugin }}/*
+          draft: false

mg_shell-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,71 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+
+      - name: Install dependencies
+        run: task install-dev
+
+      - name: Run tests
+        run: task test-shell
+
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
+
+      - name: Extract changelog for this version
+        id: changelog
+        run: |
+          # Extract the section for this version from CHANGELOG.md
+          .venv/bin/python -c "
+          import re, sys
+          version = '${{ steps.version.outputs.version }}'
+          content = open('CHANGELOG.md').read()
+          # Match from ## [version] to the next ## [ or end of file
+          pattern = rf'## \[{re.escape(version)}\].*?\n(.*?)(?=\n## \[|\Z)'
+          match = re.search(pattern, content, re.DOTALL)
+          if match:
+              notes = match.group(1).strip()
+              # Write to file for the release body
+              with open('release_notes.md', 'w') as f:
+                  f.write(notes)
+              print(f'Extracted {len(notes)} chars of release notes')
+          else:
+              with open('release_notes.md', 'w') as f:
+                  f.write(f'Release v{version}')
+              print('No changelog entry found, using default')
+          "
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: "mindgard-shell v${{ steps.version.outputs.version }}"
+          body_path: release_notes.md
+          draft: false
+          prerelease: ${{ contains(steps.version.outputs.version, '-') }}
+
+      - name: Build package
+        run: uv pip install build && .venv/bin/python -m build
+
+      - name: Upload artifacts to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*

mg_shell-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,50 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, "feat/**"]
+  pull_request:
+    branches: [main]
+
+jobs:
+  shell-only:
+    name: Shell (no cloud plugin)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+      - name: Install deps
+        run: task install-dev
+      - name: Run shell tests
+        run: task test-shell
+
+  shell-with-cloud:
+    name: Shell + Cloud plugin
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+      - name: Install deps
+        run: task install-dev && task install-cloud
+      - name: Run shell tests
+        run: task test-shell
+
+  cloud-plugin:
+    name: Cloud plugin tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+      - name: Install deps
+        run: task install-dev && task install-cloud
+      - name: Run cloud tests
+        run: task test-cloud

mg_shell-0.1.0/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+.anamorpher-venv/
+.chepy-venv/
+
+# Embed batch output
+embed-batch-*/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# MkDocs
+site/
+
+# Exported data files
+mindgard-*.json
+
+# Environment (secrets)
+.env
+
+# OS
+.DS_Store
+Thumbs.db
+trace.jsonl
+mindgard-profile.mgprofile
+.chepy-venv/pyvenv.cfg
+.notes.md
+
+# Superpowers (AI planning artifacts — never commit)
+docs/superpowers/