{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-17T17:54:06.066Z",
  "record_id": "VXI-EXT-PROCUREMENT-GITHUB-APP-PERMISSION-APPROVAL-01-v1",
  "record_kind": "external_reference",
  "title": "GitHub Apps: Permission changes and installation approval",
  "system": "GitHub Apps",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does changing a GitHub App registration prove every existing installation has the new permissions?",
  "near_questions": [
    "Has this installation approved the new GitHub App permissions?",
    "Are requested permissions already granted?",
    "Can old and new app installations have different grants?",
    "Who approved added organization permissions?",
    "Do added account permissions require user approval?",
    "When do removed GitHub App permissions take effect?",
    "Which installation accepted the permission change?",
    "Does an app registration match the current token grant?",
    "What changed since the previous tool inventory?",
    "Is a permission request being mistaken for authority?",
    "What evidence supports Tool Admission permission-change declarations?",
    "Can a webhook acceptance event replace current effective-access evidence?"
  ],
  "supported_claims": [
    {
      "claim": "Added repository or organization permissions require approval by each installing account; added account permissions require approval by each authorizing user. Updated grants do not take effect there until approved. GitHub documents permission removals as taking effect immediately.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Approval by every installation, current effective repository access or a verified successful action",
    "Verified buyer configuration, effective access or actual event completeness",
    "Runtime enforcement, certification or approval to act"
  ],
  "public_summary": "Added repository or organization permissions require approval by each installing account; added account permissions require approval by each authorizing user. Updated grants do not take effect there until approved. GitHub documents permission removals as taking effect immediately.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "GitHub: Modifying a GitHub App registration",
    "source_url": "https://docs.github.com/en/apps/maintaining-github-apps/modifying-a-github-app-registration",
    "checked_on": "2026-10-17",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-GITHUB-APP-PERMISSION-APPROVAL-01-v1",
    "candidate_record_sha256": "f738b90d631add7f473ac6f76ce7bc04002ac5fc436695d5ed47b023e2516cb5",
    "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": "Added repository or organization permissions require approval by each installing account; added account permissions require approval by each authorizing user. Updated grants do not take effect there until approved. GitHub documents permission removals as taking effect immediately.",
    "required_buyer_context": "App registration permission change and its timestamp. Installation or user-authorization identity and permission approval state. Current token permission inventory and the intended action and repository. 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 changing a GitHub App registration prove every existing installation has the new permissions?",
    "documented_statement": {
      "status": "documented",
      "statement": "Added repository or organization permissions require approval by each installing account; added account permissions require approval by each authorizing user. Updated grants do not take effect there until approved. GitHub documents permission removals as taking effect immediately.",
      "source_ids": [
        "github-permission-update"
      ]
    },
    "buyer_evidence_required": [
      "App registration permission change and its timestamp.",
      "Installation or user-authorization identity and permission approval state.",
      "Current token permission inventory and the intended action and repository."
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Decline a uniform-authority claim based on registration settings alone; reconcile the specific installation grant before relying on the declared change."
    },
    "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": "github-permission-update",
        "url": "https://docs.github.com/en/apps/maintaining-github-apps/modifying-a-github-app-registration",
        "final_url": "https://docs.github.com/en/apps/maintaining-github-apps/modifying-a-github-app-registration",
        "title": "GitHub: Modifying a GitHub App registration",
        "checked_on": "2026-10-17",
        "captured_at_utc": "2026-10-17T17:50:55.831Z",
        "version_context": "Rolling GitHub App documentation",
        "sha256": "38e50da107ed295998f5e337b82cd2be1671679a83c70cabedd98b0cdad257d2",
        "bytes": 219075,
        "hash_basis": "Decoded HTTP response body bytes; not a signature or truth guarantee",
        "reviewed_sections": [
          "Changing the permissions of a GitHub App"
        ]
      }
    ],
    "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 supplier or operator comparing old and new agent declarations must distinguish a requested expansion from the grant accepted for the particular installation.",
      "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": "App registration permission change and its timestamp. Installation or user-authorization identity and permission approval state. Current token permission inventory and the intended action and repository."
    },
    "buyer_relevance": "A supplier or operator comparing old and new agent declarations must distinguish a requested expansion from the grant accepted for the particular installation.",
    "refusal_conditions": [
      "Decline a uniform-authority claim based on registration settings alone; reconcile the specific installation grant before relying on the declared change."
    ]
  },
  "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#github-app-permission-update-installation-approval",
  "machine_readable_record": "/varexis-index/records/github-app-permission-update-installation-approval.json"
}
