Return-window survivors

Separate obligations that remain after the relevant return window from the amounts still exposed to returns.

Stable ID: return-window-survivors · Version: 0.1.0
Asset structure: Return-resolved receivable

Get this definition

Download the client for your language into the same directory as the example. Node.js 18+ or Python 3.8+ is sufficient; no package installation, API key, or model call is needed.

JavaScript setup

export MINT_DOCS_BASE="https://docs.mint.us"
curl --fail --show-error "$MINT_DOCS_BASE/cohorts-client.mjs" -o cohorts-client.mjs

Python setup

export MINT_DOCS_BASE="https://docs.mint.us"
curl --fail --show-error "$MINT_DOCS_BASE/cohorts_client.py" -o cohorts_client.py

Use your running docs origin for MINT_DOCS_BASE if it differs. Save either example as shown. It fetches the registry, validates the supported registry fields, and returns only the exact named definition.

lookup.mjs

import { CohortError, loadCohorts, getCohort } from './cohorts-client.mjs';

const base = process.env.MINT_DOCS_BASE ?? 'https://docs.mint.us';
const id = process.argv[2] ?? 'return-window-survivors';

try {
  const registry = await loadCohorts(base);
  const definition = getCohort(registry, id);
  console.log(JSON.stringify(definition, null, 2));
} catch (error) {
  if (!(error instanceof CohortError)) throw error;
  console.error(`${error.code}: ${error.message}`);
  process.exitCode = 1;
}

lookup.py

import json
import os
import sys
from cohorts_client import CohortError, load_cohorts, get_cohort

base = os.environ.get("MINT_DOCS_BASE", "https://docs.mint.us")
cohort_id = sys.argv[1] if len(sys.argv) > 1 else "return-window-survivors"

try:
    registry = load_cohorts(base)
    definition = get_cohort(registry, cohort_id)
    print(json.dumps(definition, indent=2))
except CohortError as error:
    print(f"{error.code}: {error}", file=sys.stderr)
    sys.exit(1)

Run the saved example:

JavaScript

node lookup.mjs return-window-survivors

Python

python3 lookup.py return-window-survivors

return-window-survivors is an explicit choice, not the first search result. Pass another exact ID to inspect it. An unknown ID exits with COHORT_NOT_FOUND; download or JSON parsing failure exits with FETCH_FAILED. Other client errors and discovery functions are in the agent guide.

Response

The complete definition returned by the examples above, from registry version 0.1.0:

{
  "id": "return-window-survivors",
  "version": "0.1.0",
  "name": "Return-window survivors",
  "assetStructure": "Return-resolved receivable",
  "definition": "Separate obligations that remain after the relevant return window from the amounts still exposed to returns.",
  "aliases": [],
  "legacyIds": {
    "shadowDashboard": "01"
  },
  "evidenceToInspect": [
    "Return policy and dates",
    "accepted invoice",
    "recorded returns and credits"
  ],
  "decisionQuestion": "Which amount survives the return treatment, and when does that treatment become known?",
  "entryRule": null,
  "exclusionRule": null,
  "amountRule": null,
  "releaseRule": null,
  "referenceScenario": {
    "nextReleaseEvent": "Return window closes; actual returns reconcile",
    "sourceId": "shadow-dashboard"
  },
  "sourceRefs": [
    {
      "sourceId": "docs:return-window-survivors",
      "sha256": "0b0a505f0cf6e6a0918a409d9eac3753e2ad9bf22d19808322ea7f61e543a0e9",
      "startLine": 1,
      "endLine": 31
    },
    {
      "sourceId": "shadow-dashboard",
      "sha256": "a9143a735d64a35a18ef49f0d8f24a091815927646d0b2d2780778e360cb1c26",
      "startLine": 153,
      "endLine": 166
    }
  ],
  "assetStructureAliases": []
}

Evidence to inspect

• Return policy and dates
• accepted invoice
• recorded returns and credits

Decision question: Which amount survives the return treatment, and when does that treatment become known?

Fields and schema

All fields shown in the response are required by the JSON Schema. The record schema is at JSON Pointer /properties/records/items; the top-level schema validates the full registry, not a single record. It permits exactly twelve records and no extra object properties. aliases and assetStructureAliases can be empty; evidenceToInspect cannot, and sourceRefs contains at least two references.

Field	Type	Meaning
id	string	Stable exact lookup ID; not a company or asset ID.
version	string	Definition version, 0.1.0. Retain with the ID.
name	string	Human-readable cohort name.
assetStructure	string	The economic claim structure described by this cohort.
definition	string	What this cohort separates or inspects.
aliases	string[]	Alternative cohort names for discovery; may be empty.
assetStructureAliases	string[]	Alternative structure names; may be empty.
legacyIds.shadowDashboard	string	Older dashboard identifier (01–12), not an exact lookup ID.
evidenceToInspect	string[]	Evidence categories to examine, not evidence already obtained.
decisionQuestion	string	The question the evidence needs to resolve.
entryRule	null	No executable entry predicate is supplied.
exclusionRule	null	No executable exclusion predicate is supplied.
amountRule	null	No executable amount calculation is supplied.
releaseRule	null	No executable release condition is supplied.
referenceScenario.nextReleaseEvent	string	Sourced next-event description from the older model.
referenceScenario.sourceId	string	Source identifier, shadow-dashboard.
sourceRefs[].sourceId	string	Source supporting the definition or reference scenario.
sourceRefs[].sha256	string	SHA-256 of the reviewed source bytes; 64 lowercase hex characters.
sourceRefs[].startLine	integer	First supporting source line, 1-based.
sourceRefs[].endLine	integer	Last supporting source line, inclusive.

The containing registry has catalogId: "mint-shadow-cohorts", version: "0.1.0", scope: "definition-discovery", and records. These records have no amount or currency fields; no financial value or unit is implied.

Definition, not membership

The four rule fields are null: no executable qualification, exclusion, amount, or release rules are supplied. A null rule does not qualify an asset. The reference event “Return window closes; actual returns reconcile” is a sourced description, not a funding decision.

Keep actual asset membership, company records, and buyer fit separate. Retain the definition ID, version, and supporting evidence when assessing a real asset; this definition response does not establish available assets or a company’s holdings. Source hashes refer to reviewed source snapshots, not the current expanded documentation page.

Continue

• List or search all cohort definitions
• Explore the cohort library
• Inspect actual workspace assets
• Registry JSON · JSON Schema