Provenance Stamp
provenance_stampCreates a .provenance.json sidecar for saved artifacts, recording sha256 checksums, file metadata, source paths, and toolchain versions to enable verifiable provenance and audit trails.
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"artifact_path": "<artifact_path>"
},
"name": "provenance_stamp"
}
}Input 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. |