{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://bare-os.local/schemas/bare-os-syscalls.schema.json",
  "title": "Bare OS /proc/bare_os/syscalls.json",
  "type": "object",
  "required": ["schemaVersion", "ops"],
  "properties": {
    "schemaVersion": { "type": "integer", "const": 11 },
    "ctxApiVersion": { "type": "string" },
    "posixProfile": {
      "type": "object",
      "properties": {
        "id": { "type": "string" },
        "version": { "type": "string" },
        "utilitiesIndexPath": {
          "type": "string",
          "description": "VFS path to sparse POSIX utility coverage JSON (see posix-utilities.schema.json)"
        }
      }
    },
    "ops": {
      "type": "array",
      "items": { "type": "string" }
    },
    "opsDetail": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["name", "category", "stability"],
        "properties": {
          "name": { "type": "string" },
          "category": {
            "type": "string",
            "enum": ["fs", "proc", "ipc", "signal", "vfs_meta"]
          },
          "stability": { "type": "string", "enum": ["stable", "experimental"] },
          "posixAlignment": {
            "type": "string",
            "enum": ["supported", "simulated", "partial", "ENOTSUP"]
          },
          "mapsTo": {
            "type": "array",
            "items": { "type": "string" }
          },
          "errnoHint": { "type": "string" },
          "susv4Refs": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Stable Issue-7 / XSH trace tokens for audits"
          }
        }
      }
    },
    "posixXsh": {
      "type": "object",
      "description": "POSIX.1 XSH logical names merged into opsDetail",
      "properties": {
        "schema": { "type": "integer" },
        "note": { "type": "string" },
        "namesCsv": { "type": "string" }
      }
    },
    "socketMsgSurface": {
      "type": "object",
      "description": "sendmsg/recvmsg metadata (defaults ENOTSUP; bridge uses recv/recvfrom buffers only); schema 5 documents SOCK_STREAM logical SCM_RIGHTS parity with SOCK_DGRAM",
      "properties": {
        "schema": { "type": "integer" },
        "ancillaryControl": {
          "type": "object",
          "properties": {
            "supported": { "type": "boolean" },
            "errno": { "type": "string" },
            "rejectKeys": {
              "type": "array",
              "items": { "type": "string" }
            },
            "note": { "type": "string" }
          }
        },
        "sendmsg": { "type": "object" },
        "recvmsg": { "type": "object" }
      }
    },
    "errnoHints": {
      "type": "object",
      "additionalProperties": { "type": "integer" }
    },
    "fdModel": {
      "type": "object",
      "description": "Logical FD table contract (guest); see process_table.json",
      "properties": {
        "schema": { "type": "integer" },
        "note": { "type": "string" },
        "stdio": { "type": "array", "items": { "type": "integer" } },
        "register": { "type": "string" },
        "processTablePath": { "type": "string" },
        "processTableSchema": { "type": "integer" }
      }
    },
    "signalModel": {
      "type": "object",
      "description": "Synthetic signal names for ctx.bareOsSendSignal",
      "properties": {
        "schema": { "type": "integer" },
        "note": { "type": "string" },
        "names": {
          "type": "array",
          "items": { "type": "string" }
        }
      }
    },
    "caps": { "type": "object" },
    "atMs": { "type": "integer" }
  }
}