{
  "schema": "io.teaql.glossary/v1",
  "canonicalUrl": "https://teaql.io/docs/reference/glossary",
  "terms": [
    {
      "term": "TeaQL Runtime",
      "definition": "The reusable, domain-independent runtime platform that executes TeaQL's generated domain APIs and shared runtime contracts.",
      "implementations": ["java", "rust", "typescript", "swift", "python", "dotnet", "go"],
      "repositories": {
        "java": "https://github.com/teaql/teaql-java",
        "rust": "https://github.com/teaql/teaql-rs",
        "typescript": "https://github.com/teaql/teaql-ts",
        "swift": "https://github.com/teaql/teaql-swift",
        "python": "https://github.com/teaql/teaql-python",
        "dotnet": "https://github.com/teaql/teaql-dotnet",
        "go": "https://github.com/teaql/teaql-golang"
      },
      "not": ["generated business application", "application domain model", "code generator", "Agent Kit", "one process-level Runtime instance"]
    },
    {
      "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": "The practice of surrounding AI-produced work with deterministic constraints and feedback, including model evaluation, exact guidance, executable scenarios, runtime checks, conformance gates, diagnostics, and retained evidence."
    },
    {
      "term": "TeaQL Harness",
      "definition": "TeaQL's deterministic engineering system that composes model evaluation, Assist, code generation, generated workspaces, seven TeaQL Runtime implementations, executable scenarios, Conformance checks, diagnostics, and retained evidence into a repeatable feedback loop.",
      "runtimeRole": "The TeaQL Runtime is the execution and runtime-feedback layer inside the Harness.",
      "recommendedAgentEntryPoint": "https://github.com/teaql/teaql-agent-kit",
      "not": ["TeaQL Runtime alone", "Agent Kit alone", "prompt collection", "CI alone", "autonomous coding agent"]
    },
    {
      "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"
  }
}