kova-parallels-smoke

Run deterministic Parallels guest smoke lanes and interpret failures from structured phase logs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/chiragborse1/KovaLab --skill kova-parallels-smoke
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kova-parallels-smoke
Source: https://github.com/chiragborse1/KovaLab/tree/main/.agents/skills/kova-parallels-smoke
Command: npx skills add https://github.com/chiragborse1/KovaLab --skill kova-parallels-smoke

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you reliably run and interpret Parallels guest smoke workflows for Kova installation, onboarding, gateway health, and upgrade regressions, so failures can be diagnosed quickly from structured phase logs rather than guesswork.

Core Features & Use Cases

  • End-to-end Parallels Smoke Coverage: Runs fresh and upgrade-oriented lanes across macOS, Linux, and Windows guest workflows, including gateway verification and post-update agent turn checks.
  • Deterministic, Guardrailed Execution: Enforces snapshot/baseline selection rules, VM concurrency constraints, and strict per-phase timeouts to prevent stalled installs or snapshot operations from consuming the whole test window.
  • Structured Debug Output: Captures per-lane logs under /tmp/kova-parallels-* and includes guidance for when to inspect specific phase logs (install-main, install-latest, install-baseline, update-dev, etc.) based on observed timeouts.

Quick Start

Run the Parallels smoke harness for your target platform and mode, such as a macOS fresh baseline run, by invoking the repository’s Parallels skill entrypoint that corresponds to your desired guest family and lane type.

Frequently Asked Questions about kova-parallels-smoke

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Parallels smoke testing for Kova guest installations and upgrades?

Parallels smoke testing for Kova validates guest workflows by running deterministic install, onboarding, gateway health, and upgrade lanes across macOS, Windows, and Linux. It enforces snapshot selection rules and per-phase timeouts to prevent stalled installs from consuming the test window.

What is the best way to debug Parallels VM orchestration failures during Kova onboarding?

Debugging Parallels VM orchestration failures requires inspecting structured phase logs stored under /tmp/kova-parallels-*. You examine specific lane logs such as install-main, install-latest, or update-dev based on observed timeouts to pinpoint failures before reruns or ordering changes.

Can I use this approach to verify gateway RPC readiness across different guest operating systems?

Yes, gateway RPC readiness checks support macOS, Windows, and Linux guest scenarios. The process prefers deep RPC checks to probe gateway status, handling Parallels transport quirks while validating post-update agent turns across fresh and upgrade-oriented lanes.

Does smoke testing for upgrade regressions support both fresh snapshot baselines and same-guest updater verification?

Upgrade regression smoke testing supports both fresh snapshot baselines and same-guest updater verification. It runs distinct lanes for each mode across guest families, applying strict snapshot selection rules and host-side timeout guardrails per lane to ensure deterministic execution.

Why does my Parallels smoke test window get consumed by stalled snapshot operations?

Stalled snapshot operations consume the test window when strict per-phase timeouts and VM concurrency constraints are not enforced. Applying host-side timeout guardrails per lane and per phase prevents stalled installs or snapshot operations from blocking the entire test run.

Do I need JSON summaries to interpret Kova Parallels smoke test results?

JSON summaries are required to interpret Kova Parallels smoke test results. They provide structured outcome overviews alongside per-lane logs, enabling quick identification of which install, onboarding, gateway, or upgrade lanes failed before detailed phase log diagnosis from /tmp/kova-parallels-*.