{
  "schema": "io.teaql.glossary/v1",
  "canonicalUrl": "https://teaql.io/docs/reference/glossary",
  "terms": [
    {
      "term": "Context",
      "canonicalName": "UserContext",
      "definition": "The trusted execution context supplied to one business operation.",
      "requiredParameterName": "context",
      "forbiddenParameterAliases": ["runtime", "ctx", "service", "dataService"],
      "appliesTo": ["newEntity", "save", "query", "page", "count", "stream", "tool", "federation"],
      "not": ["process runtime", "raw database connection"]
    },
    {
      "term": "Runtime",
      "definition": "The process-level owner of providers, pools, installed modules, and context creation.",
      "not": ["business-operation context argument"]
    },
    {
      "term": "Runtime Module",
      "definition": "A passive composable manifest of runtime capabilities and entity metadata.",
      "rules": ["installation does not modify a database", "ensureSchema(module) is explicit"]
    },
    {
      "term": "SmartList",
      "definition": "TeaQL's extensible typed list result with room for totals, facets, and result metadata.",
      "not": ["raw language list in the shared API contract"]
    },
    {
      "term": "Loaded",
      "definition": "The field was materialized; its value may be null or non-null."
    },
    {
      "term": "Null",
      "definition": "The field was loaded and its authoritative value is null."
    },
    {
      "term": "Not Loaded",
      "definition": "The field was not materialized and must not collapse into null or a default value."
    },
    {
      "term": "Authoritative Save Result",
      "definition": "The persisted typed entity including generated ID, optimistic version, database defaults, and preserved field load state."
    },
    {
      "term": "Purpose",
      "definition": "The business reason for query execution and the transition into the executable request stage."
    },
    {
      "term": "Comment",
      "definition": "A human-readable description of what a query is doing."
    },
    {
      "term": "Audit",
      "canonicalName": "auditAs",
      "definition": "The explicit business reason attached before mutation save."
    },
    {
      "term": "Assist",
      "definition": "Model-aware exact API guidance generated from the same source as the domain API."
    },
    {
      "term": "Harness Engineering",
      "definition": "Model-aware generation combined with executable verification, evidence, and diagnostics for AI-generated changes."
    },
    {
      "term": "Conformance",
      "definition": "Retained executable evidence for a named capability, runtime, version, and scenario."
    }
  ],
  "languageContextNames": {
    "java": "UserContext context",
    "rust": "context: &C",
    "typescript": "context: UserContext",
    "swift": "context: UserContext",
    "python": "context",
    "dotnet": "UserContext context",
    "go": "context *runtime.UserContext"
  }
}