Delivered, not yet invoiced

Inspect completed delivery or performance before an invoice has been issued.

Stable ID: delivered-not-invoiced · Version: 0.1.0
Asset structure: Verified unbilled 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] ?? 'delivered-not-invoiced';

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 "delivered-not-invoiced"

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 delivered-not-invoiced

Python

python3 lookup.py delivered-not-invoiced

delivered-not-invoiced 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": "delivered-not-invoiced",
  "version": "0.1.0",
  "name": "Delivered, not yet invoiced",
  "assetStructure": "Verified unbilled receivable",
  "definition": "Inspect completed delivery or performance before an invoice has been issued.",
  "aliases": [
    "Delivered but not yet invoiced"
  ],
  "legacyIds": {
    "shadowDashboard": "09"
  },
  "evidenceToInspect": [
    "Delivery or service evidence",
    "contract",
    "acceptance",
    "expected billing event"
  ],
  "decisionQuestion": "What completed performance supports the claim before billing?",
  "entryRule": null,
  "exclusionRule": null,
  "amountRule": null,
  "releaseRule": null,
  "referenceScenario": {
    "nextReleaseEvent": "Invoice record matches earned amount",
    "sourceId": "shadow-dashboard"
  },
  "sourceRefs": [
    {
      "sourceId": "docs:delivered-not-invoiced",
      "sha256": "a8d80a78bedb82e866616d8a3c73c28f8b06887615d6060d656f803ee8bc5d36",
      "startLine": 1,
      "endLine": 31
    },
    {
      "sourceId": "shadow-dashboard",
      "sha256": "a9143a735d64a35a18ef49f0d8f24a091815927646d0b2d2780778e360cb1c26",
      "startLine": 373,
      "endLine": 386
    }
  ],
  "assetStructureAliases": []
}

Evidence to inspect

• Delivery or service evidence
• contract
• acceptance
• expected billing event

Decision question: What completed performance supports the claim before billing?

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 “Invoice record matches earned amount” 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