{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-24T17:38:21.804Z",
  "record_id": "VXI-EXT-PROCUREMENT-NPM-CI-LOCKFILE-MISMATCH-DEPENDENCY-BOUNDARY-01-v1",
  "record_kind": "external_reference",
  "title": "npm locked dependency installation",
  "system": "npm",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does a compatible dependency range alone guarantee that npm installs the previously reviewed dependency tree?",
  "near_questions": [
    "Does npm ci update an out-of-date package lock?",
    "What happens when package.json and package-lock.json disagree?",
    "Why do npm ci flags matter for a reviewed dependency tree?",
    "Can a semver range replace a frozen dependency lock?"
  ],
  "supported_claims": [
    {
      "claim": "npm’s package lock records a resolved dependency tree. npm ci requires a lockfile and fails when its dependencies disagree with package.json instead of updating the lock. Its installation does not rewrite the lock, and tree-shaping flags must match those used to create it. A version range alone is not this frozen-install evidence.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "A guarantee that locked dependencies are harmless or identical on every platform",
    "Runtime loading, platform differences and package safety remain unverified.",
    "Buyer deployment testing, live runtime enforcement, certification or permission to act",
    "Expanded capabilities or licences for existing INDEX executables"
  ],
  "public_summary": "npm’s package lock records a resolved dependency tree. npm ci requires a lockfile and fails when its dependencies disagree with package.json instead of updating the lock. Its installation does not rewrite the lock, and tree-shaping flags must match those used to create it. A version range alone is not this frozen-install evidence.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "npm-ci | npm Docs",
    "source_url": "https://docs.npmjs.com/cli/v11/commands/npm-ci",
    "checked_on": "2026-10-24",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-NPM-CI-LOCKFILE-MISMATCH-DEPENDENCY-BOUNDARY-01-v1",
    "candidate_record_sha256": "40ee18f39cfd53f0a635cdc0a5ff54678b4e4132310825e344795376a85547d2",
    "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": "npm’s package lock records a resolved dependency tree. npm ci requires a lockfile and fails when its dependencies disagree with package.json instead of updating the lock. Its installation does not rewrite the lock, and tree-shaping flags must match those used to create it. A version range alone is not this frozen-install evidence.",
    "required_buyer_context": "Reviewed lockfile hash and package manifest; npm version and tree-shaping configuration; Installation result and resolved dependency inventory. 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-24",
    "claim_to_check": "Does a compatible dependency range alone guarantee that npm installs the previously reviewed dependency tree?",
    "documented_statement": {
      "status": "documented",
      "statement": "npm’s package lock records a resolved dependency tree. npm ci requires a lockfile and fails when its dependencies disagree with package.json instead of updating the lock. Its installation does not rewrite the lock, and tree-shaping flags must match those used to create it. A version range alone is not this frozen-install evidence.",
      "source_ids": [
        "npm-ci",
        "npm-install",
        "npm-lock"
      ]
    },
    "review_inference": {
      "status": "review_inference",
      "statement": "Bind the reviewed lockfile, installer version and relevant flags to the installed tree.",
      "source_ids": [
        "npm-ci",
        "npm-install",
        "npm-lock"
      ]
    },
    "buyer_evidence_required": [
      "Reviewed lockfile hash and package manifest",
      "npm version and tree-shaping configuration",
      "Installation result and resolved dependency inventory"
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Refuse reproducibility claims based only on compatible version ranges."
    },
    "unknowns": "Runtime loading, platform differences and package safety remain unverified.",
    "unknown_finding": {
      "status": "unknown",
      "statement": "Runtime loading, platform differences and package safety remain unverified."
    },
    "evidence_sources": [
      {
        "source_id": "npm-ci",
        "url": "https://docs.npmjs.com/cli/v11/commands/npm-ci",
        "final_url": "https://docs.npmjs.com/cli/v11/commands/npm-ci/",
        "status": 200,
        "captured_at_utc": "2026-10-24T17:21:17.316Z",
        "sha256": "1f9795e15cfccb6282fa200cb2675210e3ab137707b9089d24021b0786352534",
        "bytes": 595865,
        "title": "npm-ci | npm Docs",
        "hash_basis": "Decoded HTTP response body bytes",
        "rights_review": "Factual paraphrase and source metadata only; raw source retained privately and not redistributed.",
        "checked_on": "2026-10-24",
        "capture_status": 200,
        "claim_review_completed": true,
        "reviewed_sections": [
          "Description",
          "Lockfile mismatch",
          "Frozen install",
          "Tree-shaping flags"
        ],
        "version_context": "npm CLI v11 documentation, displayed 11.21.1; installer version and configuration require separate verification."
      },
      {
        "source_id": "npm-install",
        "url": "https://docs.npmjs.com/cli/v11/commands/npm-install",
        "final_url": "https://docs.npmjs.com/cli/v11/commands/npm-install/",
        "status": 200,
        "captured_at_utc": "2026-10-24T17:21:17.479Z",
        "sha256": "066a1d294fe8cdc57aaee1dfb4dd1d719b59661cdd166bc0b7cd9a9ff0b5dddb",
        "bytes": 719804,
        "title": "npm-install | npm Docs",
        "hash_basis": "Decoded HTTP response body bytes",
        "rights_review": "Factual paraphrase and source metadata only; raw source retained privately and not redistributed.",
        "checked_on": "2026-10-24",
        "capture_status": 200,
        "claim_review_completed": true,
        "reviewed_sections": [
          "Description",
          "Package lock and dependency resolution"
        ],
        "version_context": "npm CLI v11 documentation, displayed 11.21.1; installer version and configuration require separate verification."
      },
      {
        "source_id": "npm-lock",
        "url": "https://docs.npmjs.com/cli/v11/configuring-npm/package-lock-json",
        "final_url": "https://docs.npmjs.com/cli/v11/configuring-npm/package-lock-json/",
        "status": 200,
        "captured_at_utc": "2026-10-24T17:21:17.486Z",
        "sha256": "18352371bc3b5bcbed18c1307ef940e82114705f562f533704d1aa820dc705b5",
        "bytes": 537925,
        "title": "package-lock.json | npm Docs",
        "hash_basis": "Decoded HTTP response body bytes",
        "rights_review": "Factual paraphrase and source metadata only; raw source retained privately and not redistributed.",
        "checked_on": "2026-10-24",
        "capture_status": 200,
        "claim_review_completed": true,
        "reviewed_sections": [
          "Description",
          "Resolved dependency tree"
        ],
        "version_context": "npm CLI v11 documentation, displayed 11.21.1; installer version and configuration require separate verification."
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Documentation review only; the buyer must establish applicability and actual outcomes. INDEX does not inspect or control the deployment.",
    "paid_value": {
      "decision_context": "Reduce accidental dependency drift in a reviewed agent integration.",
      "free": "Complete review, sources, practical questions 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": "Recheck the documented behavior, product version and buyer evidence before relying on a current outcome."
    },
    "buyer_relevance": "Reduce accidental dependency drift in a reviewed agent integration.",
    "refusal_conditions": [
      "Refuse reproducibility claims based only on compatible version ranges."
    ]
  },
  "niche": {
    "niche_id": "agent-authority-action-evidence",
    "label": "Agent Authority & Action Evidence",
    "classification_id": "dependency",
    "classification_label": "Dependency/Advisory Reliance Boundaries",
    "topic_id": "dependency",
    "buyer_intent": "Reduce accidental dependency drift in a reviewed agent integration.",
    "comparison_role": "supplementary_discovery"
  },
  "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#npm-ci-lockfile-mismatch-dependency-boundary",
  "machine_readable_record": "/varexis-index/records/npm-ci-lockfile-mismatch-dependency-boundary.json"
}
