Provenance Stamp
provenance_stampCreates a .provenance.json sidecar for artifacts, recording sha256 checksum, file metadata, source, toolchain, git details, author, tags, and notes offline.
Instructions
Writes a .provenance.json sidecar next to a saved artifact (tox, recipe note, recipe bundle, component bundle). Records the sha256 checksum, file size, mtime, source COMP path, originating tdmcp tool, toolchain versions, best-effort git metadata, author, tags, and freeform notes. Offline — no TD bridge required.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Free-form tags for vault search. | |
| extra | No | Tool-specific extras, e.g. {nodes:7, connections:9}. | |
| notes | No | Short human note to attach to the sidecar. | |
| author | No | Author label. Defaults to TDMCP_AUTHOR env var then os.userInfo().username. | |
| source | No | Where/what produced this artifact. | |
| overwrite | No | Replace an existing sidecar. Set false to refuse if one exists. | |
| include_git | No | Capture git commit/branch/dirty from the artifact's directory (best-effort). | |
| artifact_kind | No | What kind of artifact this is — hint only, not validated. | other |
| artifact_path | Yes | Absolute or vault-resolved path to the file to stamp. |