Metadata-Version: 2.4
Name: spec-kitty-runtime
Version: 0.2.0a0
Summary: Canonical mission runtime for deterministic next-step planning
Author: Spec Kitty Contributors
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pydantic<3.0,>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: jsonschema>=4.0
Requires-Dist: spec-kitty-events==2.3.1
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"

# spec-kitty-runtime

Canonical mission runtime for Spec Kitty.

## Scope (V1)

1. YAML mission template loading.
2. Deterministic mission discovery with precedence tiers.
3. Deterministic step planner and mission `next()` execution loop.
4. Prompt rendering for agent runtimes.

## Public API

1. `load_mission_template(path_or_key, context=None)`
2. `discover_missions(context)`
3. `start_mission_run(template_key, inputs, policy_snapshot, context=None, run_store=None)`
4. `next_step(run_ref, agent_id, result="success", policy_snapshot=None, actor_context=None, context=None)`
5. `render_prompt(decision, format="markdown")`

## Mission Pack Layout (YAML-only)

```text
mission-pack.yaml
missions/<mission_key>/mission.yaml
missions/<mission_key>/templates/*.md
missions/<mission_key>/steps/*.yaml  # optional
```

