svg-metadata.overrides.json

Embed-SESM.py reads svg-metadata.overrides.json and deep-merges each entry's sesm block into the auto-generated metadata for the matching SVG slug (matched by filename stem). It also supports a legacy ai.summary / ai.tags shape, which the tool maps onto llm.summary and asset.tags if the newer fields are absent.

The file is a flat map of asset slug to override record. An _example key documents the expected shape and is stripped before use:

{
  "_example": {
    "slug-or-relative-path": {
      "roles": ["logo", "branding"],
      "sesm": {
        "sesm_version": "0.3.0",
        "asset": {
          "id": "slug-or-relative-path",
          "role": "logo",
          "title": "Display Name",
          "ecosystem": "ecosystem-name",
          "tags": ["tag1", "tag2"]
        },
        "llm": {
          "summary": "Human-readable summary."
        }
      },
      "ai": {
        "summary": "Human-readable summary.",
        "tags": ["tag1", "tag2"]
      }
    }
  }
}

The production overrides file in the SESM standard directory carries one entry per logo asset in svg/. Two representative entries:

{
  "apt-caddy-logo": {
    "roles": ["logo", "branding"],
    "sesm": {
      "sesm_version": "0.3.0",
      "asset": {
        "id": "apt-caddy-logo",
        "role": "logo",
        "title": "Caddy Web Server Logo",
        "ecosystem": "caddy",
        "tags": ["caddy", "web-server", "logo", "branding"]
      },
      "llm": {
        "summary": "Logo representing the Caddy web server in the APTlantis ecosystem."
      }
    },
    "ai": {
      "summary": "Logo representing the Caddy web server in the APTlantis ecosystem.",
      "tags": ["caddy", "web-server", "logo", "branding"]
    }
  },
  "apt-fsharp-logo": {
    "roles": ["logo", "branding"],
    "sesm": {
      "sesm_version": "0.3.0",
      "asset": {
        "id": "apt-fsharp-logo",
        "role": "logo",
        "title": "F# Programming Language Logo",
        "ecosystem": "fsharp",
        "tags": ["fsharp", "dotnet", "programming-language", "logo", "branding"]
      },
      "llm": {
        "summary": "Logo representing the F# programming language in the APTlantis ecosystem."
      }
    },
    "ai": {
      "summary": "Logo representing the F# programming language in the APTlantis ecosystem.",
      "tags": ["fsharp", "dotnet", "programming-language", "logo", "branding"]
    }
  }
}

The full production file currently carries entries for: apt-c-logo, apt-caddy-logo, apt-clojure-logo, apt-coffeescript-logo, apt-cpan-logo, apt-flathub-logo, apt-fortran-logo, apt-fsharp-logo, apt-malbolge-logo, apt-matlab-logo, and apt-node-logo.pngu7 — one per logo in the svg/ example directory (see SVG Examples).