# MINT

> Assets, cohorts, buyer terms, and local financial files.

Start with `mint status --json` and `mint buyers --boxes --limit 10 --json`. Choose an exact returned program ID, inspect it with `mint mandate`, and retain source identifiers with every result. Resolve relative links against this documentation origin.

## Code and contracts

- [Asset definitions](./asset-definitions): List, retrieve, and search twelve asset structure definitions; proposed field descriptors and complete JSON.
- [Asset definition JSON](./asset-definitions.json): Separate definition catalog; no observed values, classification, membership, or executable rules.
- [Asset definition schema](./asset-definitions.schema.json): Strict Draft 2020-12 catalog schema.

- [Assets and cohorts for agents](./agents): Code-first discovery, response fields, and explicit program selection.
- [Cohort definitions for agents](./cohorts-for-agents): Fetch, list, search, and retrieve versioned definitions by exact stable ID.
- [Cohort registry JSON](./cohorts.json): Twelve reviewed definitions with evidence requirements, aliases, and source hashes; not asset membership.
- [Cohort registry schema](./cohorts.schema.json): Draft 2020-12 schema for registry version 0.1.0.
- [CLI reference](./cli): Commands, exact flags, JSON shapes, source context, errors, and save/open side effects.
- [Safe Node.js invocation](./agents#invoke-the-installed-cli-from-node-js): Argument arrays, JSON parsing, empty results, and unavailable CLI handling.
- [Floating host file tools](./agents#work-with-local-files): JSON arguments for reading/creating workbooks, table reconciliation, and OCR; result and continuation fields.
- [Agent guide](./skill.md): Plain-text command/tool instructions and action boundaries.
- [Starting prompt](./agent-prompt.txt): Copyable instructions for an asset or cohort task.

## Financial records

- [Assets](./assets): Exact IDs, amount units, and supporting sources.
- [Cohort handoff](./agents#hand-off-a-cohort-from-the-workspace): Grouping rule, exact membership, source IDs, and supported workspace selection.
- [Cohorts](./cohorts) and [Supply matrix](./cohort-matrix): Inspection, filters, fit intersections, and explicit package selection.
- [Buy Boxes](./buy-boxes): Criteria, source states, and entered assumptions.
- [Saved results](./saved-results): Result identity and stored comparison evidence.

## Local workflow

- [Floating desktop](./floating-desktop)
- [Local data](./local-data)
- [Files and folders](./files-folders)
- [Reports and exports](./reports)

## Cohort definition clients
- /cohorts-client.mjs: JavaScript load, list, get and search functions for both catalogs.
- /cohorts-client.d.mts: TypeScript declarations for the JavaScript client.
- /cohorts_client.py: Python client for both catalogs using the standard library.

- [OpenAPI Spec](./integrations/openapi): HTTP operation, response schema, no-auth access, and tooling guidance for cohort definition discovery.
- [OpenAPI JSON](./openapi.json): OpenAPI 3.1.0 contract for GET /cohorts.json; client-side lookup/search are not HTTP endpoints.
- /cohorts-client.mjs: JavaScript load, list, get and search functions.
- /cohorts_client.py: Python client using the standard library.
- [Return-window survivors](./cohorts/return-window-survivors): Return-resolved receivable.
- [Late-delivery claims](./cohorts/late-delivery-claims): Penalty-bounded receivable.
- [Partially fulfilled purchase orders](./cohorts/partially-fulfilled-pos): Line-item microreceivables.
- [Delivered, awaiting acceptance](./cohorts/delivered-awaiting-acceptance): Event-vested receivable.
- [Retail chargebacks](./cohorts/retail-chargebacks): Clean base and recovery strip.
- [Volume rebates](./cohorts/volume-rebates): Net-of-rebate receivable.
- [Promotional allowances](./cohorts/promotional-allowances): Promotion-normalized claim.
- [Predictable short-pays](./cohorts/predictable-short-pays): Empirically netted receivable.
- [Delivered, not yet invoiced](./cohorts/delivered-not-invoiced): Verified unbilled receivable.
- [Milestones and retainage](./cohorts/milestones-retainage): Progress claim and retainage strip.
- [Formula-priced shipments](./cohorts/formula-priced-shipments): Formula-reset receivable.
- [Setoff and netting](./cohorts/setoff-netting): Obligor-level net-settlement claim.