zyvor-guestkit 1.2.2__tar.gz

zyvor_guestkit-1.2.2/.cargo/config.toml

@@ -0,0 +1,9 @@
+[target.x86_64-pc-windows-gnu]
+linker = "x86_64-w64-mingw32-gcc"
+
+[target.aarch64-apple-darwin]
+# Homebrew on Apple Silicon installs to /opt/homebrew, which isn't on the
+# default linker search path - needed to link libhivex (registry-write
+# feature). No-op on Linux (production target) or x86_64 Mac (Homebrew
+# uses /usr/local, already searched by default).
+rustflags = ["-L", "/opt/homebrew/lib"]

zyvor_guestkit-1.2.2/.dockerignore

@@ -0,0 +1,69 @@
+# Build artifacts
+target/
+**/target/
+crates/*/target/
+*.so
+*.pyc
+*.pyo
+__pycache__/
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Git
+.git/
+.gitignore
+.github/
+
+# Documentation
+*.md
+!README.md
+docs/
+
+# Test files
+*.qcow2
+*.vmdk
+*.vdi
+*.vhdx
+*.raw
+*.img
+*.iso
+vms/
+
+# Python
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+
+# Temporary files
+*.tmp
+*.log
+.cache/
+
+# Docker files (don't need in build context except Dockerfile)
+docker-compose.yml
+.dockerignore
+
+# CI/CD
+.github/
+.claude/
+
+# RPM build
+*.spec
+RPM-BUILD.md
+
+# Integration tests
+integration/
+
+# Scripts
+scripts/
+test_*.sh
+build_python.sh

zyvor_guestkit-1.2.2/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug Report
+about: Report a bug in the open-source repo (not for sales or enterprise quotes)
+title: "[BUG] "
+labels: bug
+---
+
+> **Enterprise / sales / SLAs / VMware exit programs** → [zyvor.dev/contact](https://zyvor.dev/contact?utm_source=github&utm_medium=guestkit) or [sales@zyvor.dev](mailto:sales@zyvor.dev) — do not use this form.
+
+## Bug Description
+
+## To Reproduce
+
+1.
+2.
+3.
+
+## Expected Behavior
+
+## Actual Behavior
+
+## Environment
+
+- guestctl version:
+- OS:
+- Disk format:
+
+## Logs
+
+```text
+(paste relevant output)
+```

zyvor_guestkit-1.2.2/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,23 @@
+blank_issues_enabled: false
+contact_links:
+  - name: "▶ Watch migration demo (video + dashboard)"
+    url: https://zyvor.dev/demo?utm_source=github&utm_medium=guestkit
+    about: Migration video and live dashboard tour at zyvor.dev/demo
+  - name: "🏢 Enterprise, sales & SLAs (Zyvor)"
+    url: https://zyvor.dev/contact?utm_source=github&utm_medium=guestkit
+    about: Production migrations, VMware exit, licensing, and guided demos — not for GitHub Issues
+  - name: "📧 Email sales"
+    url: mailto:sales@zyvor.dev
+    about: sales@zyvor.dev — enterprise quotes and migration programs
+  - name: "ROI calculator"
+    url: https://zyvor.dev/roi?utm_source=github&utm_medium=guestkit
+    about: Estimate savings from VMware exit and platform migration
+  - name: "CE vs Enterprise"
+    url: https://github.com/zyvorai/guestkit/blob/main/docs/ce-vs-enterprise.md
+    about: When to use this GitHub repo vs contact Zyvor for production
+  - name: "💬 Discussions"
+    url: https://github.com/zyvorai/guestkit/discussions
+    about: Community questions and ideas
+  - name: "🔐 Security"
+    url: https://github.com/zyvorai/guestkit/blob/main/SECURITY.md
+    about: Report vulnerabilities privately (not for sales)

zyvor_guestkit-1.2.2/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature Request
+about: Suggest an enhancement for the open-source repo
+title: "[FEATURE] "
+labels: enhancement
+---
+
+> **Enterprise platform features** (dashboard, SLAs, fleet orchestration) → [zyvor.dev/contact](https://zyvor.dev/contact?utm_source=github&utm_medium=guestkit)
+
+## Problem
+
+## Proposed Solution
+
+## Alternatives
+
+## Additional Context

zyvor_guestkit-1.2.2/.github/RELEASE_TEMPLATE.md

@@ -0,0 +1,17 @@
+## Release notes
+
+<!-- Describe changes -->
+
+## Open source
+
+This release is the open-source **GuestKit** toolkit on GitHub.
+
+## Enterprise & production
+
+For VMware exit programs, fleet migrations, SLAs, and the full **HyperSDK Platform** suite ([HyperSDK](https://zyvor.dev/hypersdk) · [hyper2kvm](https://zyvor.dev/hyper2kvm) · GuestKit · [v9s](https://zyvor.dev/v9s) · [PacketWolf](https://zyvor.dev/packetwolf)):
+
+- **Platform:** https://zyvor.dev/?utm_source=github&utm_medium=guestkit
+- **Contact:** https://zyvor.dev/contact?utm_source=github&utm_medium=guestkit
+- **Sales:** sales@zyvor.dev
+
+**Full comparison:** [docs/ce-vs-enterprise.md](docs/ce-vs-enterprise.md)

zyvor_guestkit-1.2.2/.github/actions/rescue-dry-run/action.yml

@@ -0,0 +1,89 @@
+name: 'GuestKit rescue dry-run'
+description: 'Export a reviewable rescue FixPlan from a disk image. Does not mutate the image.'
+author: 'zyvorai'
+
+branding:
+  icon: 'life-buoy'
+  color: 'purple'
+
+inputs:
+  disk:
+    description: 'Path to the disk image.'
+    required: true
+  operation:
+    description: 'Rescue operation (enable-ssh, fix-fstab, enable-rdp, set-hostname, …).'
+    required: true
+  user:
+    description: 'Username when the operation needs one.'
+    required: false
+    default: ''
+  hostname:
+    description: 'Hostname for set-hostname.'
+    required: false
+    default: ''
+  version:
+    description: 'GuestKit release to install. Defaults to latest.'
+    required: false
+    default: 'latest'
+  artifact-name:
+    description: 'Upload artifact name. Empty disables upload.'
+    required: false
+    default: 'guestkit-rescue-plan'
+
+outputs:
+  plan-path:
+    description: 'Path to the exported FixPlan YAML.'
+    value: ${{ steps.run.outputs.plan-path }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Resolve and install GuestKit
+      id: install
+      shell: bash
+      run: |
+        set -euo pipefail
+        VERSION="${{ inputs.version }}"
+        if [[ "${VERSION}" == "latest" ]]; then
+          BODY="$(curl -fsSL https://api.github.com/repos/zyvorai/guestkit/releases/latest)"
+          VERSION="$(printf '%s' "${BODY}" | grep -m1 '"tag_name"' | sed -E 's/.*"v?([^"]+)".*/\1/')"
+        fi
+        VERSION="${VERSION#v}"
+        ASSET="guestkit-${VERSION}-linux-amd64.tar.gz"
+        BASE_URL="https://github.com/zyvorai/guestkit/releases/download/v${VERSION}"
+        WORKDIR="${RUNNER_TEMP}/guestkit-rescue-install"
+        mkdir -p "${WORKDIR}"
+        cd "${WORKDIR}"
+        curl -fsSL -o "${ASSET}" "${BASE_URL}/${ASSET}"
+        tar -xzf "${ASSET}"
+        BIN_PATH="$(find "${WORKDIR}" -mindepth 1 -maxdepth 2 -type f -name guestkit | head -n1)"
+        chmod +x "${BIN_PATH}"
+        echo "GUESTKIT_BIN=${BIN_PATH}" >> "$GITHUB_ENV"
+
+    - name: Export rescue plan (no apply)
+      id: run
+      shell: bash
+      env:
+        GK_DISK: ${{ inputs.disk }}
+        GK_OP: ${{ inputs.operation }}
+        GK_USER: ${{ inputs.user }}
+        GK_HOST: ${{ inputs.hostname }}
+      run: |
+        set -euo pipefail
+        OUT="${RUNNER_TEMP}/guestkit-rescue"
+        mkdir -p "${OUT}"
+        guestkit() { sudo "${GUESTKIT_BIN}" "$@"; }
+        ARGS=(rescue "${GK_DISK}" -o "${GK_OP}" --export-plan "${OUT}/rescue.yaml")
+        [[ -n "${GK_USER}" ]] && ARGS+=(-u "${GK_USER}")
+        [[ -n "${GK_HOST}" ]] && ARGS+=(--hostname "${GK_HOST}")
+        guestkit "${ARGS[@]}"
+        echo "plan-path=${OUT}/rescue.yaml" >> "$GITHUB_OUTPUT"
+        echo "GK_RESCUE_OUT=${OUT}" >> "$GITHUB_ENV"
+
+    - name: Upload rescue plan
+      if: always() && inputs.artifact-name != ''
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ inputs.artifact-name }}
+        path: ${{ env.GK_RESCUE_OUT }}/rescue.yaml
+        if-no-files-found: ignore

