{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-17T22:44:07.049Z",
  "record_id": "VXI-EXT-PROCUREMENT-LAMBDA-KINESIS-CHECKPOINT-01-v1",
  "record_kind": "external_reference",
  "title": "Lambda/Kinesis: Checkpoint replay after partial failure",
  "system": "AWS Lambda",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does Lambda retry only the failed Kinesis records listed in a partial batch response?",
  "near_questions": [
    "Why did a successful Kinesis record run again after partial failure?",
    "Which failed sequence number sets the Lambda checkpoint?",
    "Does Lambda retry every record after the lowest failed sequence?",
    "Was ReportBatchItemFailures enabled on the mapping?",
    "Is returning batchItemFailures enough to activate partial success?",
    "How does checkpoint replay differ from SQS item retries?",
    "Which later records already produced effects?",
    "What did the Kinesis handler report as failed?",
    "Were replayed successes handled idempotently?",
    "What evidence resolves stream checkpoint recovery?",
    "Did batch bisection affect the retry set?",
    "Can INDEX inspect a Lambda event source mapping?"
  ],
  "supported_claims": [
    {
      "claim": "With ReportBatchItemFailures enabled on the event source mapping, Lambda uses the lowest reported failed sequence number as its checkpoint and retries all records from there. Later successful records can therefore repeat. Returning partial-failure data in function code is insufficient unless that response type is enabled on the mapping.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Exactly-once downstream effects or equivalence to SQS partial-batch behavior",
    "Verified buyer configuration, effective access or actual event completeness",
    "Runtime enforcement, certification or approval to act"
  ],
  "public_summary": "With ReportBatchItemFailures enabled on the event source mapping, Lambda uses the lowest reported failed sequence number as its checkpoint and retries all records from there. Later successful records can therefore repeat. Returning partial-failure data in function code is insufficient unless that response type is enabled on the mapping.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "AWS Lambda: Kinesis partial batch responses",
    "source_url": "https://docs.aws.amazon.com/lambda/latest/dg/services-kinesis-batchfailurereporting.html",
    "checked_on": "2026-10-17",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-LAMBDA-KINESIS-CHECKPOINT-01-v1",
    "candidate_record_sha256": "da20c556bf7e8014f7687064c0101d6180ac3f42e33f1157db268e225592dad3",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "With ReportBatchItemFailures enabled on the event source mapping, Lambda uses the lowest reported failed sequence number as its checkpoint and retries all records from there. Later successful records can therefore repeat. Returning partial-failure data in function code is insufficient unless that response type is enabled on the mapping.",
    "required_buyer_context": "Event source mapping response types, retry and batch-bisection settings. Reported failed sequence numbers and the actual checkpoint. Later-record effects and their handling on repeated delivery. Buyer deployment not inspected.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "decision_profile": {
    "schema": "varexis-vendor-evidence-review/1",
    "review_status": "documentation_review_only",
    "checked_on": "2026-10-17",
    "claim_to_check": "Does Lambda retry only the failed Kinesis records listed in a partial batch response?",
    "documented_statement": {
      "status": "documented",
      "statement": "With ReportBatchItemFailures enabled on the event source mapping, Lambda uses the lowest reported failed sequence number as its checkpoint and retries all records from there. Later successful records can therefore repeat. Returning partial-failure data in function code is insufficient unless that response type is enabled on the mapping.",
      "source_ids": [
        "lambda-checkpoint"
      ]
    },
    "buyer_evidence_required": [
      "Event source mapping response types, retry and batch-bisection settings.",
      "Reported failed sequence numbers and the actual checkpoint.",
      "Later-record effects and their handling on repeated delivery."
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Decline failed-items-only retry claims without checking the stream checkpoint and all later records that can replay."
    },
    "unknowns": "The buyer configuration, contract, effective entitlement and operational evidence have not been inspected. Missing evidence does not establish absence or failure of the feature.",
    "evidence_sources": [
      {
        "source_id": "lambda-checkpoint",
        "url": "https://docs.aws.amazon.com/lambda/latest/dg/services-kinesis-batchfailurereporting.html",
        "final_url": "https://docs.aws.amazon.com/lambda/latest/dg/services-kinesis-batchfailurereporting.html",
        "title": "AWS Lambda: Kinesis partial batch responses",
        "checked_on": "2026-10-17",
        "captured_at_utc": "2026-10-17T22:37:24.131Z",
        "version_context": "Rolling Lambda guide; ReportBatchItemFailures checkpoint behavior",
        "sha256": "9210165caed4e0c29a78f27883b032c6ad1670d1019eb930a48af8af6e6ada39",
        "bytes": 52220,
        "hash_basis": "Decoded HTTP response body bytes; not a signature or truth guarantee",
        "reviewed_sections": [
          "Report syntax; Success and failure conditions; Bisecting a batch"
        ]
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Procurement evidence support only; no supplier clearance, legal conclusion, configuration audit or verification of the buyer's claim is supplied.",
    "paid_value": {
      "decision_context": "A handler that retries only failed-item logic conceptually may still repeat already successful downstream effects.",
      "free": "Complete review, practical questions, sources and limitations; may be saved locally.",
      "single_request": "Existing server-saved version-bound route snapshot for later authenticated retrieval.",
      "evidence_receipt": "The same snapshot plus the existing unsigned delivery receipt.",
      "excluded": [
        "Fresh vendor research",
        "Continuous monitoring or change alerts",
        "Testing the buyer configuration",
        "Private evidence or vendor certification"
      ],
      "integrity": "Hashes identify content versions; they do not prove truth or provide a signature."
    },
    "revalidation": {
      "trigger": "A saved purchase does not recheck the source or buyer configuration.",
      "specific_watch": "Event source mapping response types, retry and batch-bisection settings. Reported failed sequence numbers and the actual checkpoint. Later-record effects and their handling on repeated delivery."
    },
    "buyer_relevance": "A handler that retries only failed-item logic conceptually may still repeat already successful downstream effects.",
    "refusal_conditions": [
      "Decline failed-items-only retry claims without checking the stream checkpoint and all later records that can replay."
    ]
  },
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#lambda-kinesis-partial-failure-checkpoint-replay",
  "machine_readable_record": "/varexis-index/records/lambda-kinesis-partial-failure-checkpoint-replay.json"
}
