# lol.mlf.package

> Published by [mlf.lol](https://lexicon.garden/identity/did:plc:xl243nyru4tbbqjkuf2uvmna)

✓ This is the authoritative definition for this NSID.

## Description

MLF publish manifest — one record per publish event.

Written by `mlf publish` into the author's PDS alongside the
lexicons themselves. The record's own CID is the durable identifier
for "this specific publish" — a content-addressed release pointer
that binds the set of published items and the dependency versions
they were resolved against.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:xl243nyru4tbbqjkuf2uvmna/lol.mlf.package)
- [Documentation](https://lexicon.garden/lexicon/did:plc:xl243nyru4tbbqjkuf2uvmna/lol.mlf.package/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:xl243nyru4tbbqjkuf2uvmna/lol.mlf.package/examples)

## Definitions

### `lol.mlf.package`

**Type**: `record`

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `tool` | `string` | Yes | Version string of the MLF tool that produced the publish (e.g. `"mlf@0.1.0"`). |
| `published` | `array` | Yes | Every lexicon record the publish wrote to the PDS in this event, sorted lexicographically by NSID. |
| `publishedAt` | `string` (datetime) | Yes | ISO 8601 timestamp of when the publish completed. |
| `resolvedDependencies` | `array` | No | Every external lexicon the workspace resolved against at publish time, pinned to the remote CID observed during the publish. Empty list when the package has no external dependencies. |

### `lol.mlf.package#PublishedItem`

**Type**: `object`

One lexicon record included in a publish.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | Yes | CID of the record as stored on the PDS. |
| `nsid` | `string` (nsid) | Yes | NSID of the published lexicon. |

### `lol.mlf.package#ResolvedDependency`

**Type**: `object`

One external dependency pinned at publish time.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | Yes | CID of the record at the moment of the publish. |
| `nsid` | `string` (nsid) | Yes | NSID of the external lexicon the package linked against. |

## Raw Schema

```json
{
  "id": "lol.mlf.package",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "publishedAt",
          "tool",
          "published"
        ],
        "properties": {
          "tool": {
            "type": "string",
            "description": "Version string of the MLF tool that produced the publish\n(e.g. `\"mlf@0.1.0\"`)."
          },
          "published": {
            "type": "array",
            "items": {
              "ref": "#PublishedItem",
              "type": "ref"
            },
            "description": "Every lexicon record the publish wrote to the PDS in this event,\nsorted lexicographically by NSID."
          },
          "publishedAt": {
            "type": "string",
            "format": "datetime",
            "description": "ISO 8601 timestamp of when the publish completed."
          },
          "resolvedDependencies": {
            "type": "array",
            "items": {
              "ref": "#ResolvedDependency",
              "type": "ref"
            },
            "description": "Every external lexicon the workspace resolved against at publish\ntime, pinned to the remote CID observed during the publish.\nEmpty list when the package has no external dependencies."
          }
        }
      }
    },
    "PublishedItem": {
      "type": "object",
      "required": [
        "nsid",
        "cid"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "format": "cid",
          "description": "CID of the record as stored on the PDS."
        },
        "nsid": {
          "type": "string",
          "format": "nsid",
          "description": "NSID of the published lexicon."
        }
      },
      "description": "One lexicon record included in a publish."
    },
    "ResolvedDependency": {
      "type": "object",
      "required": [
        "nsid",
        "cid"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "format": "cid",
          "description": "CID of the record at the moment of the publish."
        },
        "nsid": {
          "type": "string",
          "format": "nsid",
          "description": "NSID of the external lexicon the package linked against."
        }
      },
      "description": "One external dependency pinned at publish time."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "MLF publish manifest — one record per publish event.\n\nWritten by `mlf publish` into the author's PDS alongside the\nlexicons themselves. The record's own CID is the durable identifier\nfor \"this specific publish\" — a content-addressed release pointer\nthat binds the set of published items and the dependency versions\nthey were resolved against."
}
```