create_envelope
Create a signed Git commit envelope with Ed25519 provenance metadata. Records commit producer, signing tool, and optional agent scope for auditability.
Instructions
Create a signed Git commit envelope with Ed25519 provenance metadata.
Records who produced a commit (human, agent, or CI), which tool signed it,
and optional bounded agent scope. Use after staging changes and before or
after ``git commit``. Side effects: may write ``.matrixscroll/envelopes/<sha>.json``
when ``save`` is true. Returns ``{ok, sha, envelope, path}`` on success.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| save | No | When true (default), persist the envelope under .matrixscroll/envelopes/. | |
| sign | No | When true (default), Ed25519-sign the envelope with the active key store. | |
| tool | No | Producing tool name recorded in provenance, e.g. cursor or claude-code. | |
| workspace | No | Absolute or relative path to the Git repository root. Leave empty to auto-detect from the current working directory. | |
| actor_type | No | Provenance actor label recorded in the envelope, e.g. agent, human, or ci. | |
| commit_sha | No | Existing commit to envelope (full or short SHA). Empty uses the staged commit or HEAD depending on hook context. | |
| agent_scope | No | Optional path or glob limiting what an agent commit claims to touch. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||