RFC 036: Governed plan bundle

[dannymeijer]

Use this issue to track InQL RFC 036, proposed in PR #60 at docs/rfcs/036_governed_plan_bundle.md.

Area

• Specification (RFCs)
• Documentation

Summary

RFC 036 defines a governed plan bundle: a portable local package of a plan and its evidence artifacts.

Motivation

InQL needs a reviewable and shareable evidence package for CI, agents, governance review, and downstream tools. A bundle should collect plan and evidence data without relying on a hosted service or loose untracked files.

Proposal sketch

• Bundle plan snapshots, semantic targets, lineage, metadata, observations, coverage, profiles, and version information.
• Preserve evidence provenance and lossiness information where applicable.
• Keep the bundle local-first and suitable for later export bridges.
• Avoid making the bundle a replacement for core planning semantics.

Alternatives considered

• Emit loose files with no contract.
• Export only Substrait.
• Generate only a human-readable report.

Impact / compatibility

This is additive. Existing execution and planning should continue unchanged while future workflows gain a stable evidence artifact.

Implementation notes (optional)

Review PR #60 for the draft. This work should collect evidence artifacts without becoming the source of planning semantics.

Checklist

• I checked for an existing RFC or issue covering this.
• I can describe how this impacts existing code and how to migrate (if needed).