zyvor_guestkit-1.2.2/.github/copilot-instructions.md

@@ -0,0 +1,115 @@
+# Copilot instructions for guestkit
+
+Purpose: quick, actionable guidance for AI-assisted coding sessions in this repository.
+
+Build, test, and lint
+- Build (dev): cargo build
+- Build (release): cargo build --release
+- Cross / musl: cargo build --release --target x86_64-unknown-linux-musl
+- Install locally: cargo install --path .
+- Build examples: cargo build --examples
+- Build docs: cargo doc --no-deps --all-features
+
+Rust tests
+- Run all tests: cargo test
+- Run a single test by name (pattern): cargo test <test_name>
+  Example: cargo test test_partition_parsing
+- Run a single test exact name: cargo test -- --test-threads=1 <filter>
+  (Usually: cargo test <fn_name> -- --nocapture)
+- CI runs: cargo test --verbose
+
+Python (PyO3) tests
+- Build the Python extension first: maturin develop --release --features python-bindings
+- Run Python tests: pytest tests/ or pytest integration/tests/test_integration.py::test_version_command
+
+Linting & formatting
+- Formatting check (CI): cargo fmt -- --check
+- Apply formatting: cargo fmt
+- Linting (CI): cargo clippy --all-targets --all-features -- -D warnings
+
+High-level architecture (big picture)
+- Purpose: offline VM disk inspection (qcow2, vmdk, raw) with reporting, TUI, REPL, and optional Python bindings.
+- Layers (top → bottom):
+  1. Applications / CLI / TUI / Python bindings (entrypoints in src/cli/, src/python.rs)
+  2. High-level Rust API (converters, guest detection, pipelines)
+  3. Pure-Rust disk layer (src/disk/): DiskReader, partition parsing, filesystem detection
+  4. Core utilities: error types, retry logic, types
+  5. Optional external tools: qemu-img / qemu-nbd used only for conversion/fallback
+- Key modules to consult:
+  - src/cli/       — commands, profiles, exporters, TUI, interactive shell
+  - src/disk/      — reader, partition, filesystem, loop_device, nbd fallback
+  - src/detectors/ — guest OS detection logic
+  - src/converters — qemu-img wrapper for format conversion
+  - src/python.rs  — PyO3 bindings and Python integration surface
+  - docs/architecture/overview.md — more detailed design notes
+
+Key conventions and repository-specific patterns
+- No C dependencies: core disk parsing is implemented in pure Rust; qemu-img/qemu-nbd are optional external tools used only for conversion or advanced formats.
+- Device strategy: LoopDevice is preferred (fast path for RAW/IMG); NBD (qemu-nbd) used as fallback for QCOW2/VMDK; this strategy is implemented in Guestfs::launch().
+- Cargo features:
+  - default = ["guest-inspect", "journal-native"]
+  - python-bindings (enable PyO3 / maturin)
+  - ai (optional rig-core + reqwest)
+  Build with features where relevant: cargo build --features python-bindings
+- Tests:
+  - Rust unit tests live inline in modules (use cargo test)
+  - Python integration/tests under tests/ and integration/tests/ (use maturin then pytest)
+- CI expectations:
+  - Formatting (rustfmt) and clippy warnings are enforced as errors in CI. Keep changes clean: run cargo fmt and cargo clippy locally before opening PRs.
+  - Examples, docs and release artifacts are built in CI; see .github/workflows/ci.yml for exact steps.
+- Error handling: use the crate Result<T> alias and the central Error enum (thiserror) — follow existing patterns in src/core and modules.
+- Minimal unsafe: unsafe blocks are rare and audited; assume disk byte reads and memmap2 use are the main areas.
+
+Where to look first
+- README.md (quick start & examples)
+- docs/architecture/overview.md (design + module map)
+- src/disk/ and src/detectors/ for the core inspection logic
+- src/cli/ for how CLI commands wire into the API
+
+Notes for Copilot sessions
+- Suggest concrete edits: add tiny, focused changes (tests, docs, clippy fixes). Broad redesigns should be broken into multiple PR-sized steps.
+- When changing behavior touching disk handling, run unit tests and, where applicable, the Python integration tests after rebuilding the Python extension.
+- Respect CI: run cargo fmt and cargo clippy locally with the CI flags to avoid churn.
+
+Reference files
+- .github/workflows/ci.yml — CI steps (formatting, clippy, build, tests, docs)
+- Cargo.toml — features, dev-dependencies and targets
+- docs/architecture/overview.md — expanded architecture
+
+Releasing & publishing
+
+Publishing crate to crates.io
+- Prepare:
+  - Bump version in Cargo.toml and optionally update CHANGELOG.md and release notes.
+  - Ensure repo is clean, all tests pass, and cargo fmt/clippy run without warnings.
+- Verify package contents: cargo package --allow-dirty --no-verify (recommended to run without --allow-dirty on CI)
+- Dry run: cargo publish --dry-run
+- Publish: cargo publish
+  - Requires a crates.io API token configured via `cargo login <TOKEN>` or CARGO_REGISTRY_TOKEN env var.
+- Tag & release: create an annotated git tag and push tags; create a GitHub Release with notes.
+  Commands (example):
+    git tag -s vX.Y.Z -m "guestkit vX.Y.Z" && git push && git push --tags
+    gh release create vX.Y.Z target/x86_64-unknown-linux-gnu/release/guestkit -t "guestkit vX.Y.Z" -n "Release notes"
+
+Publishing Python wheels to PyPI (PyO3)
+- Build and test locally:
+  - maturin build --release --features python-bindings
+  - pip install --force-reinstall target/wheels/guestkit-*.whl && pytest tests/
+- Publish to PyPI: maturin publish -u __token__ -p "$PYPI_API_TOKEN"
+  - Provide PYPI_API_TOKEN via secrets (recommended) or pass credentials interactively.
+  - Alternative: build wheel then upload via twine: twine upload target/wheels/*
+
+GitHub Releases (binaries & artifacts)
+- `.github/workflows/release.yml` already automates this end to end on a tag push: it builds/uploads binary artifacts per target, creates the GitHub Release via `softprops/action-gh-release@v2`, and runs `cargo publish`. Pushing an annotated tag is normally all that's needed.
+- To publish manually instead: download artifacts from CI or build locally for each target, then `gh release create vX.Y.Z path/to/artifact -t "vX.Y.Z" -n "Notes"`.
+
+Release checklist (quick)
+- Run cargo fmt && cargo clippy --all-targets --all-features -- -D warnings
+- cargo test && cargo doc --no-deps
+- cargo package && cargo publish --dry-run
+- Create signed git tag and push
+- Create GitHub Release (attach CI artifacts)
+- For Python: maturin build, test wheel, maturin publish
+
+Automation
+- `.github/workflows/release.yml` is the fully automated tag→release pipeline described above — it already exists, gated to trusted maintainers via repo secrets.

zyvor_guestkit-1.2.2/.github/workflows/agent-release.yml

@@ -0,0 +1,70 @@
+name: Agent Release (manual)
+
+# Agent artifacts are built and attached to GitHub Releases by release.yml on v* tags.
+# Use this workflow only to rebuild VM tools artifacts without cutting a release.
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Attach artifacts to GitHub release v<version> (e.g. 1.0.1); leave empty for CI artifacts only"
+        required: false
+        default: ""
+
+jobs:
+  build-agent-musl:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install toolchain
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y musl-tools genisoimage
+          rustup target add x86_64-unknown-linux-musl
+
+      - name: Build Zeus VM Tools artifacts
+        env:
+          VERSION: ${{ inputs.version != '' && inputs.version || '0.0.0-dev' }}
+        run: bash packaging/vmtools/build-artifacts.sh
+
+      - name: Upload Linux tarball
+        uses: actions/upload-artifact@v4
+        with:
+          name: zyvor-vm-tools-linux-amd64
+          path: |
+            dist/vmtools/linux/zyvor-vm-tools-linux-amd64.tar.gz
+            dist/vmtools/linux/zyvor-vm-tools-linux-amd64.tar.gz.sha256
+
+      - name: Upload DEB
+        uses: actions/upload-artifact@v4
+        with:
+          name: zyvor-vm-tools-deb
+          path: dist/vmtools/linux/zyvor-vm-tools_*_amd64.deb
+
+      - name: Upload ISO
+        uses: actions/upload-artifact@v4
+        with:
+          name: zyvor-vm-tools-iso
+          path: dist/vmtools/zyvor-vm-tools.iso
+          if-no-files-found: ignore
+
+      - name: Upload to GitHub Release
+        if: inputs.version != ''
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ inputs.version }}
+        run: |
+          set -euo pipefail
+          TAG="v${VERSION}"
+          FILES=(
+            dist/vmtools/linux/zyvor-vm-tools-linux-amd64.tar.gz
+            dist/vmtools/linux/zyvor-vm-tools-linux-amd64.tar.gz.sha256
+            "dist/vmtools/linux/zyvor-vm-tools_${VERSION}_amd64.deb"
+          )
+          if [[ -f dist/vmtools/zyvor-vm-tools.iso ]]; then
+            FILES+=(dist/vmtools/zyvor-vm-tools.iso)
+          fi
+          gh release upload "${TAG}" "${FILES[@]}" --clobber

zyvor_guestkit-1.2.2/.github/workflows/build-wheels.yml

@@ -0,0 +1,143 @@
+name: Build and Publish Python Wheels
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: 'Publish to PyPI'
+        required: false
+        default: 'false'
+
+permissions:
+  contents: read
+
+jobs:
+  linux:
+    name: Build wheels for Linux ${{ matrix.target }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # aarch64 manylinux cross image fails in CI; macOS needs Linux-only libc gated
+        target: [x86_64]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist --features python-bindings
+          sccache: 'true'
+          manylinux: auto
+          before-script-linux: |
+            yum install -y openssl-devel systemd-devel
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: dist
+          retention-days: 7
+
+  sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+          retention-days: 7
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [linux, sdist]
+    # Only publish on tag pushes or manual workflow with publish=true
+    if: |
+      startsWith(github.ref, 'refs/tags/') ||
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.publish == 'true')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/zyvor-guestkit
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+
+      - name: List distributions
+        run: ls -lh dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true
+          verbose: true
+
+  test-install:
+    name: Test installation
+    runs-on: ${{ matrix.os }}
+    needs: [linux]
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ['3.8', '3.11', '3.12']
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install from wheel
+        run: |
+          pip install --no-index --find-links dist --only-binary=:all: zyvor-guestkit
+
+      - name: Test import
+        run: |
+          python -c "from guestkit import Guestfs; print('✓ Guestfs imported successfully')"
+          python -c "from guestkit import DiskConverter; print('✓ DiskConverter imported successfully')"
+
+      - name: Test assurance APIs (v1.1.0+)
+        run: |
+          python -c "
+          import guestkit
+          for fn in ('run_doctor','run_boot_inspect','run_migrate_plan','run_repair_plan','run_migrate_repair'):
+              assert hasattr(guestkit, fn), fn
+          print('✓ assurance APIs present')
+          "
+
+      - name: Test context manager
+        run: |
+          python -c "from guestkit import Guestfs; g = Guestfs(); print('✓ Guestfs instantiated')"
+
+      - name: Show version
+        run: |
+          python -c "import guestkit; print('guestkit version:', getattr(guestkit, '__version__', 'unknown'))"