Metadata-Version: 2.4
Name: vinyasar
Version: 0.4.1
Summary: Policy-driven, evidence-bound self-healing supervision and mutation engine (unified Vinyasar + Yasarda).
Keywords: automation,self-healing,agents,yasarda,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
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
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: jsonschema<5,>=4.23
Provides-Extra: yaml
Requires-Dist: PyYAML<7,>=6.0.2; extra == "yaml"
Provides-Extra: mcp
Provides-Extra: dev
Requires-Dist: pytest<10,>=8; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"

# Vinyasar: Policy-Driven Self-Healing Supervision for Yasarda

Policy-driven, evidence-bound self-healing supervision and mutation engine.

## Installation

```sh
pip install vinyasar
# with optional YAML profile support:
pip install "vinyasar[yaml]"
```

> **Note on Package Overlap**: `vinyasar` 0.4.1 embeds a bundled `yasarda` namespace reporting version 0.4.0. Users do **not** need to install both packages.

## Public Feature Coverage

Vinyasar provides four primary console scripts:
- `vinyasar`: The primary self-healing controller CLI.
- `vinyasar-mcp`: The MCP server for Vinyasar.
- `yasarda`: The embedded Yasarda engine CLI for low-level structural mutation.
- `yasarda-mcp`: The MCP server for Yasarda.

It also provides two subcommands under `vinyasar` for configuration hygiene and host verification:
- `vinyasar schema`: Outputs the JSON schema for validation of `vinyasar.json`/`vinyasar.yaml` profiles.
- `vinyasar doctor`: Verifies the health and presence of the required environment and evaluator constraints.

### Basic Example

```bash
# Validate your profile against the schema
vinyasar schema > profile.schema.json

# Check environment constraints
vinyasar doctor

# Run self-healing supervision in a target repository
vinyasar run /path/to/repo --profile vinyasar.json
```

## Architecture

Vinyasar acts as an **externally scheduled, trigger-driven reconciler**. Schedule expressions (such as crons) are owned by external schedulers (e.g., `launchd`, `systemd`, or CI pipelines). When invoked, Vinyasar operates as a bounded one-shot process to inspect the target repository, consult the Yasarda engine, execute allowed playbooks, and exit, leaving behind a cryptographic-like ledger of actions taken.

## Evaluator Prerequisite

For optional policy braking and advisory evaluations during operation, Vinyasar delegates to the `jev` evaluator. If these features are utilized, it requires **`jev >=0.6.2,<0.7.0`** to be available on the host `PATH`.
