# org.latha.island

> Published by [nandi.uk](https://lexicon.garden/identity/did:plc:ngokl2gnmpbvuvrfckja3g7p)

✓ This is the authoritative definition for this NSID.

## Description

A structured synthesis over a graph component. The island record points to actual network.cosmik.connection records; it does not embed edge data.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:ngokl2gnmpbvuvrfckja3g7p/org.latha.island)
- [Documentation](https://lexicon.garden/lexicon/did:plc:ngokl2gnmpbvuvrfckja3g7p/org.latha.island/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:ngokl2gnmpbvuvrfckja3g7p/org.latha.island/examples)

## Definitions

### `org.latha.island`

**Type**: `record`

A Stigmergic island: a centroid URL, pointers to network.cosmik.connection records, and analysis of the resulting graph component.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `forkOf` | `string` (at-uri) | No | Original org.latha.island AT URI when this record is a fork/update of another user's island. |
| `source` | `ref` → `#sourceRef` | Yes | The island centroid/canonical source URL. |
| `analysis` | `ref` → `#structuredAnalysis` | Yes | The structured analysis output. |
| `carryRefs` | `array` | No | Carry entities cross-referenced in this analysis. Carry stays local-first — only summaries are included unless explicitly published as companion records. |
| `createdAt` | `string` (datetime) | Yes | When this synthesis was created. |
| `updatedAt` | `string` (datetime) | No | When this synthesis was last updated. |
| `connections` | `array` | Yes | AT URIs of actual network.cosmik.connection records. The island does not embed edge source/target/type/note data. |

### `org.latha.island#sourceRef`

**Type**: `object`

Reference to the source/centroid for this island.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` | No | CID of the source record at time of analysis. |
| `uri` | `string` (uri) | Yes | Canonical HTTPS URL of the island centroid. |
| `collection` | `string` | No | Collection being analyzed. For islands over connection graphs this is usually network.cosmik.connection. |

### `org.latha.island#carryCrossRef`

**Type**: `object`

Cross-reference to a carry entity, translated to AT Protocol addressable format.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `atUri` | `string` (at-uri) | Yes | AT Protocol URI for this carry entity (if published as companion record). |
| `carryId` | `string` | No | Original carry entity ID for local correlation. |
| `summary` | `string` | No | Summary of the carry entity. |
| `entityType` | `string` | Yes | Type of carry entity. |

### `org.latha.island#structuredAnalysis`

**Type**: `object`

The structured output of a Strata analysis run.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | `string` | No | A concise sentence capturing the core argument or narrative arc of this analysis. |
| `themes` | `array` | Yes | Key themes identified in the source. |
| `tensions` | `array` | No | Tensions or contradictions with existing claims. |
| `synthesis` | `string` | No | Prose synthesis connecting the source to existing knowledge. Legacy plain-text format. |
| `highlights` | `array` | No | AT URIs of network.cosmik.connection records flagged as semantically significant by the analysis. Hot edges. |
| `synthesisDoc` | `string` (at-uri) | No | AT URI of a pub.oxa.document record containing the rich-text synthesis. Takes precedence over the plain-text synthesis field when present. |
| `openQuestions` | `array` | No | Questions raised by the analysis. |

## Raw Schema

```json
{
  "id": "org.latha.island",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "source",
          "connections",
          "analysis",
          "createdAt"
        ],
        "properties": {
          "forkOf": {
            "type": "string",
            "format": "at-uri",
            "description": "Original org.latha.island AT URI when this record is a fork/update of another user's island."
          },
          "source": {
            "ref": "#sourceRef",
            "type": "ref",
            "description": "The island centroid/canonical source URL."
          },
          "analysis": {
            "ref": "#structuredAnalysis",
            "type": "ref",
            "description": "The structured analysis output."
          },
          "carryRefs": {
            "type": "array",
            "items": {
              "ref": "#carryCrossRef",
              "type": "ref"
            },
            "maxLength": 20,
            "description": "Carry entities cross-referenced in this analysis. Carry stays local-first — only summaries are included unless explicitly published as companion records."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When this synthesis was created."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When this synthesis was last updated."
          },
          "connections": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "maxLength": 500,
            "description": "AT URIs of actual network.cosmik.connection records. The island does not embed edge source/target/type/note data."
          }
        }
      },
      "description": "A Stigmergic island: a centroid URL, pointers to network.cosmik.connection records, and analysis of the resulting graph component."
    },
    "sourceRef": {
      "type": "object",
      "required": [
        "uri"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "description": "CID of the source record at time of analysis."
        },
        "uri": {
          "type": "string",
          "format": "uri",
          "description": "Canonical HTTPS URL of the island centroid."
        },
        "collection": {
          "type": "string",
          "description": "Collection being analyzed. For islands over connection graphs this is usually network.cosmik.connection."
        }
      },
      "description": "Reference to the source/centroid for this island."
    },
    "carryCrossRef": {
      "type": "object",
      "required": [
        "entityType",
        "atUri"
      ],
      "properties": {
        "atUri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT Protocol URI for this carry entity (if published as companion record)."
        },
        "carryId": {
          "type": "string",
          "description": "Original carry entity ID for local correlation."
        },
        "summary": {
          "type": "string",
          "description": "Summary of the carry entity.",
          "maxGraphemes": 500
        },
        "entityType": {
          "type": "string",
          "description": "Type of carry entity.",
          "knownValues": [
            "org.latha.island.defs#claimRef",
            "org.latha.island.defs#sourceRef"
          ]
        }
      },
      "description": "Cross-reference to a carry entity, translated to AT Protocol addressable format."
    },
    "structuredAnalysis": {
      "type": "object",
      "required": [
        "themes"
      ],
      "properties": {
        "title": {
          "type": "string",
          "description": "A concise sentence capturing the core argument or narrative arc of this analysis.",
          "maxGraphemes": 300
        },
        "themes": {
          "type": "array",
          "items": {
            "type": "string",
            "maxGraphemes": 100
          },
          "maxLength": 20,
          "description": "Key themes identified in the source."
        },
        "tensions": {
          "type": "array",
          "items": {
            "type": "string",
            "maxGraphemes": 500
          },
          "maxLength": 10,
          "description": "Tensions or contradictions with existing claims."
        },
        "synthesis": {
          "type": "string",
          "maxLength": 20000,
          "description": "Prose synthesis connecting the source to existing knowledge. Legacy plain-text format.",
          "maxGraphemes": 2000
        },
        "highlights": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "at-uri"
          },
          "maxLength": 20,
          "description": "AT URIs of network.cosmik.connection records flagged as semantically significant by the analysis. Hot edges."
        },
        "synthesisDoc": {
          "type": "string",
          "format": "at-uri",
          "description": "AT URI of a pub.oxa.document record containing the rich-text synthesis. Takes precedence over the plain-text synthesis field when present."
        },
        "openQuestions": {
          "type": "array",
          "items": {
            "type": "string",
            "maxGraphemes": 500
          },
          "maxLength": 10,
          "description": "Questions raised by the analysis."
        }
      },
      "description": "The structured output of a Strata analysis run."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A structured synthesis over a graph component. The island record points to actual network.cosmik.connection records; it does not embed edge data."
}
```
