Add fileoverview headers to npm Arborist modules

Add @fileoverview JSDoc headers to Arborist wrapper modules
for npm's dependency resolution integration.

Author: jdalton

src/shadow/npm/arborist/index.mts

@@ -1,3 +1,5 @@
+/** @fileoverview npm Arborist class installation and setup for Socket CLI. Provides safe Arborist wrappers that integrate security scanning into npm's dependency resolution process. */
+
 import { createRequire } from 'node:module'
 
 // @ts-ignore

src/shadow/npm/arborist/lib/arborist/index.mts

@@ -1,3 +1,5 @@
+/** @fileoverview Safe Arborist class implementation for Socket CLI. Extends npm's Arborist to intercept buildIdealTree and reify operations for security scanning before package installation. */
+
 // @ts-ignore
 import UntypedArborist from '@npmcli/arborist/lib/arborist/index.js'
 

src/shadow/npm/arborist/types.mts

@@ -1,3 +1,5 @@
+/** @fileoverview Type definitions for npm Arborist integration in Socket CLI. Extends @npmcli/arborist types with Socket-specific enhancements for dependency tree analysis and security scanning. */
+
 import { createEnum } from '../../../utils/objects.mts'
 
 import type {