pub.chive.discovery.settings

lexicons.governance.chive.pub

Documentation

User discovery preferences for personalized recommendations

main record

User discovery preferences for personalized recommendations

Record Key literal:self Fixed literal value

Properties

citationNetworkDisplay string Optional

How to display citation network

Known values: hidden, preview, expanded
Default: preview
enablePersonalization boolean Optional

Enable personalized recommendations based on profile

Default: true
followedFieldUris array of string at-uri Optional

Field URIs the user follows for discovery (distinct from work fields in profile)

maxLength: 50 items
followingTabIncludesWorkFields boolean Optional

Whether the Following tab also includes the user's work fields

Default: false
minimumEndorsementThreshold integer Optional

Minimum number of endorsements for a paper to appear in recommendations

minimum: 0maximum: 10
Default: 0
recommendationDiversity string Optional

How diverse recommendations should be relative to user's fields

Known values: low, medium, high
Default: medium
schemaRevision integer Optional

Schema revision this record was created with. Absent means revision 1.

minimum: 1
showRecommendationReasons boolean Optional

Show explanations for why papers are recommended

Default: true
View raw schema 
{
  "description": "User discovery preferences for personalized recommendations",
  "key": "literal:self",
  "record": {
    "properties": {
      "citationNetworkDisplay": {
        "default": "preview",
        "description": "How to display citation network",
        "knownValues": [
          "hidden",
          "preview",
          "expanded"
        ],
        "type": "string"
      },
      "enablePersonalization": {
        "default": true,
        "description": "Enable personalized recommendations based on profile",
        "type": "boolean"
      },
      "followedFieldUris": {
        "description": "Field URIs the user follows for discovery (distinct from work fields in profile)",
        "items": {
          "format": "at-uri",
          "type": "string"
        },
        "maxLength": 50,
        "type": "array"
      },
      "followingTabIncludesWorkFields": {
        "default": false,
        "description": "Whether the Following tab also includes the user's work fields",
        "type": "boolean"
      },
      "minimumEndorsementThreshold": {
        "default": 0,
        "description": "Minimum number of endorsements for a paper to appear in recommendations",
        "maximum": 10,
        "minimum": 0,
        "type": "integer"
      },
      "recommendationDiversity": {
        "default": "medium",
        "description": "How diverse recommendations should be relative to user's fields",
        "knownValues": [
          "low",
          "medium",
          "high"
        ],
        "type": "string"
      },
      "relatedPapersSignals": {
        "description": "Signals to use for related papers",
        "ref": "#relatedPapersSignals",
        "type": "ref"
      },
      "relatedPapersThresholds": {
        "description": "Thresholds for related papers filtering",
        "ref": "#relatedPapersThresholds",
        "type": "ref"
      },
      "relatedPapersWeights": {
        "description": "Relative weights for related papers signals",
        "ref": "#relatedPapersWeights",
        "type": "ref"
      },
      "schemaRevision": {
        "description": "Schema revision this record was created with. Absent means revision 1.",
        "minimum": 1,
        "type": "integer"
      },
      "showRecommendationReasons": {
        "default": true,
        "description": "Show explanations for why papers are recommended",
        "type": "boolean"
      },
      "trendingPreferences": {
        "description": "Preferences for the trending feed",
        "ref": "#trendingPreferences",
        "type": "ref"
      }
    },
    "type": "object"
  },
  "type": "record"
}
relatedPapersSignals object

Configuration for related papers panel signals

Properties

authors boolean Optional

Show papers by overlapping authors

bibliographicCoupling boolean Optional

Show papers that cite the same references

citations boolean Optional

Show citation-based relationships

coCitation boolean Optional

Show papers frequently cited together

collaborative boolean Optional

Show collaborative filtering recommendations

semantic boolean Optional

Show semantically similar papers (SPECTER2 / MLT)

topics boolean Optional

Show topic/concept-based relationships

View raw schema 
{
  "description": "Configuration for related papers panel signals",
  "properties": {
    "authors": {
      "default": true,
      "description": "Show papers by overlapping authors",
      "type": "boolean"
    },
    "bibliographicCoupling": {
      "default": false,
      "description": "Show papers that cite the same references",
      "type": "boolean"
    },
    "citations": {
      "default": true,
      "description": "Show citation-based relationships",
      "type": "boolean"
    },
    "coCitation": {
      "default": false,
      "description": "Show papers frequently cited together",
      "type": "boolean"
    },
    "collaborative": {
      "default": false,
      "description": "Show collaborative filtering recommendations",
      "type": "boolean"
    },
    "semantic": {
      "default": true,
      "description": "Show semantically similar papers (SPECTER2 / MLT)",
      "type": "boolean"
    },
    "topics": {
      "default": true,
      "description": "Show topic/concept-based relationships",
      "type": "boolean"
    }
  },
  "type": "object"
}
relatedPapersThresholds object

Thresholds for related papers filtering

Properties

maxResults integer Optional

Maximum number of related papers to show

minimum: 1maximum: 50
minScore integer Optional

Minimum combined score to include a paper (0-100, maps to 0.0-1.0)

minimum: 0maximum: 100
View raw schema 
{
  "description": "Thresholds for related papers filtering",
  "properties": {
    "maxResults": {
      "default": 10,
      "description": "Maximum number of related papers to show",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "minScore": {
      "default": 5,
      "description": "Minimum combined score to include a paper (0-100, maps to 0.0-1.0)",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}
relatedPapersWeights object

Relative importance of each related papers signal (0-100, auto-normalized)

Properties

authorNetwork integer Optional

Weight for co-author network proximity

minimum: 0maximum: 100
coCitation integer Optional

Weight for co-citation and bibliographic coupling

minimum: 0maximum: 100
collaborative integer Optional

Weight for collaborative filtering signal

minimum: 0maximum: 100
conceptOverlap integer Optional

Weight for OpenAlex concept/topic overlap

minimum: 0maximum: 100
semantic integer Optional

Weight for SPECTER2 / MLT semantic similarity

minimum: 0maximum: 100
View raw schema 
{
  "description": "Relative importance of each related papers signal (0-100, auto-normalized)",
  "properties": {
    "authorNetwork": {
      "default": 15,
      "description": "Weight for co-author network proximity",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "coCitation": {
      "default": 25,
      "description": "Weight for co-citation and bibliographic coupling",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "collaborative": {
      "default": 10,
      "description": "Weight for collaborative filtering signal",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "conceptOverlap": {
      "default": 20,
      "description": "Weight for OpenAlex concept/topic overlap",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "semantic": {
      "default": 30,
      "description": "Weight for SPECTER2 / MLT semantic similarity",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}
trendingPreferences object

Preferences for the trending feed

Properties

defaultLimit integer Optional

Default number of trending results to show

minimum: 5maximum: 100
defaultWindow string Optional

Default time window for trending

Known values: 24h, 7d, 30d
View raw schema 
{
  "description": "Preferences for the trending feed",
  "properties": {
    "defaultLimit": {
      "default": 20,
      "description": "Default number of trending results to show",
      "maximum": 100,
      "minimum": 5,
      "type": "integer"
    },
    "defaultWindow": {
      "default": "7d",
      "description": "Default time window for trending",
      "knownValues": [
        "24h",
        "7d",
        "30d"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Lexicon Garden

@