akcli

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/tipoLi5890/akcli/schemas/draw-result.schema.json",
  "title": "AkcliDrawResult",
  "description": "akcli plan/draw --json: per-op results + connectivity findings + the before/after net diff. 'applied' is true only when --apply was given AND every op succeeded AND connectivity verified; a dry run reports the same net_diff the real apply would produce. Consumers must tolerate additive growth.",
  "type": "object",
  "required": ["schema_version", "applied", "status", "ops", "connectivity"],
  "properties": {
    "schema_version": {"const": "1.0"},
    "applied": {"type": "boolean"},
    "status": {"type": "string", "enum": ["dry-run", "applied", "refused"]},
    "ops": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["op_index", "status"],
        "properties": {
          "op_index": {"type": "integer", "minimum": 0},
          "op": {"type": ["string", "null"]},
          "status": {"type": "string", "enum": ["ok", "error"]},
          "created_uuids": {"type": "array", "items": {"type": "string"}},
          "error_code": {"type": ["string", "null"]},
          "message": {"type": "string"},
          "remediation": {"type": ["string", "null"]}
        }
      }
    },
    "connectivity": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["code", "severity", "message"],
        "properties": {
          "code": {"type": "string"},
          "severity": {
            "type": "string",
            "enum": ["info", "note", "warning", "error", "critical"]
          },
          "message": {"type": "string"}
        }
      }
    },
    "net_diff": {
      "type": ["object", "null"],
      "required": ["equivalent", "risk", "lines"],
      "properties": {
        "equivalent": {"type": "boolean"},
        "risk": {"type": "boolean"},
        "lines": {"type": "array", "items": {"type": "string"}}
      }
    },
    "preview": {
      "type": ["object", "null"],
      "description": "Present when --render OUT.svg was given and the dry-apply succeeded: the WOULD-BE sheet rendered to SVG before anything touches the target. null when not requested or when the (non-fatal) render failed.",
      "required": ["path", "bytes"],
      "properties": {
        "path": {"type": "string"},
        "bytes": {"type": "integer", "minimum": 0}
      }
    },
    "project_root": {
      "type": "string",
      "description": "Present ONLY when the net gate evaluated a sheet TREE (the target is a child of a hierarchy): posix path of the resolved root schematic. Absent — not null — on the flat single-file path."
    },
    "evaluation_scope": {
      "const": "tree",
      "description": "Present alongside project_root: the net diff and preview were computed over the whole sheet tree, not the target file alone."
    },
    "run_id": {
      "type": "string",
      "description": "Present ONLY on a multi-sheet (envelope 'sheets'/per-op 'sheet') run: the transaction id — recorded in the journal, named by `akcli undo --run`. Absent on the single-file path."
    },
    "files": {
      "type": "array",
      "description": "Present alongside run_id: one entry per file the transaction loaded. 'written' is true only after a committed --apply.",
      "items": {
        "type": "object",
        "required": ["file", "dirty", "written"],
        "properties": {
          "file": {"type": "string"},
          "dirty": {"type": "boolean"},
          "written": {"type": "boolean"},
          "sha_before": {"type": "string"},
          "sha_after": {"type": "string"}
        }
      }
    }
  }
}