{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "EditOutput",
"description": "NDJSON output for a surgical edit operation.",
"type": "object",
"properties": {
"type": {
"description": "Event type discriminator.",
"type": "string"
},
"path": {
"description": "Path of the edited file.",
"type": "string"
},
"edits": {
"description": "Number of edit operations applied.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"mode": {
"description": "Edit mode used (e.g. `after_line`, `range`, `old_new`, `exact`).",
"type": "string"
},
"bytes_before": {
"description": "File size in bytes before editing.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"bytes_after": {
"description": "File size in bytes after editing.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"checksum_before": {
"description": "BLAKE3 checksum before editing.",
"type": "string"
},
"checksum_after": {
"description": "BLAKE3 checksum after editing.",
"type": "string"
},
"lines_before": {
"description": "Line count before editing.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"lines_after": {
"description": "Line count after editing.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"elapsed_ms": {
"description": "Operation duration in milliseconds.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"fuzzy": {
"description": "Whether fuzzy matching was used (only present in --old/--new mode).",
"type": [
"boolean",
"null"
]
},
"strategy": {
"description": "Fuzzy strategy that succeeded (only present when fuzzy=true).",
"type": [
"string",
"null"
]
},
"strategies_tried": {
"description": "Number of strategies tried before success (only present in --old/--new mode).",
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0
},
"similarity": {
"description": "Similarity score of the fuzzy match, 0.0-1.0 (only present for `block_anchor` strategy).",
"type": [
"number",
"null"
],
"format": "double"
},
"diff_preview": {
"description": "Unified diff preview showing what the fuzzy match changed (truncated to 500 chars).",
"type": [
"string",
"null"
]
},
"pairs_total": {
"description": "Total number of `--old`/`--new` pairs requested (multi-pair mode only).",
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0
},
"pair_results": {
"description": "Per-pair match results (multi-pair mode only) — the per-item ground truth.",
"type": [
"array",
"null"
],
"items": {
"$ref": "#/$defs/PairResult"
}
},
"mtime_preserved": {
"description": "Whether the original modification time was preserved (true) or updated to now (false).\nCritical for build systems: false ensures cargo/make/cmake detect the change.",
"type": [
"boolean",
"null"
]
},
"match_count": {
"description": "Number of occurrences replaced in old/new mode (1 unless `--replace-all`).",
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0
},
"indent_adjusted": {
"description": "True when fuzzy indent delta realigned the replacement text.",
"type": [
"boolean",
"null"
]
},
"write_strategy": {
"description": "Write strategy the atomic layer used: `rename`, `inplace` or `copyback`.\n\nA target with more than one hard link is written in place so the other\nlinks keep pointing at the same inode, and the event says which ran.",
"type": "string"
},
"backup_skipped": {
"description": "Why the requested backup was skipped, when the directory refused it.",
"type": "string"
},
"risk_assessment": {
"description": "Local diagnostic for a payload that looks destructive (B-013).",
"anyOf": [
{
"$ref": "#/$defs/WriteRiskAssessment"
},
{
"type": "null"
}
]
},
"ok": {
"description": "Outcome of the run, stamped by the writer",
"type": "boolean"
},
"code": {
"description": "Machine error code, present when ok is false",
"type": "string"
},
"exit": {
"description": "Process exit status, present when ok is false",
"type": "integer",
"minimum": 0
},
"target_resolved": {
"description": "Absolute targets the run resolved, in invocation order, and never a joined string, so a path holding `,` stays readable; a run with one target publishes a one-item array, so the shape never depends on the count",
"type": "array",
"items": {
"type": "string"
}
},
"target_source": {
"description": "Where the target came from: named in the invocation line, inherited from the workspace slot, or the standard-input stream",
"type": "string",
"enum": [
"argv",
"workspace",
"stdin"
]
},
"workspace_source": {
"description": "Where the workspace root came from: the `--workspace` flag or the process working directory",
"type": "string",
"enum": [
"argv",
"cwd"
]
},
"records_suppressed": {
"description": "Records the writer dropped before the terminal event: `--filter` rejections, `--select` projections that emptied the record, dedupe duplicates and `--limit` cuts. It counts records, never files, so it does not compare with `files_matched`: one file can contribute several records",
"type": "integer",
"minimum": 0
},
"files_budget_dropped": {
"description": "Entries the `--limit` budget dropped, in the unit the verb produces: files for walking verbs, records for streaming ones; a floor, because workers may stop before producing the rest",
"type": "integer",
"minimum": 0
},
"files_planned": {
"description": "Files the run would have modified in `--dry-run` or `--preview`; absent from a run that really wrote",
"type": "integer",
"minimum": 0
},
"truncated": {
"description": "The record itself was cut by `--truncate-content` or `--max-output-bytes`, so the fields are shorter than the source",
"type": "boolean"
},
"truncated_records": {
"description": "Records the writer cut this run, counted once per record",
"type": "integer",
"minimum": 0
}
},
"required": [
"type",
"path",
"edits",
"mode",
"bytes_before",
"bytes_after",
"checksum_before",
"checksum_after",
"lines_before",
"lines_after",
"elapsed_ms",
"write_strategy"
],
"$defs": {
"PairResult": {
"description": "Outcome of matching a single `--old`/`--new` pair in multi-pair edit mode.\n\nEmitted in `pair_results` on both success and error envelopes so agents\ncan verify each pair objectively without re-running the edit (G117).\nIn the default all-or-nothing mode, pairs after the first failure are\nnever attempted and are absent from the array.",
"type": "object",
"properties": {
"index": {
"description": "1-based position of the pair in the `--old`/`--new` invocation order.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"matched": {
"description": "Whether the pair matched and was applied to the content.",
"type": "boolean"
},
"strategy": {
"description": "Matching strategy that succeeded (e.g. `exact`, `whitespace_normalized`).",
"type": [
"string",
"null"
]
},
"similarity": {
"description": "Similarity score of the fuzzy match, 0.0-1.0 (block-anchor and context-aware only).",
"type": [
"number",
"null"
],
"format": "double"
},
"source": {
"description": "Source of the match/replacement content: `\"arg\"` or `\"file\"`.",
"type": [
"string",
"null"
]
}
},
"required": [
"index",
"matched"
]
},
"WriteRiskAssessment": {
"description": "GAP-2026-011 L1/L6: Local diagnostics describing why a write was classified\nas risky (G-031: not product telemetry). Emitted in `WriteOutput.risk_assessment`\nwhen the size delta exceeds the user-configured `--risk-threshold`.",
"type": "object",
"properties": {
"original_bytes": {
"description": "File size before the write.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"new_bytes": {
"description": "New file size after the write.",
"type": "integer",
"format": "uint64",
"minimum": 0
},
"size_delta_pct": {
"description": "|new - original| / original * 100.",
"type": "integer",
"format": "uint32",
"minimum": 0
},
"risk_level": {
"description": "\"low\" (<70%) | \"medium\" (70-89%) | \"high\" (>=90%).",
"type": "string"
},
"guard_triggered": {
"description": "Which guard triggered the assessment (always \"size\" for L1).",
"type": "string"
}
},
"required": [
"original_bytes",
"new_bytes",
"size_delta_pct",
"risk_level",
"guard_triggered"
]
}
}
}