From 6b32f8902302d9e4b500ef5b2b3051f5d6a21611 Mon Sep 17 00:00:00 2001
From: njevric <njevric9@gmail.com>
Date: Tue, 12 May 2026 23:14:07 +0200
Subject: [PATCH 1/7] feat: script runner view

---
 src/client/App.vue                      |  10 +-
 src/client/composables/useOperations.ts |   3 +
 src/client/composables/useScripts.ts    |  31 +++
 src/client/router.ts                    |   5 +
 src/client/stores/scripts.ts            | 134 ++++++++++
 src/client/views/ActivityView.vue       |   2 +
 src/client/views/ScriptsView.vue        | 315 ++++++++++++++++++++++++
 src/server/app.ts                       |   2 +
 src/server/routes/scripts.ts            | 107 ++++++++
 src/server/services/operationRunner.ts  |  22 +-
 src/shared/types.ts                     |  11 +-
 11 files changed, 638 insertions(+), 4 deletions(-)
 create mode 100644 src/client/composables/useScripts.ts
 create mode 100644 src/client/stores/scripts.ts
 create mode 100644 src/client/views/ScriptsView.vue
 create mode 100644 src/server/routes/scripts.ts

diff --git a/src/client/App.vue b/src/client/App.vue
index 1fbae6f..c8d2a6b 100644
--- a/src/client/App.vue
+++ b/src/client/App.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { RouterView, RouterLink } from 'vue-router'
-import { Package, ShieldAlert, Layers, Activity } from 'lucide-vue-next'
+import { Package, ShieldAlert, Layers, Activity, Terminal } from 'lucide-vue-next'
 </script>
 
 <template>
@@ -30,6 +30,14 @@ import { Package, ShieldAlert, Layers, Activity } from 'lucide-vue-next'
             <Layers class="h-4 w-4" />
             <span class="hidden sm:inline">Dependencies</span>
           </RouterLink>
+          <RouterLink
+            to="/scripts"
+            class="flex items-center gap-2 px-3 py-1.5 rounded-md text-sm font-medium text-muted-foreground transition-colors hover:text-foreground hover:bg-muted"
+            active-class="!text-foreground bg-muted"
+          >
+            <Terminal class="h-4 w-4" />
+            <span class="hidden sm:inline">Scripts</span>
+          </RouterLink>
           <RouterLink
             to="/security"
             class="flex items-center gap-2 px-3 py-1.5 rounded-md text-sm font-medium text-muted-foreground transition-colors hover:text-foreground hover:bg-muted"
diff --git a/src/client/composables/useOperations.ts b/src/client/composables/useOperations.ts
index dc1ee2f..ff61c5b 100644
--- a/src/client/composables/useOperations.ts
+++ b/src/client/composables/useOperations.ts
@@ -1,10 +1,12 @@
 import { ref, onMounted, onUnmounted } from 'vue'
 import { useQueryClient } from '@tanstack/vue-query'
 import { useOperationsStore } from '@/stores/operations'
+import { useScriptsStore } from '@/stores/scripts'
 import type { OperationEvent } from '@shared/types'
 
 export function useOperations() {
   const store = useOperationsStore()
+  const scriptsStore = useScriptsStore()
   const queryClient = useQueryClient()
   const isConnected = ref(false)
   let eventSource: EventSource | null = null
@@ -29,6 +31,7 @@ export function useOperations() {
         }
 
         store.handleEvent(data as OperationEvent)
+        scriptsStore.handleEvent(data as OperationEvent)
 
         if (data.type === 'complete' || data.type === 'error') {
           queryClient.invalidateQueries({ queryKey: ['operations', 'history'] })
diff --git a/src/client/composables/useScripts.ts b/src/client/composables/useScripts.ts
new file mode 100644
index 0000000..d098653
--- /dev/null
+++ b/src/client/composables/useScripts.ts
@@ -0,0 +1,31 @@
+import { useQuery, useMutation } from '@tanstack/vue-query'
+import { useApi } from './useApi'
+import type { ScriptDefinition } from '@shared/types'
+
+export function useScripts() {
+  const api = useApi()
+
+  const scripts = useQuery({
+    queryKey: ['scripts'],
+    queryFn: () => api.get<ScriptDefinition[]>('/scripts'),
+    staleTime: 60 * 1000,
+  })
+
+  const runScript = useMutation({
+    mutationFn: (name: string) =>
+      api.post<{ operationId: string }, Record<string, never>>(
+        `/scripts/${encodeURIComponent(name)}/run`,
+        {}
+      ),
+  })
+
+  const stopScript = useMutation({
+    mutationFn: ({ name, operationId }: { name: string; operationId: string }) =>
+      api.post<{ killed: boolean }, { operationId: string }>(
+        `/scripts/${encodeURIComponent(name)}/stop`,
+        { operationId }
+      ),
+  })
+
+  return { scripts, runScript, stopScript }
+}
diff --git a/src/client/router.ts b/src/client/router.ts
index 3779df2..374aa0d 100644
--- a/src/client/router.ts
+++ b/src/client/router.ts
@@ -24,6 +24,11 @@ const router = createRouter({
       name: 'security',
       component: () => import('./views/SecurityAuditView.vue'),
     },
+    {
+      path: '/scripts',
+      name: 'scripts',
+      component: () => import('./views/ScriptsView.vue'),
+    },
     {
       path: '/activity',
       name: 'activity',
diff --git a/src/client/stores/scripts.ts b/src/client/stores/scripts.ts
new file mode 100644
index 0000000..1628ac6
--- /dev/null
+++ b/src/client/stores/scripts.ts
@@ -0,0 +1,134 @@
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+import type { OperationEvent, OperationLogEntry } from '@shared/types'
+
+interface ScriptRun {
+  operationId: string
+  scriptName: string
+  startedAt: Date
+  status: 'running' | 'completed' | 'failed'
+  completedAt?: Date
+  exitCode?: number
+}
+
+const MAX_RUNS_PER_SCRIPT = 5
+
+export const useScriptsStore = defineStore('scripts', () => {
+  // operationId → ScriptRun
+  const runs = ref<Map<string, ScriptRun>>(new Map())
+  // operationId → logs
+  const logs = ref<Map<string, OperationLogEntry[]>>(new Map())
+  // scriptName → operationId (current/latest)
+  const activeRun = ref<Map<string, string>>(new Map())
+  // ordered list of operationIds per scriptName (most recent last)
+  const runHistory = ref<Map<string, string[]>>(new Map())
+
+  const scriptOperationIds = computed(() => new Set(runs.value.keys()))
+
+  function isRunning(scriptName: string): boolean {
+    const opId = activeRun.value.get(scriptName)
+    if (!opId) return false
+    return runs.value.get(opId)?.status === 'running'
+  }
+
+  function getRunsForScript(scriptName: string): ScriptRun[] {
+    const ids = runHistory.value.get(scriptName) ?? []
+    return ids.map((id) => runs.value.get(id)).filter((r): r is ScriptRun => r !== undefined)
+  }
+
+  function getLogsForRun(operationId: string): OperationLogEntry[] {
+    return logs.value.get(operationId) ?? []
+  }
+
+  function handleEvent(event: OperationEvent) {
+    if (event.type === 'start') {
+      if (event.operationType !== 'script') return
+      const scriptName = event.scriptName ?? event.operationId
+
+      const run: ScriptRun = {
+        operationId: event.operationId,
+        scriptName,
+        startedAt: new Date(),
+        status: 'running',
+      }
+      runs.value.set(event.operationId, run)
+      logs.value.set(event.operationId, [])
+      activeRun.value.set(scriptName, event.operationId)
+
+      const history = runHistory.value.get(scriptName) ?? []
+      history.push(event.operationId)
+      if (history.length > MAX_RUNS_PER_SCRIPT) {
+        const removed = history.splice(0, history.length - MAX_RUNS_PER_SCRIPT)
+        for (const id of removed) {
+          runs.value.delete(id)
+          logs.value.delete(id)
+        }
+      }
+      runHistory.value.set(scriptName, history)
+      return
+    }
+
+    if (!scriptOperationIds.value.has(event.operationId)) return
+
+    if (event.type === 'stdout' || event.type === 'stderr') {
+      const runLogs = logs.value.get(event.operationId)
+      if (runLogs) {
+        runLogs.push({
+          operationId: event.operationId,
+          timestamp: new Date(),
+          stream: event.type,
+          data: event.data,
+        })
+      }
+    } else if (event.type === 'complete') {
+      const run = runs.value.get(event.operationId)
+      if (run) {
+        run.status = event.exitCode === 0 ? 'completed' : 'failed'
+        run.completedAt = new Date()
+        run.exitCode = event.exitCode
+      }
+    } else if (event.type === 'error') {
+      const run = runs.value.get(event.operationId)
+      if (run) {
+        run.status = 'failed'
+        run.completedAt = new Date()
+      }
+      const runLogs = logs.value.get(event.operationId)
+      if (runLogs) {
+        runLogs.push({
+          operationId: event.operationId,
+          timestamp: new Date(),
+          stream: 'stderr',
+          data: event.error,
+        })
+      }
+    }
+  }
+
+  function clearRun(operationId: string) {
+    const run = runs.value.get(operationId)
+    if (!run) return
+    logs.value.delete(operationId)
+    runs.value.delete(operationId)
+    const history = runHistory.value.get(run.scriptName)
+    if (history) {
+      const idx = history.indexOf(operationId)
+      if (idx !== -1) history.splice(idx, 1)
+    }
+    if (activeRun.value.get(run.scriptName) === operationId) {
+      activeRun.value.delete(run.scriptName)
+    }
+  }
+
+  return {
+    runs,
+    logs,
+    activeRun,
+    runHistory,
+    isRunning,
+    getRunsForScript,
+    getLogsForRun,
+    handleEvent,
+    clearRun,
+  }
+})
diff --git a/src/client/views/ActivityView.vue b/src/client/views/ActivityView.vue
index 16c65f2..afcbdfe 100644
--- a/src/client/views/ActivityView.vue
+++ b/src/client/views/ActivityView.vue
@@ -23,6 +23,7 @@ const TYPE_BADGE: Record<ActivityType, string> = {
   audit: 'bg-blue-500/10 text-blue-700 dark:text-blue-400',
   'audit-fix': 'bg-green-500/10 text-green-700 dark:text-green-400',
   'audit-log': 'bg-blue-500/10 text-blue-700 dark:text-blue-400',
+  script: 'bg-purple-500/10 text-purple-700 dark:text-purple-400',
 }
 
 const TYPE_LABEL: Record<ActivityType, string> = {
@@ -32,6 +33,7 @@ const TYPE_LABEL: Record<ActivityType, string> = {
   audit: 'Audit',
   'audit-fix': 'Fix',
   'audit-log': 'Audit',
+  script: 'Script',
 }
 
 // ── Stats ──────────────────────────────────────────────────────────────────────
diff --git a/src/client/views/ScriptsView.vue b/src/client/views/ScriptsView.vue
new file mode 100644
index 0000000..2465cab
--- /dev/null
+++ b/src/client/views/ScriptsView.vue
@@ -0,0 +1,315 @@
+<script setup lang="ts">
+import { ref, computed, watch, nextTick } from 'vue'
+import { useScripts } from '@/composables/useScripts'
+import { useScriptsStore } from '@/stores/scripts'
+import { useOperations } from '@/composables/useOperations'
+import { Button } from '@/components/ui/button'
+import { Skeleton } from '@/components/ui/skeleton'
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
+import { Play, Square, Trash2, Terminal } from 'lucide-vue-next'
+import type { ScriptDefinition } from '@shared/types'
+
+const { scripts, runScript, stopScript } = useScripts()
+const store = useScriptsStore()
+useOperations()
+
+const selectedScript = ref<string | null>(null)
+const selectedRunId = ref<string | null>(null)
+const outputEl = ref<HTMLElement | null>(null)
+
+const scriptList = computed<ScriptDefinition[]>(() => scripts.data.value ?? [])
+const isLoading = computed(() => scripts.isLoading.value)
+
+// Select first script on load
+watch(scriptList, (list) => {
+  if (!selectedScript.value && list.length > 0) {
+    selectedScript.value = list[0].name
+  }
+}, { immediate: true })
+
+// Auto-select the latest run when script changes
+watch(selectedScript, (name) => {
+  if (!name) return
+  const runs = store.getRunsForScript(name)
+  selectedRunId.value = runs.length > 0 ? runs[runs.length - 1].operationId : null
+})
+
+const currentRuns = computed(() => {
+  if (!selectedScript.value) return []
+  return store.getRunsForScript(selectedScript.value)
+})
+
+const currentLogs = computed(() => {
+  if (!selectedRunId.value) return []
+  return store.getLogsForRun(selectedRunId.value)
+})
+
+const currentRun = computed(() => {
+  if (!selectedRunId.value) return null
+  return store.runs.get(selectedRunId.value) ?? null
+})
+
+// Scroll terminal to bottom when new logs arrive
+watch(currentLogs, () => {
+  nextTick(() => {
+    if (outputEl.value) {
+      outputEl.value.scrollTop = outputEl.value.scrollHeight
+    }
+  })
+}, { deep: true })
+
+function selectScript(name: string) {
+  selectedScript.value = name
+}
+
+function selectRun(operationId: string) {
+  selectedRunId.value = operationId
+}
+
+async function handleRun(name: string) {
+  const result = await runScript.mutateAsync(name)
+  selectedScript.value = name
+  selectedRunId.value = result.operationId
+}
+
+function handleStop(name: string) {
+  const opId = store.activeRun.get(name)
+  if (!opId) return
+  stopScript.mutate({ name, operationId: opId })
+}
+
+function handleClear(operationId: string) {
+  store.clearRun(operationId)
+  if (selectedRunId.value === operationId) {
+    const runs = selectedScript.value ? store.getRunsForScript(selectedScript.value) : []
+    selectedRunId.value = runs.length > 0 ? runs[runs.length - 1].operationId : null
+  }
+}
+
+function stripAnsi(text: string): string {
+   
+  return text.replace(/\x1B\[[0-9;]*[mGKHF]/g, '')
+}
+
+function formatRunLabel(operationId: string, idx: number): string {
+  const run = store.runs.get(operationId)
+  if (!run) return `Run ${idx + 1}`
+  const time = run.startedAt.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' })
+  return `Run ${idx + 1} · ${time}`
+}
+
+function runStatusClass(operationId: string): string {
+  const run = store.runs.get(operationId)
+  if (!run) return ''
+  if (run.status === 'running') return 'text-blue-600'
+  if (run.status === 'completed') return 'text-green-600'
+  if (run.status === 'failed') return 'text-red-600'
+  return ''
+}
+</script>
+
+<template>
+  <div class="space-y-4">
+    <div class="flex items-center gap-2">
+      <Terminal class="h-5 w-5 text-muted-foreground" />
+      <h1 class="text-xl font-semibold">
+        Scripts
+      </h1>
+    </div>
+
+    <div class="grid grid-cols-1 lg:grid-cols-[260px_1fr] gap-4 min-h-[500px]">
+      <!-- Script list -->
+      <Card class="flex flex-col max-h-[90vh]">
+        <CardHeader class="pb-3 flex-shrink-0">
+          <CardTitle class="text-sm font-medium text-muted-foreground uppercase tracking-wide">
+            package.json scripts
+          </CardTitle>
+        </CardHeader>
+        <CardContent class="p-0 overflow-y-auto">
+          <div
+            v-if="isLoading"
+            class="space-y-2 px-4 pb-4"
+          >
+            <Skeleton
+              v-for="i in 4"
+              :key="i"
+              class="h-10 w-full"
+            />
+          </div>
+
+          <div
+            v-else-if="scriptList.length === 0"
+            class="px-4 pb-4 text-sm text-muted-foreground"
+          >
+            No scripts found in package.json
+          </div>
+
+          <ul
+            v-else
+            class="divide-y"
+          >
+            <li
+              v-for="script in scriptList"
+              :key="script.name"
+              class="cursor-pointer"
+              @click="selectScript(script.name)"
+            >
+              <div
+                class="flex items-center justify-between px-4 py-3 hover:bg-muted/50 transition-colors"
+                :class="selectedScript === script.name ? 'bg-muted' : ''"
+              >
+                <div class="min-w-0 flex-1">
+                  <p
+                    class="text-sm font-medium truncate"
+                    :title="script.name"
+                  >
+                    {{ script.name }}
+                  </p>
+                  <p
+                    class="text-xs text-muted-foreground mt-0.5 break-all"
+                  >
+                    {{ script.command }}
+                  </p>
+                </div>
+                <div class="ml-2 flex-shrink-0">
+                  <div
+                    v-if="store.isRunning(script.name)"
+                    class="h-2 w-2 rounded-full bg-blue-500 animate-pulse"
+                  />
+                </div>
+              </div>
+            </li>
+          </ul>
+        </CardContent>
+      </Card>
+
+      <!-- Terminal pane -->
+      <Card class="flex flex-col max-h-[90vh]">
+        <CardHeader class="pb-0 flex-shrink-0">
+          <div class="flex items-center justify-between">
+            <CardTitle class="text-sm">
+              <span
+                v-if="selectedScript"
+                class="font-mono"
+              >{{ selectedScript }}</span>
+              <span
+                v-else
+                class="text-muted-foreground"
+              >Select a script</span>
+            </CardTitle>
+            <div class="flex items-center gap-2">
+              <Button
+                v-if="selectedScript && store.isRunning(selectedScript)"
+                size="sm"
+                variant="outline"
+                class="h-7 text-xs border-red-200 text-red-600 hover:bg-red-50 hover:text-red-700"
+                :disabled="stopScript.isPending.value"
+                @click="handleStop(selectedScript)"
+              >
+                <Square class="h-3 w-3 mr-1" />
+                Stop
+              </Button>
+              <Button
+                v-else-if="selectedScript"
+                size="sm"
+                class="h-7 text-xs"
+                :disabled="runScript.isPending.value"
+                @click="handleRun(selectedScript)"
+              >
+                <Play class="h-3 w-3 mr-1" />
+                Run
+              </Button>
+            </div>
+          </div>
+
+          <!-- Run tabs -->
+          <div
+            v-if="currentRuns.length > 0"
+            class="flex items-center gap-1 mt-3 flex-wrap"
+          >
+            <button
+              v-for="(run, idx) in currentRuns"
+              :key="run.operationId"
+              class="flex items-center gap-1.5 px-2.5 py-1 text-xs rounded-md border transition-colors"
+              :class="
+                selectedRunId === run.operationId
+                  ? 'bg-muted border-border font-medium'
+                  : 'border-transparent hover:bg-muted/50 text-muted-foreground'
+              "
+              @click="selectRun(run.operationId)"
+            >
+              <span :class="runStatusClass(run.operationId)">●</span>
+              {{ formatRunLabel(run.operationId, idx) }}
+              <button
+                class="ml-1 hover:text-destructive"
+                @click.stop="handleClear(run.operationId)"
+              >
+                <Trash2 class="h-3 w-3" />
+              </button>
+            </button>
+          </div>
+        </CardHeader>
+
+        <CardContent class="flex-1 p-0 mt-3 overflow-hidden">
+          <!-- Empty state -->
+          <div
+            v-if="!selectedScript"
+            class="h-full flex items-center justify-center text-sm text-muted-foreground"
+          >
+            Select a script from the left to get started
+          </div>
+
+          <div
+            v-else-if="currentRuns.length === 0"
+            class="h-full flex flex-col items-center justify-center gap-3 text-sm text-muted-foreground"
+          >
+            <Terminal class="h-8 w-8 opacity-30" />
+            <p>Click <strong>Run</strong> to execute this script</p>
+          </div>
+
+          <!-- Log output -->
+          <div
+            v-else
+            ref="outputEl"
+            class="h-full overflow-y-auto font-mono text-xs bg-zinc-950 text-zinc-100 p-4 rounded-b-lg"
+          >
+            <div
+              v-if="currentRun?.status === 'running'"
+              class="text-blue-400 mb-2"
+            >
+              ▶ Running…
+            </div>
+            <div
+              v-else-if="currentRun?.status === 'completed'"
+              class="text-green-400 mb-2"
+            >
+              ✔ Exited with code {{ currentRun.exitCode }}
+            </div>
+            <div
+              v-else-if="currentRun?.status === 'failed'"
+              class="text-red-400 mb-2"
+            >
+              ✖ Exited with code {{ currentRun.exitCode }}
+            </div>
+
+            <div
+              v-for="(log, i) in currentLogs"
+              :key="i"
+              :class="log.stream === 'stderr' ? 'text-red-400' : 'text-zinc-100'"
+              class="whitespace-pre-wrap break-all leading-5"
+            >
+              {{ stripAnsi(log.data) }}
+            </div>
+
+            <div
+              v-if="currentLogs.length === 0 && currentRun?.status === 'running'"
+              class="text-zinc-500"
+            >
+              Waiting for output…
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  </div>
+</template>
diff --git a/src/server/app.ts b/src/server/app.ts
index 85aa495..683f1a1 100644
--- a/src/server/app.ts
+++ b/src/server/app.ts
@@ -7,6 +7,7 @@ import { createRegistryRouter } from './routes/registry.js'
 import { createOperationsRouter } from './routes/operations.js'
 import { createProjectRouter } from './routes/project.js'
 import { createAuditRouter } from './routes/audit.js'
+import { createScriptsRouter } from './routes/scripts.js'
 
 export function createServer(projectPath: string, clientDistPath: string, port?: number, token?: string): Express {
   const app = express()
@@ -32,6 +33,7 @@ export function createServer(projectPath: string, clientDistPath: string, port?:
   app.use('/api/operations', createOperationsRouter(projectPath))
   app.use('/api/project', createProjectRouter(projectPath))
   app.use('/api/audit', createAuditRouter(projectPath))
+  app.use('/api/scripts', createScriptsRouter(projectPath))
 
   if (existsSync(clientDistPath)) {
     const rawHtml = readFileSync(join(clientDistPath, 'index.html'), 'utf-8')
diff --git a/src/server/routes/scripts.ts b/src/server/routes/scripts.ts
new file mode 100644
index 0000000..7497dd4
--- /dev/null
+++ b/src/server/routes/scripts.ts
@@ -0,0 +1,107 @@
+import { Router, type Request, type Response } from 'express'
+import { readPackageJson } from '../services/packageJson.js'
+import { runCommand, killOperation, getOperationStatus } from '../services/operationRunner.js'
+import type { ApiResponse, ScriptDefinition } from '@shared/types'
+
+type ParamsDictionary = Record<string, string>
+
+export function createScriptsRouter(projectPath: string): Router {
+  const router = Router()
+
+  // Map scriptName → operationId for currently running scripts
+  const runningScripts = new Map<string, string>()
+
+  // GET /api/scripts — list all scripts from package.json
+  router.get('/', (_req: Request, res: Response) => {
+    try {
+      const pkg = readPackageJson(projectPath)
+      const scripts: ScriptDefinition[] = Object.entries(pkg.scripts ?? {}).map(
+        ([name, command]) => ({ name, command })
+      )
+      const response: ApiResponse<ScriptDefinition[]> = { success: true, data: scripts }
+      res.json(response)
+    } catch (error) {
+      const response: ApiResponse<never> = {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to read scripts',
+      }
+      res.status(500).json(response)
+    }
+  })
+
+  // POST /api/scripts/:name/run — run a script
+  router.post('/:name/run', (req: Request<ParamsDictionary>, res: Response) => {
+    const name = req.params.name
+
+    try {
+      const pkg = readPackageJson(projectPath)
+      const command = pkg.scripts?.[name]
+
+      if (!command) {
+        const response: ApiResponse<never> = { success: false, error: `Script "${name}" not found` }
+        res.status(404).json(response)
+        return
+      }
+
+      // Only one instance of each script at a time
+      const existingOpId = runningScripts.get(name)
+      if (existingOpId) {
+        const op = getOperationStatus(existingOpId)
+        if (op && (op.status === 'pending' || op.status === 'running')) {
+          const response: ApiResponse<never> = {
+            success: false,
+            error: `Script "${name}" is already running`,
+          }
+          res.status(409).json(response)
+          return
+        }
+      }
+
+      const operationId = runCommand(
+        `npm run ${name}`,
+        projectPath,
+        'script',
+        undefined,
+        undefined,
+        name
+      )
+
+      runningScripts.set(name, operationId)
+
+      const response: ApiResponse<{ operationId: string }> = {
+        success: true,
+        data: { operationId },
+      }
+      res.json(response)
+    } catch (error) {
+      const response: ApiResponse<never> = {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to run script',
+      }
+      res.status(500).json(response)
+    }
+  })
+
+  // POST /api/scripts/:name/stop — stop a running script
+  router.post('/:name/stop', (req: Request<ParamsDictionary>, res: Response) => {
+    const name = req.params.name
+    const operationId = (req.body as { operationId?: string }).operationId ?? runningScripts.get(name)
+
+    if (!operationId) {
+      const response: ApiResponse<never> = {
+        success: false,
+        error: `No running instance found for script "${name}"`,
+      }
+      res.status(404).json(response)
+      return
+    }
+
+    const killed = killOperation(operationId)
+    runningScripts.delete(name)
+
+    const response: ApiResponse<{ killed: boolean }> = { success: true, data: { killed } }
+    res.json(response)
+  })
+
+  return router
+}
diff --git a/src/server/services/operationRunner.ts b/src/server/services/operationRunner.ts
index 35d52a2..4196e87 100644
--- a/src/server/services/operationRunner.ts
+++ b/src/server/services/operationRunner.ts
@@ -13,6 +13,9 @@ function generateOperationId(): string {
 // Store active operations
 const activeOperations = new Map<string, Operation>()
 
+// Store active child processes for kill support
+const activeProcesses = new Map<string, ReturnType<typeof spawn>>()
+
 // Event emitter for SSE
 export const operationEvents = new EventEmitter()
 
@@ -24,7 +27,8 @@ export function runCommand(
   cwd: string,
   type: Operation['type'],
   packageName?: string,
-  fromVersion?: string
+  fromVersion?: string,
+  scriptName?: string
 ): string {
   const operationId = generateOperationId()
 
@@ -32,6 +36,7 @@ export function runCommand(
     id: operationId,
     type,
     packageName,
+    scriptName,
     fromVersion,
     command,
     status: 'pending',
@@ -61,6 +66,7 @@ async function executeCommand(operationId: string, command: string, cwd: string)
     command,
     operationType: operation.type,
     packageName: operation.packageName,
+    scriptName: operation.scriptName,
     fromVersion: operation.fromVersion,
   }
   operationEvents.emit('event', startEvent)
@@ -77,6 +83,7 @@ async function executeCommand(operationId: string, command: string, cwd: string)
       cwd,
       env: { ...process.env, FORCE_COLOR: '1' },
     })
+    activeProcesses.set(operationId, childProcess)
   } catch (error) {
     const errorEvent: OperationEvent = {
       type: 'error',
@@ -132,6 +139,8 @@ async function executeCommand(operationId: string, command: string, cwd: string)
     }
     operationEvents.emit('event', completeEvent)
 
+    activeProcesses.delete(operationId)
+
     // Clean up after a delay
     setTimeout(() => {
       activeOperations.delete(operationId)
@@ -142,6 +151,7 @@ async function executeCommand(operationId: string, command: string, cwd: string)
   childProcess.on('error', (error) => {
     operation.status = 'failed'
     operation.completedAt = new Date()
+    activeProcesses.delete(operationId)
 
     const errorEvent: OperationEvent = {
       type: 'error',
@@ -165,3 +175,13 @@ export function getOperationStatus(operationId: string): Operation | undefined {
 export function getActiveOperations(): Operation[] {
   return Array.from(activeOperations.values())
 }
+
+/**
+ * Kills a running operation by its ID
+ */
+export function killOperation(operationId: string): boolean {
+  const process = activeProcesses.get(operationId)
+  if (!process) return false
+  process.kill()
+  return true
+}
diff --git a/src/shared/types.ts b/src/shared/types.ts
index add64c6..9b3f305 100644
--- a/src/shared/types.ts
+++ b/src/shared/types.ts
@@ -44,8 +44,9 @@ export type PackageManager = 'npm' | 'yarn' | 'pnpm'
 // Operation types
 export interface Operation {
   id: string
-  type: 'install' | 'update' | 'remove' | 'audit' | 'audit-fix'
+  type: 'install' | 'update' | 'remove' | 'audit' | 'audit-fix' | 'script'
   packageName?: string
+  scriptName?: string
   fromVersion?: string
   toVersion?: string
   command: string
@@ -55,6 +56,12 @@ export interface Operation {
   exitCode?: number
 }
 
+// Script types
+export interface ScriptDefinition {
+  name: string
+  command: string
+}
+
 export interface OperationLogEntry {
   operationId: string
   timestamp: Date
@@ -64,7 +71,7 @@ export interface OperationLogEntry {
 
 // SSE Event types
 export type OperationEvent =
-  | { type: 'start'; operationId: string; command: string; operationType: Operation['type']; packageName?: string; fromVersion?: string }
+  | { type: 'start'; operationId: string; command: string; operationType: Operation['type']; packageName?: string; scriptName?: string; fromVersion?: string }
   | { type: 'stdout'; operationId: string; data: string }
   | { type: 'stderr'; operationId: string; data: string }
   | { type: 'complete'; operationId: string; exitCode: number; fromVersion?: string; toVersion?: string }

From 48e98c13979fee4a72fdc12661892ace8d9d6b2d Mon Sep 17 00:00:00 2001
From: njevric <njevric9@gmail.com>
Date: Tue, 12 May 2026 23:38:10 +0200
Subject: [PATCH 2/7] style: dark mode

---
 src/client/App.vue                            | 74 +++++++++++++++++--
 .../components/packages/PackageItem.vue       |  2 +-
 .../components/packages/PackageList.vue       |  1 +
 src/client/composables/useTheme.ts            | 30 ++++++++
 src/client/stores/ui.ts                       | 25 +------
 5 files changed, 104 insertions(+), 28 deletions(-)
 create mode 100644 src/client/composables/useTheme.ts

diff --git a/src/client/App.vue b/src/client/App.vue
index c8d2a6b..93b6713 100644
--- a/src/client/App.vue
+++ b/src/client/App.vue
@@ -1,14 +1,33 @@
 <script setup lang="ts">
+import { computed } from 'vue'
 import { RouterView, RouterLink } from 'vue-router'
-import { Package, ShieldAlert, Layers, Activity, Terminal } from 'lucide-vue-next'
+import { Package, ShieldAlert, Layers, Activity, Terminal, Sun, Moon, Monitor, Check } from 'lucide-vue-next'
+import {
+  DropdownMenuRoot,
+  DropdownMenuTrigger,
+  DropdownMenuPortal,
+  DropdownMenuContent,
+  DropdownMenuItem,
+} from 'radix-vue'
+import { useTheme } from '@/composables/useTheme'
+import { Button } from '@/components/ui/button'
+
+const { theme, setTheme } = useTheme()
+
+const ThemeIcon = computed(() =>
+  theme.value === 'dark' ? Moon : theme.value === 'light' ? Sun : Monitor
+)
+
+const themeOptions = [
+  { value: 'light', label: 'Light', icon: Sun },
+  { value: 'dark', label: 'Dark', icon: Moon },
+  { value: 'system', label: 'System', icon: Monitor },
+] as const
 </script>
 
 <template>
-  <div
-    class="min-h-screen"
-    style="background-color: #fafbfc"
-  >
-    <header class="border-b">
+  <div class="min-h-screen bg-background text-foreground">
+    <header class="border-b bg-background">
       <div class="container mx-auto flex h-14 items-center justify-between px-4 sm:px-6">
         <div class="flex items-center gap-2.5">
           <span class="text-xl font-bold tracking-tight">Packy</span>
@@ -54,11 +73,54 @@ import { Package, ShieldAlert, Layers, Activity, Terminal } from 'lucide-vue-nex
             <Activity class="h-4 w-4" />
             <span class="hidden sm:inline">Activity</span>
           </RouterLink>
+
+          <div class="w-px h-4 bg-border mx-1 shrink-0" />
+
+          <DropdownMenuRoot>
+            <DropdownMenuTrigger as-child>
+              <Button
+                variant="ghost"
+                size="icon"
+                class="h-8 w-8 shrink-0"
+              >
+                <component
+                  :is="ThemeIcon"
+                  class="h-4 w-4"
+                />
+              </Button>
+            </DropdownMenuTrigger>
+            <DropdownMenuPortal>
+              <DropdownMenuContent
+                align="end"
+                :side-offset="6"
+                class="z-50 min-w-[140px] overflow-hidden rounded-md border bg-popover text-popover-foreground shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 p-1"
+              >
+                <DropdownMenuItem
+                  v-for="opt in themeOptions"
+                  :key="opt.value"
+                  class="flex items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none cursor-default select-none transition-colors hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground"
+                  @click="setTheme(opt.value)"
+                >
+                  <component
+                    :is="opt.icon"
+                    class="h-4 w-4 text-muted-foreground"
+                  />
+                  <span class="flex-1">{{ opt.label }}</span>
+                  <Check
+                    v-if="theme === opt.value"
+                    class="h-3.5 w-3.5"
+                  />
+                </DropdownMenuItem>
+              </DropdownMenuContent>
+            </DropdownMenuPortal>
+          </DropdownMenuRoot>
         </nav>
       </div>
     </header>
+
     <main class="container mx-auto py-6 px-4 sm:px-6">
       <RouterView />
     </main>
+
   </div>
 </template>
diff --git a/src/client/components/packages/PackageItem.vue b/src/client/components/packages/PackageItem.vue
index b28dcf5..034f657 100644
--- a/src/client/components/packages/PackageItem.vue
+++ b/src/client/components/packages/PackageItem.vue
@@ -31,7 +31,7 @@ const isVersionPickerOpen = ref(false)
 
 <template>
   <div
-    class="flex items-center justify-between p-4 rounded-lg border bg-white hover:bg-accent/50 transition-colors cursor-pointer gap-3"
+    class="flex items-center justify-between p-4 rounded-lg border bg-card text-card-foreground hover:bg-accent/50 transition-colors cursor-pointer gap-3"
     @click="emit('select', package.name)"
   >
     <div class="flex-1 min-w-0">
diff --git a/src/client/components/packages/PackageList.vue b/src/client/components/packages/PackageList.vue
index c26edfa..3eca558 100644
--- a/src/client/components/packages/PackageList.vue
+++ b/src/client/components/packages/PackageList.vue
@@ -25,6 +25,7 @@ const emit = defineEmits<{
 const packagesRef = computed(() => props.packages)
 const { query, filter, filtered, counts, setQuery, setFilter } = useSearch(packagesRef)
 
+
 const filters: { value: FilterType; label: string; countKey: keyof typeof counts.value }[] = [
   { value: 'all', label: 'All', countKey: 'total' },
   { value: 'outdated', label: 'Outdated', countKey: 'outdated' },
diff --git a/src/client/composables/useTheme.ts b/src/client/composables/useTheme.ts
new file mode 100644
index 0000000..ae41e0c
--- /dev/null
+++ b/src/client/composables/useTheme.ts
@@ -0,0 +1,30 @@
+import { ref } from 'vue'
+
+type Theme = 'system' | 'light' | 'dark'
+
+const STORAGE_KEY = 'packy-theme'
+const theme = ref<Theme>((localStorage.getItem(STORAGE_KEY) as Theme) ?? 'system')
+const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
+
+function apply() {
+  const isDark = theme.value === 'dark' || (theme.value === 'system' && mediaQuery.matches)
+  document.documentElement.classList.toggle('dark', isDark)
+}
+
+mediaQuery.addEventListener('change', apply)
+apply()
+
+export function useTheme() {
+  function setTheme(value: Theme) {
+    theme.value = value
+    localStorage.setItem(STORAGE_KEY, value)
+    apply()
+  }
+
+  function toggleTheme() {
+    const cycle: Theme[] = ['light', 'dark', 'system']
+    setTheme(cycle[(cycle.indexOf(theme.value) + 1) % cycle.length])
+  }
+
+  return { theme, setTheme, toggleTheme }
+}
diff --git a/src/client/stores/ui.ts b/src/client/stores/ui.ts
index 59b6202..f71291d 100644
--- a/src/client/stores/ui.ts
+++ b/src/client/stores/ui.ts
@@ -2,34 +2,17 @@ import { defineStore } from 'pinia'
 import { ref } from 'vue'
 
 export const useUiStore = defineStore('ui', () => {
-  // Dialog states
   const isOperationLogOpen = ref(false)
-
-  // Selected package for detail view
   const selectedPackage = ref<string | null>(null)
 
-  // Actions
-  function openOperationLog() {
-    isOperationLogOpen.value = true
-  }
-
-  function closeOperationLog() {
-    isOperationLogOpen.value = false
-  }
-
-  function toggleOperationLog() {
-    isOperationLogOpen.value = !isOperationLogOpen.value
-  }
-
-  function selectPackage(name: string | null) {
-    selectedPackage.value = name
-  }
+  function openOperationLog() { isOperationLogOpen.value = true }
+  function closeOperationLog() { isOperationLogOpen.value = false }
+  function toggleOperationLog() { isOperationLogOpen.value = !isOperationLogOpen.value }
+  function selectPackage(name: string | null) { selectedPackage.value = name }
 
   return {
-    // State
     isOperationLogOpen,
     selectedPackage,
-    // Actions
     openOperationLog,
     closeOperationLog,
     toggleOperationLog,

From 6d9bb17891cf0d129a9c73d2dcba3438181aa462 Mon Sep 17 00:00:00 2001
From: njevric <njevric9@gmail.com>
Date: Tue, 12 May 2026 23:39:49 +0200
Subject: [PATCH 3/7] fix: lint errors

---
 src/client/App.vue                         | 1 -
 src/client/components/ui/badge/Badge.vue   | 1 +
 src/client/components/ui/button/Button.vue | 1 +
 3 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/client/App.vue b/src/client/App.vue
index 93b6713..8ebc79a 100644
--- a/src/client/App.vue
+++ b/src/client/App.vue
@@ -121,6 +121,5 @@ const themeOptions = [
     <main class="container mx-auto py-6 px-4 sm:px-6">
       <RouterView />
     </main>
-
   </div>
 </template>
diff --git a/src/client/components/ui/badge/Badge.vue b/src/client/components/ui/badge/Badge.vue
index 3800e7c..2073cdb 100644
--- a/src/client/components/ui/badge/Badge.vue
+++ b/src/client/components/ui/badge/Badge.vue
@@ -9,6 +9,7 @@ interface Props {
 
 const props = withDefaults(defineProps<Props>(), {
   variant: 'default',
+  class: undefined,
 })
 </script>
 
diff --git a/src/client/components/ui/button/Button.vue b/src/client/components/ui/button/Button.vue
index f2eae50..556df95 100644
--- a/src/client/components/ui/button/Button.vue
+++ b/src/client/components/ui/button/Button.vue
@@ -14,6 +14,7 @@ const props = withDefaults(defineProps<Props>(), {
   as: 'button',
   variant: 'default',
   size: 'default',
+  class: undefined,
 })
 
 const delegatedProps = computed(() => {

From 0d094400aced859b936e539a2bf3b8a9b81d707e Mon Sep 17 00:00:00 2001
From: njevric <njevric9@gmail.com>
Date: Wed, 13 May 2026 00:03:29 +0200
Subject: [PATCH 4/7] feat: unused dependencies

---
 package-lock.json                             | 837 +++++++++++++++++-
 package.json                                  |   2 +
 .../components/packages/DepcheckPanel.vue     | 225 +++++
 .../components/packages/PackageList.vue       | 126 ++-
 .../components/packages/SmartFiltersPanel.vue | 225 +++++
 src/client/composables/useDepcheck.ts         |  37 +
 src/client/composables/useSmartFilters.ts     | 119 +++
 src/client/views/DependenciesView.vue         |  14 +-
 src/server/app.ts                             |   2 +
 src/server/routes/depcheck.ts                 |  48 +
 src/server/routes/packages.ts                 |  19 +-
 src/server/services/depcheckService.ts        |  27 +
 src/server/services/registryClient.ts         |  63 ++
 src/shared/types.ts                           |  15 +
 14 files changed, 1707 insertions(+), 52 deletions(-)
 create mode 100644 src/client/components/packages/DepcheckPanel.vue
 create mode 100644 src/client/components/packages/SmartFiltersPanel.vue
 create mode 100644 src/client/composables/useDepcheck.ts
 create mode 100644 src/client/composables/useSmartFilters.ts
 create mode 100644 src/server/routes/depcheck.ts
 create mode 100644 src/server/services/depcheckService.ts

diff --git a/package-lock.json b/package-lock.json
index 6c976a3..9e5d1ca 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -10,6 +10,7 @@
       "license": "MIT",
       "dependencies": {
         "cors": "^2.8.6",
+        "depcheck": "^1.4.7",
         "express": "^5.2.1",
         "get-port": "^7.2.0",
         "open": "^11.0.0",
@@ -120,11 +121,24 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@babel/code-frame": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz",
+      "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
     "node_modules/@babel/generator": {
       "version": "7.29.1",
       "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.1.tgz",
       "integrity": "sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/parser": "^7.29.0",
@@ -137,11 +151,19 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/@babel/helper-globals": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
+      "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
     "node_modules/@babel/helper-string-parser": {
       "version": "7.27.1",
       "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
       "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=6.9.0"
@@ -151,7 +173,6 @@
       "version": "7.28.5",
       "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
       "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=6.9.0"
@@ -161,7 +182,6 @@
       "version": "7.29.3",
       "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.3.tgz",
       "integrity": "sha512-b3ctpQwp+PROvU/cttc4OYl4MzfJUWy6FZg+PMXfzmt/+39iHVF0sDfqay8TQM3JA2EUOyKcFZt75jWriQijsA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/types": "^7.29.0"
@@ -173,11 +193,42 @@
         "node": ">=6.0.0"
       }
     },
+    "node_modules/@babel/template": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz",
+      "integrity": "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.28.6",
+        "@babel/parser": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/traverse": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.0.tgz",
+      "integrity": "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.0",
+        "@babel/generator": "^7.29.0",
+        "@babel/helper-globals": "^7.28.0",
+        "@babel/parser": "^7.29.0",
+        "@babel/template": "^7.28.6",
+        "@babel/types": "^7.29.0",
+        "debug": "^4.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
     "node_modules/@babel/types": {
       "version": "7.29.0",
       "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz",
       "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/helper-string-parser": "^7.27.1",
@@ -1089,7 +1140,6 @@
       "version": "0.3.13",
       "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
       "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@jridgewell/sourcemap-codec": "^1.5.0",
@@ -1111,7 +1161,6 @@
       "version": "3.1.2",
       "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
       "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=6.0.0"
@@ -1121,14 +1170,12 @@
       "version": "1.5.5",
       "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
       "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@jridgewell/trace-mapping": {
       "version": "0.3.31",
       "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
       "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@jridgewell/resolve-uri": "^3.1.0",
@@ -2279,6 +2326,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/minimatch": {
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/@types/minimatch/-/minimatch-3.0.5.tgz",
+      "integrity": "sha512-Klz949h02Gz2uZCMGwDUSDS1YBlTdDDgbWHi+81l29tQALUtvz4rAYi5uoVhE5Lagoq6DeqAUlbrHvW/mXDgdQ==",
+      "license": "MIT"
+    },
     "node_modules/@types/node": {
       "version": "25.6.2",
       "resolved": "https://registry.npmjs.org/@types/node/-/node-25.6.2.tgz",
@@ -2289,6 +2342,12 @@
         "undici-types": "~7.19.0"
       }
     },
+    "node_modules/@types/parse-json": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/@types/parse-json/-/parse-json-4.0.2.tgz",
+      "integrity": "sha512-dISoDXWWQwUquiKsyZ4Ng+HX2KsPL7LyHKHQwgGFEA3IaKac4Obd+h2a/a6waisAoepJlBcx9paWqjA8/HVjCw==",
+      "license": "MIT"
+    },
     "node_modules/@types/qs": {
       "version": "6.15.1",
       "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.15.1.tgz",
@@ -2769,7 +2828,6 @@
       "version": "3.5.34",
       "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.34.tgz",
       "integrity": "sha512-s9cLyK5mLcvZ4Agva5QgRsQyLKvts9WbU9DB6NqiZkkGEdwmcEiylj5Jbwkp680drF/NNCV8OlAJSe+yMLxaJw==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/parser": "^7.29.3",
@@ -2783,7 +2841,6 @@
       "version": "3.5.34",
       "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.34.tgz",
       "integrity": "sha512-EbF/T++k0e2MMZlJsBhzK8Sgwt0HcIPOhzn1CTB/lv6sQcyk+OWf8YeiLxZp3ro7MbbLcAfAJ6sEvjFWuNgUCw==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@vue/compiler-core": "3.5.34",
@@ -2794,7 +2851,6 @@
       "version": "3.5.34",
       "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.34.tgz",
       "integrity": "sha512-D/ihr6uZeIt6r+pVZf46RWT1fAsLFMbUP7k8G1VkiiWexriED9GrX3echHd4Abbt17zjlfiFJ8z7a3BxZOPNjg==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/parser": "^7.29.3",
@@ -2812,7 +2868,6 @@
       "version": "3.5.34",
       "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.34.tgz",
       "integrity": "sha512-cDtTHKibkThKGHH1SP+WdccquNRYQDFH6rRjQCqT9G2ltFAfoR5pUftpab/z+aM5mW9HLLVQW7hfKKQe/1GBeQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@vue/compiler-dom": "3.5.34",
@@ -2920,7 +2975,6 @@
       "version": "3.5.34",
       "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.34.tgz",
       "integrity": "sha512-24uqU4OIiX29ryC3MeWid/Xf2fa2EFRUVLb77nRhk+UrTVrh/XiGtFAFmJBAtBRbjwNdsPRP+jj/OL27Eg1NDA==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/@vue/test-utils": {
@@ -3072,7 +3126,6 @@
       "version": "4.3.0",
       "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
       "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "color-convert": "^2.0.1"
@@ -3091,6 +3144,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "license": "MIT",
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
     "node_modules/aria-hidden": {
       "version": "1.2.6",
       "resolved": "https://registry.npmjs.org/aria-hidden/-/aria-hidden-1.2.6.tgz",
@@ -3104,6 +3166,33 @@
         "node": ">=10"
       }
     },
+    "node_modules/array-differ": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/array-differ/-/array-differ-3.0.0.tgz",
+      "integrity": "sha512-THtfYS6KtME/yIAhKjZ2ul7XI96lQGHRputJQHO80LAWQnuGP4iCIN8vdMRboGbIEYBwU33q8Tch1os2+X0kMg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/array-union": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",
+      "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/arrify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/arrify/-/arrify-2.0.1.tgz",
+      "integrity": "sha512-3duEwti880xqi4eAMN8AyR4a0ByT90zoYdLlevfrvU43vb0YZwZVfxOgxWrLXXXpyugL0hNZc9G6BiB5B3nUug==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/assertion-error": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
@@ -3272,6 +3361,18 @@
         "node": "18 || 20 || >=22"
       }
     },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "license": "MIT",
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/browserslist": {
       "version": "4.28.2",
       "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.2.tgz",
@@ -3385,6 +3486,35 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/callsite": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/callsite/-/callsite-1.0.0.tgz",
+      "integrity": "sha512-0vdNRFXn5q+dtOqjfFtmtlI9N2eVZ7LMyEV2iKC5mEEFvSg/69Ml6b/WU2qF8W1nLRa0wiSrDT3Y5jOHZCwKPQ==",
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/callsites": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
+      "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/camelcase": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz",
+      "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/caniuse-lite": {
       "version": "1.0.30001792",
       "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001792.tgz",
@@ -3567,7 +3697,6 @@
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
       "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "color-name": "~1.1.4"
@@ -3580,7 +3709,6 @@
       "version": "1.1.4",
       "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
       "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/commander": {
@@ -3593,6 +3721,12 @@
         "node": ">=14"
       }
     },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "license": "MIT"
+    },
     "node_modules/concurrently": {
       "version": "9.2.1",
       "resolved": "https://registry.npmjs.org/concurrently/-/concurrently-9.2.1.tgz",
@@ -3726,6 +3860,31 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/cosmiconfig": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-7.1.0.tgz",
+      "integrity": "sha512-AdmX6xUzdNASswsFtmwSt7Vj8po9IuqXm0UXz7QKPuEUmPB4XyjGfaAr2PSuELMwkRMVH1EpIkX5bTZGRB3eCA==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/parse-json": "^4.0.0",
+        "import-fresh": "^3.2.1",
+        "parse-json": "^5.0.0",
+        "path-type": "^4.0.0",
+        "yaml": "^1.10.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/cosmiconfig/node_modules/yaml": {
+      "version": "1.10.3",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz",
+      "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==",
+      "license": "ISC",
+      "engines": {
+        "node": ">= 6"
+      }
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
@@ -3867,6 +4026,193 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/depcheck": {
+      "version": "1.4.7",
+      "resolved": "https://registry.npmjs.org/depcheck/-/depcheck-1.4.7.tgz",
+      "integrity": "sha512-1lklS/bV5chOxwNKA/2XUUk/hPORp8zihZsXflr8x0kLwmcZ9Y9BsS6Hs3ssvA+2wUVbG0U2Ciqvm1SokNjPkA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.23.0",
+        "@babel/traverse": "^7.23.2",
+        "@vue/compiler-sfc": "^3.3.4",
+        "callsite": "^1.0.0",
+        "camelcase": "^6.3.0",
+        "cosmiconfig": "^7.1.0",
+        "debug": "^4.3.4",
+        "deps-regex": "^0.2.0",
+        "findup-sync": "^5.0.0",
+        "ignore": "^5.2.4",
+        "is-core-module": "^2.12.0",
+        "js-yaml": "^3.14.1",
+        "json5": "^2.2.3",
+        "lodash": "^4.17.21",
+        "minimatch": "^7.4.6",
+        "multimatch": "^5.0.0",
+        "please-upgrade-node": "^3.2.0",
+        "readdirp": "^3.6.0",
+        "require-package-name": "^2.0.1",
+        "resolve": "^1.22.3",
+        "resolve-from": "^5.0.0",
+        "semver": "^7.5.4",
+        "yargs": "^16.2.0"
+      },
+      "bin": {
+        "depcheck": "bin/depcheck.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/depcheck/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/depcheck/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "license": "MIT"
+    },
+    "node_modules/depcheck/node_modules/brace-expansion": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.0.tgz",
+      "integrity": "sha512-TN1kCZAgdgweJhWWpgKYrQaMNHcDULHkWwQIspdtjV4Y5aurRdZpjAqn6yX3FPqTA9ngHCc4hJxMAMgGfve85w==",
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/depcheck/node_modules/cliui": {
+      "version": "7.0.4",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz",
+      "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==",
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.0",
+        "wrap-ansi": "^7.0.0"
+      }
+    },
+    "node_modules/depcheck/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT"
+    },
+    "node_modules/depcheck/node_modules/minimatch": {
+      "version": "7.4.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-7.4.9.tgz",
+      "integrity": "sha512-Brg/fp/iAVDOQoHxkuN5bEYhyQlZhxddI78yWsCbeEwTHXQjlNLtiJDUsp1GIptVqMI7/gkJMz4vVAc01mpoBw==",
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.2"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/depcheck/node_modules/picomatch": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/depcheck/node_modules/readdirp": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
+      "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
+      "license": "MIT",
+      "dependencies": {
+        "picomatch": "^2.2.1"
+      },
+      "engines": {
+        "node": ">=8.10.0"
+      }
+    },
+    "node_modules/depcheck/node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/depcheck/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/depcheck/node_modules/wrap-ansi": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/depcheck/node_modules/yargs": {
+      "version": "16.2.0",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz",
+      "integrity": "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==",
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^7.0.2",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "require-directory": "^2.1.1",
+        "string-width": "^4.2.0",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^20.2.2"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/depcheck/node_modules/yargs-parser": {
+      "version": "20.2.9",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz",
+      "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
     "node_modules/depd": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
@@ -3876,6 +4222,21 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/deps-regex": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/deps-regex/-/deps-regex-0.2.0.tgz",
+      "integrity": "sha512-PwuBojGMQAYbWkMXOY9Pd/NWCDNHVH12pnS7WHqZkTSeMESe4hwnKKRp0yR87g37113x4JPbo/oIvXY+s/f56Q==",
+      "license": "MIT"
+    },
+    "node_modules/detect-file": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/detect-file/-/detect-file-1.0.0.tgz",
+      "integrity": "sha512-DtCOLG98P007x7wiiOmfI0fi3eIKyWiLTGJ2MDnVi/E04lWGbf+JzrRHMm0rgIIZJGtHpKpbVgLWHrv8xXpc3Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/detect-libc": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
@@ -4006,7 +4367,6 @@
       "version": "7.0.1",
       "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
       "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
-      "dev": true,
       "license": "BSD-2-Clause",
       "engines": {
         "node": ">=0.12"
@@ -4015,6 +4375,15 @@
         "url": "https://github.com/fb55/entities?sponsor=1"
       }
     },
+    "node_modules/error-ex": {
+      "version": "1.3.4",
+      "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz",
+      "integrity": "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==",
+      "license": "MIT",
+      "dependencies": {
+        "is-arrayish": "^0.2.1"
+      }
+    },
     "node_modules/es-define-property": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
@@ -4098,7 +4467,6 @@
       "version": "3.2.0",
       "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
       "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=6"
@@ -4271,6 +4639,19 @@
         "url": "https://opencollective.com/eslint"
       }
     },
+    "node_modules/esprima": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
+      "license": "BSD-2-Clause",
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
     "node_modules/esquery": {
       "version": "1.7.0",
       "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz",
@@ -4311,7 +4692,6 @@
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz",
       "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/esutils": {
@@ -4333,6 +4713,18 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/expand-tilde": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/expand-tilde/-/expand-tilde-2.0.2.tgz",
+      "integrity": "sha512-A5EmesHW6rfnZ9ysHQjPdJRni0SRar0tjtG5MNtm9n5TUvsYU8oozprtRD4AqHxcZWWlVuAmQo2nWKfN9oyjTw==",
+      "license": "MIT",
+      "dependencies": {
+        "homedir-polyfill": "^1.0.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/expect-type": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.3.0.tgz",
@@ -4427,6 +4819,18 @@
         "node": ">=16.0.0"
       }
     },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "license": "MIT",
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/finalhandler": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
@@ -4465,6 +4869,21 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/findup-sync": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-5.0.0.tgz",
+      "integrity": "sha512-MzwXju70AuyflbgeOhzvQWAvvQdo1XL0A9bVvlXsYcFEBM87WR4OakL4OfZq+QRmr+duJubio+UtNQCPsVESzQ==",
+      "license": "MIT",
+      "dependencies": {
+        "detect-file": "^1.0.0",
+        "is-glob": "^4.0.3",
+        "micromatch": "^4.0.4",
+        "resolve-dir": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 10.13.0"
+      }
+    },
     "node_modules/fix-dts-default-cjs-exports": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/fix-dts-default-cjs-exports/-/fix-dts-default-cjs-exports-1.0.1.tgz",
@@ -4575,7 +4994,6 @@
       "version": "2.0.5",
       "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
       "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
-      "dev": true,
       "license": "ISC",
       "engines": {
         "node": "6.* || 8.* || >= 10.*"
@@ -4711,6 +5129,48 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
+    "node_modules/global-modules": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/global-modules/-/global-modules-1.0.0.tgz",
+      "integrity": "sha512-sKzpEkf11GpOFuw0Zzjzmt4B4UZwjOcG757PPvrfhxcLFbq0wpsgpOqxpxtxFiCG4DtG93M6XRVbF2oGdev7bg==",
+      "license": "MIT",
+      "dependencies": {
+        "global-prefix": "^1.0.1",
+        "is-windows": "^1.0.1",
+        "resolve-dir": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/global-prefix": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/global-prefix/-/global-prefix-1.0.2.tgz",
+      "integrity": "sha512-5lsx1NUDHtSjfg0eHlmYvZKv8/nVqX4ckFbM+FrGcQ+04KWcWFo9P5MxPZYSzUvyzmdTbI7Eix8Q4IbELDqzKg==",
+      "license": "MIT",
+      "dependencies": {
+        "expand-tilde": "^2.0.2",
+        "homedir-polyfill": "^1.0.1",
+        "ini": "^1.3.4",
+        "is-windows": "^1.0.1",
+        "which": "^1.2.14"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/global-prefix/node_modules/which": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
+      "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==",
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "which": "bin/which"
+      }
+    },
     "node_modules/gopd": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
@@ -4764,6 +5224,18 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/homedir-polyfill": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/homedir-polyfill/-/homedir-polyfill-1.0.3.tgz",
+      "integrity": "sha512-eSmmWE5bZTK2Nou4g0AI3zZ9rswp7GRKoKXS1BLUkvPviOqs4YTN1djQIqrXy9k5gEtdLPy86JjRwsNM9tnDcA==",
+      "license": "MIT",
+      "dependencies": {
+        "parse-passwd": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/hookable": {
       "version": "5.5.3",
       "resolved": "https://registry.npmjs.org/hookable/-/hookable-5.5.3.tgz",
@@ -4824,12 +5296,36 @@
       "version": "5.3.2",
       "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
       "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 4"
       }
     },
+    "node_modules/import-fresh": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz",
+      "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==",
+      "license": "MIT",
+      "dependencies": {
+        "parent-module": "^1.0.0",
+        "resolve-from": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/import-fresh/node_modules/resolve-from": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
+      "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
     "node_modules/imurmurhash": {
       "version": "0.1.4",
       "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
@@ -4850,7 +5346,6 @@
       "version": "1.3.8",
       "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
       "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
-      "dev": true,
       "license": "ISC"
     },
     "node_modules/ipaddr.js": {
@@ -4862,6 +5357,27 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/is-arrayish": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
+      "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==",
+      "license": "MIT"
+    },
+    "node_modules/is-core-module": {
+      "version": "2.16.2",
+      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.2.tgz",
+      "integrity": "sha512-evOr8xfXKxE6qSR0hSXL2r3sd7ALj8+7jQEUvPYcm5sgZFdJ+AYzT6yNmJenvIYQBgIGwfwz08sL8zoL7yq2BA==",
+      "license": "MIT",
+      "dependencies": {
+        "hasown": "^2.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/is-docker": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz",
@@ -4881,7 +5397,6 @@
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
       "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=0.10.0"
@@ -4891,7 +5406,6 @@
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
       "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=8"
@@ -4901,7 +5415,6 @@
       "version": "4.0.3",
       "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
       "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "is-extglob": "^2.1.1"
@@ -4940,6 +5453,15 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
     "node_modules/is-potential-custom-element-name": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
@@ -4966,6 +5488,15 @@
         "url": "https://github.com/sponsors/mesqueeb"
       }
     },
+    "node_modules/is-windows": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz",
+      "integrity": "sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/is-wsl": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz",
@@ -4985,7 +5516,6 @@
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
       "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-      "dev": true,
       "license": "ISC"
     },
     "node_modules/jackspeak": {
@@ -5056,6 +5586,25 @@
         "node": ">=14"
       }
     },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "license": "MIT"
+    },
+    "node_modules/js-yaml": {
+      "version": "3.14.2",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
+      "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==",
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
     "node_modules/jsdom": {
       "version": "29.1.1",
       "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-29.1.1.tgz",
@@ -5111,7 +5660,6 @@
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
       "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
-      "dev": true,
       "license": "MIT",
       "bin": {
         "jsesc": "bin/jsesc"
@@ -5127,6 +5675,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/json-parse-even-better-errors": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz",
+      "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==",
+      "license": "MIT"
+    },
     "node_modules/json-schema-traverse": {
       "version": "0.4.1",
       "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
@@ -5145,7 +5699,6 @@
       "version": "2.2.3",
       "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
       "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
-      "dev": true,
       "license": "MIT",
       "bin": {
         "json5": "lib/cli.js"
@@ -5456,7 +6009,6 @@
       "version": "1.2.4",
       "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
       "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/load-tsconfig": {
@@ -5522,6 +6074,12 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/lodash": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+      "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+      "license": "MIT"
+    },
     "node_modules/lru-cache": {
       "version": "10.4.3",
       "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
@@ -5543,7 +6101,6 @@
       "version": "0.30.21",
       "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
       "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@jridgewell/sourcemap-codec": "^1.5.5"
@@ -5602,6 +6159,31 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/micromatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+      "license": "MIT",
+      "dependencies": {
+        "braces": "^3.0.3",
+        "picomatch": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/micromatch/node_modules/picomatch": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/mime-db": {
       "version": "1.54.0",
       "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
@@ -5686,6 +6268,53 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/multimatch": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/multimatch/-/multimatch-5.0.0.tgz",
+      "integrity": "sha512-ypMKuglUrZUD99Tk2bUQ+xNQj43lPEfAeX2o9cTteAmShXy2VHDJpuwu1o0xqoKCt9jLVAvwyFKdLTPXKAfJyA==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/minimatch": "^3.0.3",
+        "array-differ": "^3.0.0",
+        "array-union": "^2.1.0",
+        "arrify": "^2.0.1",
+        "minimatch": "^3.0.4"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/multimatch/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "license": "MIT"
+    },
+    "node_modules/multimatch/node_modules/brace-expansion": {
+      "version": "1.1.14",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz",
+      "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==",
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/multimatch/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
     "node_modules/mz": {
       "version": "2.7.0",
       "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz",
@@ -5702,7 +6331,6 @@
       "version": "3.3.12",
       "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz",
       "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==",
-      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -5899,6 +6527,45 @@
       "dev": true,
       "license": "BlueOak-1.0.0"
     },
+    "node_modules/parent-module": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
+      "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
+      "license": "MIT",
+      "dependencies": {
+        "callsites": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/parse-json": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz",
+      "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.0.0",
+        "error-ex": "^1.3.1",
+        "json-parse-even-better-errors": "^2.3.0",
+        "lines-and-columns": "^1.1.6"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/parse-passwd": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/parse-passwd/-/parse-passwd-1.0.0.tgz",
+      "integrity": "sha512-1Y1A//QUXEZK7YKz+rD9WydcE1+EuPr6ZBgKecAB8tmoW6UFv0NREVJe1p+jRxtThkcbbKkfwIbWJe/IeE6m2Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/parse5": {
       "version": "8.0.1",
       "resolved": "https://registry.npmjs.org/parse5/-/parse5-8.0.1.tgz",
@@ -5961,6 +6628,12 @@
         "node": ">=8"
       }
     },
+    "node_modules/path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+      "license": "MIT"
+    },
     "node_modules/path-scurry": {
       "version": "1.11.1",
       "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
@@ -5988,6 +6661,15 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/path-type": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",
+      "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/pathe": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
@@ -6006,7 +6688,6 @@
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
       "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
-      "dev": true,
       "license": "ISC"
     },
     "node_modules/picomatch": {
@@ -6076,11 +6757,19 @@
         "pathe": "^2.0.1"
       }
     },
+    "node_modules/please-upgrade-node": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/please-upgrade-node/-/please-upgrade-node-3.2.0.tgz",
+      "integrity": "sha512-gQR3WpIgNIKwBMVLkpMUeR3e1/E1y42bqDQZfql+kDeXd8COYfM8PQA4X6y7a8u9Ua9FHmsrrmirW2vHs45hWg==",
+      "license": "MIT",
+      "dependencies": {
+        "semver-compare": "^1.0.0"
+      }
+    },
     "node_modules/postcss": {
       "version": "8.5.14",
       "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.14.tgz",
       "integrity": "sha512-SoSL4+OSEtR99LHFZQiJLkT59C5B1amGO1NzTwj7TT1qCUgUO6hxOvzkOYxD+vMrXBM3XJIKzokoERdqQq/Zmg==",
-      "dev": true,
       "funding": [
         {
           "type": "opencollective",
@@ -6390,7 +7079,6 @@
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
       "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=0.10.0"
@@ -6406,11 +7094,50 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/require-package-name": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/require-package-name/-/require-package-name-2.0.1.tgz",
+      "integrity": "sha512-uuoJ1hU/k6M0779t3VMVIYpb2VMJk05cehCaABFhXaibcbvfgR8wKiozLjVFSzJPmQMRqIcO0HMyTFqfV09V6Q==",
+      "license": "MIT"
+    },
+    "node_modules/resolve": {
+      "version": "1.22.12",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.12.tgz",
+      "integrity": "sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "is-core-module": "^2.16.1",
+        "path-parse": "^1.0.7",
+        "supports-preserve-symlinks-flag": "^1.0.0"
+      },
+      "bin": {
+        "resolve": "bin/resolve"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/resolve-dir": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/resolve-dir/-/resolve-dir-1.0.1.tgz",
+      "integrity": "sha512-R7uiTjECzvOsWSfdM0QKFNBVFcK27aHOUwdvK53BcW8zqnGdYp0Fbj82cy54+2A4P2tFM22J5kRfe1R+lM/1yg==",
+      "license": "MIT",
+      "dependencies": {
+        "expand-tilde": "^2.0.0",
+        "global-modules": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/resolve-from": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz",
       "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=8"
@@ -6602,6 +7329,12 @@
         "node": ">=10"
       }
     },
+    "node_modules/semver-compare": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/semver-compare/-/semver-compare-1.0.0.tgz",
+      "integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",
+      "license": "MIT"
+    },
     "node_modules/send": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz",
@@ -6795,7 +7528,6 @@
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
       "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
-      "dev": true,
       "license": "BSD-3-Clause",
       "engines": {
         "node": ">=0.10.0"
@@ -6811,6 +7543,12 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
+      "license": "BSD-3-Clause"
+    },
     "node_modules/stackback": {
       "version": "0.0.2",
       "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
@@ -7000,6 +7738,18 @@
         "url": "https://github.com/chalk/supports-color?sponsor=1"
       }
     },
+    "node_modules/supports-preserve-symlinks-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
+      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/symbol-tree": {
       "version": "3.2.4",
       "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
@@ -7151,6 +7901,18 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "license": "MIT",
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
     "node_modules/toidentifier": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
@@ -8115,7 +8877,6 @@
       "version": "5.0.8",
       "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
       "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
-      "dev": true,
       "license": "ISC",
       "engines": {
         "node": ">=10"
diff --git a/package.json b/package.json
index 054442d..72464e7 100644
--- a/package.json
+++ b/package.json
@@ -59,6 +59,7 @@
   },
   "dependencies": {
     "cors": "^2.8.6",
+    "depcheck": "^1.4.7",
     "express": "^5.2.1",
     "get-port": "^7.2.0",
     "open": "^11.0.0",
@@ -80,6 +81,7 @@
     "concurrently": "^9.2.1",
     "eslint": "^10.3.0",
     "eslint-plugin-vue": "^10.9.1",
+    "vue-eslint-parser": "^9.4.3",
     "jsdom": "^29.1.1",
     "lucide-vue-next": "^1.0.0",
     "pinia": "^3.0.4",
diff --git a/src/client/components/packages/DepcheckPanel.vue b/src/client/components/packages/DepcheckPanel.vue
new file mode 100644
index 0000000..2a0f748
--- /dev/null
+++ b/src/client/components/packages/DepcheckPanel.vue
@@ -0,0 +1,225 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { Button } from '@/components/ui/button'
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
+import { useDepcheck } from '@/composables/useDepcheck'
+
+const emit = defineEmits<{
+  remove: [name: string]
+}>()
+
+const { result, isLoading, error, run, refresh } = useDepcheck()
+
+const unusedCount = computed(() => {
+  if (!result.value) return 0
+  return result.value.dependencies.length + result.value.devDependencies.length
+})
+
+const missingCount = computed(() => {
+  if (!result.value) return 0
+  return Object.keys(result.value.missing).length
+})
+
+const missingEntries = computed(() => {
+  if (!result.value) return []
+  return Object.entries(result.value.missing).map(([name, files]) => ({ name, files }))
+})
+</script>
+
+<template>
+  <Card>
+    <CardHeader class="pb-3">
+      <div class="flex items-center justify-between">
+        <CardTitle class="text-base">
+          Unused Dependencies
+        </CardTitle>
+        <Button
+          v-if="result"
+          size="sm"
+          variant="ghost"
+          :disabled="isLoading"
+          class="h-7 px-2 text-xs"
+          @click="refresh"
+        >
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="12"
+            height="12"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            :class="isLoading ? 'animate-spin' : ''"
+          ><path d="M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8" /><path d="M21 3v5h-5" /><path d="M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16" /><path d="M8 16H3v5" /></svg>
+          Refresh
+        </Button>
+      </div>
+    </CardHeader>
+
+    <CardContent class="space-y-4">
+      <!-- Initial state -->
+      <template v-if="!result && !isLoading && !error">
+        <p class="text-sm text-muted-foreground">
+          Scan your project to detect packages that are declared in package.json but not used in your code.
+        </p>
+        <Button
+          class="w-full"
+          size="sm"
+          @click="run"
+        >
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="14"
+            height="14"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            class="mr-1.5"
+          ><circle
+            cx="11"
+            cy="11"
+            r="8"
+          /><path d="m21 21-4.3-4.3" /></svg>
+          Run Analysis
+        </Button>
+      </template>
+
+      <!-- Loading -->
+      <template v-else-if="isLoading">
+        <div class="flex items-center gap-2 text-sm text-muted-foreground py-4 justify-center">
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="16"
+            height="16"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            class="animate-spin"
+          ><path d="M21 12a9 9 0 1 1-6.219-8.56" /></svg>
+          Scanning project files...
+        </div>
+      </template>
+
+      <!-- Error -->
+      <template v-else-if="error">
+        <p class="text-sm text-destructive">
+          {{ error }}
+        </p>
+        <Button
+          size="sm"
+          variant="outline"
+          class="w-full"
+          @click="run"
+        >
+          Try Again
+        </Button>
+      </template>
+
+      <!-- Results -->
+      <template v-else-if="result">
+        <!-- All clean -->
+        <div
+          v-if="unusedCount === 0 && missingCount === 0"
+          class="text-center py-3"
+        >
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="20"
+            height="20"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            class="mx-auto mb-2 text-green-500"
+          ><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14" /><polyline points="22 4 12 14.01 9 11.01" /></svg>
+          <p class="text-sm text-muted-foreground">
+            No unused dependencies found.
+          </p>
+        </div>
+
+        <template v-else>
+          <!-- Unused production deps -->
+          <div
+            v-if="result.dependencies.length > 0"
+            class="space-y-1.5"
+          >
+            <p class="text-xs font-medium text-muted-foreground uppercase tracking-wide">
+              Unused ({{ result.dependencies.length }})
+            </p>
+            <div
+              v-for="name in result.dependencies"
+              :key="name"
+              class="flex items-center justify-between py-1.5 px-2 rounded-md bg-muted/50 group"
+            >
+              <span class="text-sm font-mono">{{ name }}</span>
+              <Button
+                size="sm"
+                variant="ghost"
+                class="h-6 px-2 text-xs text-destructive hover:text-destructive opacity-0 group-hover:opacity-100 transition-opacity"
+                @click="emit('remove', name)"
+              >
+                Remove
+              </Button>
+            </div>
+          </div>
+
+          <!-- Unused dev deps -->
+          <div
+            v-if="result.devDependencies.length > 0"
+            class="space-y-1.5"
+          >
+            <p class="text-xs font-medium text-muted-foreground uppercase tracking-wide">
+              Unused Dev ({{ result.devDependencies.length }})
+            </p>
+            <div
+              v-for="name in result.devDependencies"
+              :key="name"
+              class="flex items-center justify-between py-1.5 px-2 rounded-md bg-muted/50 group"
+            >
+              <span class="text-sm font-mono">{{ name }}</span>
+              <Button
+                size="sm"
+                variant="ghost"
+                class="h-6 px-2 text-xs text-destructive hover:text-destructive opacity-0 group-hover:opacity-100 transition-opacity"
+                @click="emit('remove', name)"
+              >
+                Remove
+              </Button>
+            </div>
+          </div>
+
+          <!-- Missing deps -->
+          <div
+            v-if="missingEntries.length > 0"
+            class="space-y-1.5"
+          >
+            <p class="text-xs font-medium text-amber-600 dark:text-amber-400 uppercase tracking-wide">
+              Missing ({{ missingEntries.length }})
+            </p>
+            <div
+              v-for="entry in missingEntries"
+              :key="entry.name"
+              class="py-1.5 px-2 rounded-md bg-amber-50 dark:bg-amber-950/20"
+            >
+              <span class="text-sm font-mono">{{ entry.name }}</span>
+              <p class="text-xs text-muted-foreground mt-0.5 truncate">
+                {{ entry.files[0] }}
+                <span v-if="entry.files.length > 1">+{{ entry.files.length - 1 }} more</span>
+              </p>
+            </div>
+          </div>
+        </template>
+      </template>
+    </CardContent>
+  </Card>
+</template>
diff --git a/src/client/components/packages/PackageList.vue b/src/client/components/packages/PackageList.vue
index 3eca558..e56648c 100644
--- a/src/client/components/packages/PackageList.vue
+++ b/src/client/components/packages/PackageList.vue
@@ -5,7 +5,9 @@ import { Button } from '@/components/ui/button'
 import { Badge } from '@/components/ui/badge'
 import { Skeleton } from '@/components/ui/skeleton'
 import PackageItem from './PackageItem.vue'
+import SmartFiltersPanel from './SmartFiltersPanel.vue'
 import { useSearch, type FilterType } from '@/composables/useSearch'
+import { useSmartFilters } from '@/composables/useSmartFilters'
 import type { Package } from '@shared/types'
 
 const props = defineProps<{
@@ -25,17 +27,67 @@ const emit = defineEmits<{
 const packagesRef = computed(() => props.packages)
 const { query, filter, filtered, counts, setQuery, setFilter } = useSearch(packagesRef)
 
+const {
+  availableLicenses,
+  isLoading: isSmartLoading,
+  hasData: hasSmartData,
+  selectedLicenses,
+  popularityFilter,
+  ageFilter,
+  filteredNames,
+  activeFilterCount,
+  loadSmartData,
+  clearFilters,
+} = useSmartFilters(packagesRef)
 
-const filters: { value: FilterType; label: string; countKey: keyof typeof counts.value }[] = [
+const baseFilters: { value: FilterType; label: string; countKey: keyof typeof counts.value }[] = [
   { value: 'all', label: 'All', countKey: 'total' },
   { value: 'outdated', label: 'Outdated', countKey: 'outdated' },
   { value: 'dependencies', label: 'Dependencies', countKey: 'dependencies' },
   { value: 'devDependencies', label: 'Dev', countKey: 'devDependencies' },
 ]
 
-const displayedPackages = computed(() =>
-  props.limit ? filtered.value.slice(0, props.limit) : filtered.value
-)
+const popularityLabels: Record<string, string> = {
+  'very-popular': '>1M / wk',
+  popular: '>100K / wk',
+  niche: '<100K / wk',
+}
+
+const ageLabels: Record<string, string> = {
+  active: '<6 months',
+  recent: '6–12 months',
+  stable: '1–2 years',
+  stale: '>2 years',
+}
+
+// Tags to show below the controls row for active smart filters
+const activeTags = computed(() => {
+  const tags: { key: string; label: string; onRemove: () => void }[] = []
+  for (const lic of selectedLicenses.value) {
+    tags.push({ key: `lic:${lic}`, label: lic, onRemove: () => {
+      selectedLicenses.value = selectedLicenses.value.filter(l => l !== lic)
+    }})
+  }
+  if (popularityFilter.value !== 'all') {
+    tags.push({ key: 'pop', label: popularityLabels[popularityFilter.value] ?? popularityFilter.value, onRemove: () => {
+      popularityFilter.value = 'all'
+    }})
+  }
+  if (ageFilter.value !== 'all') {
+    tags.push({ key: 'age', label: ageLabels[ageFilter.value] ?? ageFilter.value, onRemove: () => {
+      ageFilter.value = 'all'
+    }})
+  }
+  return tags
+})
+
+const displayedPackages = computed(() => {
+  let result = filtered.value
+  if (filteredNames.value !== null) {
+    result = result.filter(pkg => filteredNames.value!.has(pkg.name))
+  }
+  return props.limit ? result.slice(0, props.limit) : result
+})
 
 const hasMore = computed(() =>
   !!props.limit && props.packages.length > props.limit
@@ -43,10 +95,10 @@ const hasMore = computed(() =>
 </script>
 
 <template>
-  <div class="space-y-4">
-    <!-- Search and filters (hidden in limited mode) -->
+  <div class="space-y-3">
+    <!-- Search + filter controls (hidden in limited mode) -->
     <template v-if="!limit">
-      <div class="flex flex-col sm:flex-row gap-4">
+      <div class="flex flex-col sm:flex-row gap-3">
         <div class="flex-1">
           <Input
             :model-value="query"
@@ -56,7 +108,7 @@ const hasMore = computed(() =>
         </div>
         <div class="flex flex-wrap items-center gap-2">
           <Button
-            v-for="f in filters"
+            v-for="f in baseFilters"
             :key="f.value"
             size="sm"
             :variant="filter === f.value ? 'default' : 'outline'"
@@ -70,8 +122,66 @@ const hasMore = computed(() =>
               {{ counts[f.countKey] }}
             </Badge>
           </Button>
+
+          <SmartFiltersPanel
+            :available-licenses="availableLicenses"
+            :is-loading="isSmartLoading"
+            :has-data="hasSmartData"
+            :selected-licenses="selectedLicenses"
+            :popularity-filter="popularityFilter"
+            :age-filter="ageFilter"
+            :active-filter-count="activeFilterCount"
+            @update:selected-licenses="selectedLicenses = $event"
+            @update:popularity-filter="popularityFilter = $event"
+            @update:age-filter="ageFilter = $event"
+            @load="loadSmartData"
+            @clear="clearFilters"
+          />
         </div>
       </div>
+
+      <!-- Active smart filter tags -->
+      <div
+        v-if="activeTags.length > 0"
+        class="flex flex-wrap items-center gap-1.5"
+      >
+        <span class="text-xs text-muted-foreground">Filtered by:</span>
+        <button
+          v-for="tag in activeTags"
+          :key="tag.key"
+          class="inline-flex items-center gap-1 rounded-full bg-primary/10 border border-primary/20 px-2.5 py-0.5 text-xs font-medium text-primary hover:bg-primary/20 transition-colors"
+          @click="tag.onRemove()"
+        >
+          {{ tag.label }}
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="10"
+            height="10"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2.5"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+          ><line
+            x1="18"
+            y1="6"
+            x2="6"
+            y2="18"
+          /><line
+            x1="6"
+            y1="6"
+            x2="18"
+            y2="18"
+          /></svg>
+        </button>
+        <button
+          class="text-xs text-muted-foreground hover:text-foreground transition-colors ml-1"
+          @click="clearFilters"
+        >
+          Clear all
+        </button>
+      </div>
     </template>
 
     <!-- Package list -->
diff --git a/src/client/components/packages/SmartFiltersPanel.vue b/src/client/components/packages/SmartFiltersPanel.vue
new file mode 100644
index 0000000..43bd2d3
--- /dev/null
+++ b/src/client/components/packages/SmartFiltersPanel.vue
@@ -0,0 +1,225 @@
+<script setup lang="ts">
+import { PopoverRoot, PopoverTrigger, PopoverPortal, PopoverContent } from 'radix-vue'
+import { Button } from '@/components/ui/button'
+import { Badge } from '@/components/ui/badge'
+import type { PopularityFilter, AgeFilter } from '@/composables/useSmartFilters'
+
+const props = defineProps<{
+  availableLicenses: string[]
+  isLoading: boolean
+  hasData: boolean
+  selectedLicenses: string[]
+  popularityFilter: PopularityFilter
+  ageFilter: AgeFilter
+  activeFilterCount: number
+}>()
+
+const emit = defineEmits<{
+  'update:selectedLicenses': [value: string[]]
+  'update:popularityFilter': [value: PopularityFilter]
+  'update:ageFilter': [value: AgeFilter]
+  load: []
+  clear: []
+}>()
+
+function toggleLicense(license: string) {
+  const current = props.selectedLicenses
+  emit(
+    'update:selectedLicenses',
+    current.includes(license) ? current.filter(l => l !== license) : [...current, license]
+  )
+}
+
+const popularityOptions: { value: PopularityFilter; label: string }[] = [
+  { value: 'all', label: 'All' },
+  { value: 'very-popular', label: '>1M / wk' },
+  { value: 'popular', label: '>100K / wk' },
+  { value: 'niche', label: '<100K / wk' },
+]
+
+const ageOptions: { value: AgeFilter; label: string }[] = [
+  { value: 'all', label: 'All' },
+  { value: 'active', label: '<6 months' },
+  { value: 'recent', label: '6–12 months' },
+  { value: 'stable', label: '1–2 years' },
+  { value: 'stale', label: '>2 years' },
+]
+
+function onOpenChange(open: boolean) {
+  if (open && !props.hasData && !props.isLoading) {
+    emit('load')
+  }
+}
+</script>
+
+<template>
+  <PopoverRoot @update:open="onOpenChange">
+    <PopoverTrigger as-child>
+      <Button
+        size="sm"
+        :variant="activeFilterCount > 0 ? 'default' : 'outline'"
+        class="gap-1.5"
+      >
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          width="13"
+          height="13"
+          viewBox="0 0 24 24"
+          fill="none"
+          stroke="currentColor"
+          stroke-width="2"
+          stroke-linecap="round"
+          stroke-linejoin="round"
+        ><polygon points="22 3 2 3 10 12.46 10 19 14 21 14 12.46 22 3" /></svg>
+        Smart Filters
+        <Badge
+          v-if="activeFilterCount > 0"
+          variant="secondary"
+          class="ml-0.5 h-4 min-w-4 px-1 text-[10px]"
+        >
+          {{ activeFilterCount }}
+        </Badge>
+      </Button>
+    </PopoverTrigger>
+
+    <PopoverPortal>
+      <PopoverContent
+        :side-offset="8"
+        align="end"
+        class="z-50 w-80 rounded-xl border bg-card shadow-xl outline-none"
+      >
+        <div class="p-4 space-y-4">
+          <!-- Loading -->
+          <template v-if="isLoading">
+            <div class="flex items-center justify-center gap-2 py-6 text-sm text-muted-foreground">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                width="15"
+                height="15"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                stroke-width="2"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+                class="animate-spin"
+              ><path d="M21 12a9 9 0 1 1-6.219-8.56" /></svg>
+              Fetching package metadata…
+            </div>
+          </template>
+
+          <!-- No data yet -->
+          <template v-else-if="!hasData">
+            <div class="text-center py-4 space-y-3">
+              <p class="text-sm text-muted-foreground">
+                Load license, popularity, and age data from npm.
+              </p>
+              <Button
+                size="sm"
+                class="w-full"
+                @click="emit('load')"
+              >
+                Load filter data
+              </Button>
+            </div>
+          </template>
+
+          <!-- Filters ready -->
+          <template v-else>
+            <!-- License -->
+            <div
+              v-if="availableLicenses.length > 0"
+              class="space-y-2"
+            >
+              <p class="text-[11px] font-semibold text-muted-foreground uppercase tracking-wider">
+                License
+              </p>
+              <div class="flex flex-wrap gap-1.5">
+                <button
+                  v-for="license in availableLicenses"
+                  :key="license"
+                  class="inline-flex items-center gap-1 rounded-full border px-2.5 py-0.5 text-xs font-medium transition-colors"
+                  :class="selectedLicenses.includes(license)
+                    ? 'border-primary bg-primary text-primary-foreground'
+                    : 'border-border bg-background text-foreground hover:bg-accent'"
+                  @click="toggleLicense(license)"
+                >
+                  <svg
+                    v-if="selectedLicenses.includes(license)"
+                    xmlns="http://www.w3.org/2000/svg"
+                    width="10"
+                    height="10"
+                    viewBox="0 0 24 24"
+                    fill="none"
+                    stroke="currentColor"
+                    stroke-width="3"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                  ><polyline points="20 6 9 17 4 12" /></svg>
+                  {{ license }}
+                </button>
+              </div>
+            </div>
+
+            <div class="border-t" />
+
+            <!-- Popularity -->
+            <div class="space-y-2">
+              <p class="text-[11px] font-semibold text-muted-foreground uppercase tracking-wider">
+                Popularity (weekly downloads)
+              </p>
+              <div class="flex flex-wrap gap-1.5">
+                <button
+                  v-for="opt in popularityOptions"
+                  :key="opt.value"
+                  class="rounded-full border px-2.5 py-0.5 text-xs font-medium transition-colors"
+                  :class="popularityFilter === opt.value
+                    ? 'border-primary bg-primary text-primary-foreground'
+                    : 'border-border bg-background text-foreground hover:bg-accent'"
+                  @click="emit('update:popularityFilter', opt.value)"
+                >
+                  {{ opt.label }}
+                </button>
+              </div>
+            </div>
+
+            <div class="border-t" />
+
+            <!-- Age -->
+            <div class="space-y-2">
+              <p class="text-[11px] font-semibold text-muted-foreground uppercase tracking-wider">
+                Last Published
+              </p>
+              <div class="flex flex-wrap gap-1.5">
+                <button
+                  v-for="opt in ageOptions"
+                  :key="opt.value"
+                  class="rounded-full border px-2.5 py-0.5 text-xs font-medium transition-colors"
+                  :class="ageFilter === opt.value
+                    ? 'border-primary bg-primary text-primary-foreground'
+                    : 'border-border bg-background text-foreground hover:bg-accent'"
+                  @click="emit('update:ageFilter', opt.value)"
+                >
+                  {{ opt.label }}
+                </button>
+              </div>
+            </div>
+
+            <!-- Clear -->
+            <div
+              v-if="activeFilterCount > 0"
+              class="border-t pt-1"
+            >
+              <button
+                class="w-full text-center text-xs text-muted-foreground hover:text-foreground transition-colors py-1"
+                @click="emit('clear')"
+              >
+                Clear all filters
+              </button>
+            </div>
+          </template>
+        </div>
+      </PopoverContent>
+    </PopoverPortal>
+  </PopoverRoot>
+</template>
diff --git a/src/client/composables/useDepcheck.ts b/src/client/composables/useDepcheck.ts
new file mode 100644
index 0000000..961d4fe
--- /dev/null
+++ b/src/client/composables/useDepcheck.ts
@@ -0,0 +1,37 @@
+import { ref } from 'vue'
+import { useApi } from './useApi'
+import type { DepcheckResult } from '@shared/types'
+
+export function useDepcheck() {
+  const { get } = useApi()
+
+  const result = ref<DepcheckResult | null>(null)
+  const isLoading = ref(false)
+  const error = ref<string | null>(null)
+
+  async function run() {
+    isLoading.value = true
+    error.value = null
+    try {
+      result.value = await get<DepcheckResult>('/depcheck')
+    } catch (err) {
+      error.value = err instanceof Error ? err.message : 'Failed to run analysis'
+    } finally {
+      isLoading.value = false
+    }
+  }
+
+  async function refresh() {
+    isLoading.value = true
+    error.value = null
+    try {
+      result.value = await get<DepcheckResult>('/depcheck/refresh')
+    } catch (err) {
+      error.value = err instanceof Error ? err.message : 'Failed to run analysis'
+    } finally {
+      isLoading.value = false
+    }
+  }
+
+  return { result, isLoading, error, run, refresh }
+}
diff --git a/src/client/composables/useSmartFilters.ts b/src/client/composables/useSmartFilters.ts
new file mode 100644
index 0000000..de56578
--- /dev/null
+++ b/src/client/composables/useSmartFilters.ts
@@ -0,0 +1,119 @@
+import { ref, computed, type Ref } from 'vue'
+import { useQuery } from '@tanstack/vue-query'
+import { useApi } from './useApi'
+import type { SmartPackageData } from '@shared/types'
+
+export type PopularityFilter = 'all' | 'very-popular' | 'popular' | 'niche'
+export type AgeFilter = 'all' | 'active' | 'recent' | 'stable' | 'stale'
+
+export function normalizeLicense(license: string | null): string {
+  if (!license) return 'Unknown'
+  return license.replace(/^\(|\)$/g, '').trim()
+}
+
+function getAgeCategory(lastPublished: string | null): Exclude<AgeFilter, 'all'> {
+  if (!lastPublished) return 'stale'
+  const ageDays = (Date.now() - new Date(lastPublished).getTime()) / 86_400_000
+  if (ageDays < 180) return 'active'
+  if (ageDays < 365) return 'recent'
+  if (ageDays < 730) return 'stable'
+  return 'stale'
+}
+
+function getPopularityCategory(weeklyDownloads: number | null): Exclude<PopularityFilter, 'all'> {
+  if (!weeklyDownloads) return 'niche'
+  if (weeklyDownloads >= 1_000_000) return 'very-popular'
+  if (weeklyDownloads >= 100_000) return 'popular'
+  return 'niche'
+}
+
+export function useSmartFilters(_packages: Ref<unknown[]>) {
+  const { get } = useApi()
+
+  const enabled = ref(false)
+
+  const { data: smartData, isLoading, isFetching } = useQuery({
+    queryKey: ['packages', 'smart-data'],
+    queryFn: () => get<SmartPackageData[]>('/packages/smart-data'),
+    enabled,
+    staleTime: 5 * 60 * 1000,
+  })
+
+  const selectedLicenses = ref<string[]>([])
+  const popularityFilter = ref<PopularityFilter>('all')
+  const ageFilter = ref<AgeFilter>('all')
+
+  const smartDataMap = computed(() => {
+    const map = new Map<string, SmartPackageData>()
+    smartData.value?.forEach(d => map.set(d.name, d))
+    return map
+  })
+
+  const availableLicenses = computed(() => {
+    if (!smartData.value) return []
+    const licenses = new Set<string>()
+    smartData.value.forEach(d => licenses.add(normalizeLicense(d.license)))
+    return [...licenses].sort()
+  })
+
+  // Returns null when no smart filters are active (skip filtering), otherwise a Set of passing names
+  const filteredNames = computed((): Set<string> | null => {
+    if (!smartData.value) return null
+
+    const hasFilters = selectedLicenses.value.length > 0
+      || popularityFilter.value !== 'all'
+      || ageFilter.value !== 'all'
+
+    if (!hasFilters) return null
+
+    return new Set(
+      smartData.value
+        .filter(d => {
+          if (selectedLicenses.value.length > 0) {
+            if (!selectedLicenses.value.includes(normalizeLicense(d.license))) return false
+          }
+          if (popularityFilter.value !== 'all') {
+            if (getPopularityCategory(d.weeklyDownloads) !== popularityFilter.value) return false
+          }
+          if (ageFilter.value !== 'all') {
+            if (getAgeCategory(d.lastPublished) !== ageFilter.value) return false
+          }
+          return true
+        })
+        .map(d => d.name)
+    )
+  })
+
+  const activeFilterCount = computed(() => {
+    let count = 0
+    if (selectedLicenses.value.length > 0) count++
+    if (popularityFilter.value !== 'all') count++
+    if (ageFilter.value !== 'all') count++
+    return count
+  })
+
+  function loadSmartData() {
+    enabled.value = true
+  }
+
+  function clearFilters() {
+    selectedLicenses.value = []
+    popularityFilter.value = 'all'
+    ageFilter.value = 'all'
+  }
+
+  return {
+    smartData,
+    smartDataMap,
+    isLoading: computed(() => isLoading.value || isFetching.value),
+    hasData: computed(() => !!smartData.value),
+    selectedLicenses,
+    popularityFilter,
+    ageFilter,
+    availableLicenses,
+    filteredNames,
+    activeFilterCount,
+    loadSmartData,
+    clearFilters,
+  }
+}
diff --git a/src/client/views/DependenciesView.vue b/src/client/views/DependenciesView.vue
index 90d2687..9f03c76 100644
--- a/src/client/views/DependenciesView.vue
+++ b/src/client/views/DependenciesView.vue
@@ -3,6 +3,7 @@ import { computed, ref } from 'vue'
 import { useRouter } from 'vue-router'
 import PackageList from '@/components/packages/PackageList.vue'
 import OutdatedCard from '@/components/dashboard/OutdatedCard.vue'
+import DepcheckPanel from '@/components/packages/DepcheckPanel.vue'
 import OperationToast from '@/components/operations/OperationToast.vue'
 import { ConfirmDialog } from '@/components/ui/confirm-dialog'
 import { Button } from '@/components/ui/button'
@@ -75,11 +76,14 @@ function handleSelectPackage(name: string) {
         @select="handleSelectPackage"
       />
 
-      <OutdatedCard
-        :packages="packageList"
-        :is-loading="isLoading"
-        @update="handleUpdatePackage"
-      />
+      <div class="space-y-6">
+        <OutdatedCard
+          :packages="packageList"
+          :is-loading="isLoading"
+          @update="handleUpdatePackage"
+        />
+        <DepcheckPanel @remove="handleRemovePackage" />
+      </div>
     </div>
 
     <ConfirmDialog
diff --git a/src/server/app.ts b/src/server/app.ts
index 683f1a1..76d41f3 100644
--- a/src/server/app.ts
+++ b/src/server/app.ts
@@ -8,6 +8,7 @@ import { createOperationsRouter } from './routes/operations.js'
 import { createProjectRouter } from './routes/project.js'
 import { createAuditRouter } from './routes/audit.js'
 import { createScriptsRouter } from './routes/scripts.js'
+import { createDepcheckRouter } from './routes/depcheck.js'
 
 export function createServer(projectPath: string, clientDistPath: string, port?: number, token?: string): Express {
   const app = express()
@@ -34,6 +35,7 @@ export function createServer(projectPath: string, clientDistPath: string, port?:
   app.use('/api/project', createProjectRouter(projectPath))
   app.use('/api/audit', createAuditRouter(projectPath))
   app.use('/api/scripts', createScriptsRouter(projectPath))
+  app.use('/api/depcheck', createDepcheckRouter(projectPath))
 
   if (existsSync(clientDistPath)) {
     const rawHtml = readFileSync(join(clientDistPath, 'index.html'), 'utf-8')
diff --git a/src/server/routes/depcheck.ts b/src/server/routes/depcheck.ts
new file mode 100644
index 0000000..d37e5ab
--- /dev/null
+++ b/src/server/routes/depcheck.ts
@@ -0,0 +1,48 @@
+import { Router, type Request, type Response } from 'express'
+import { runDepcheck } from '../services/depcheckService.js'
+import type { DepcheckResult } from '@shared/types'
+
+interface CacheEntry {
+  result: DepcheckResult
+  timestamp: number
+}
+
+const CACHE_TTL = 60 * 1000 // 60 seconds
+
+let cache: CacheEntry | null = null
+
+export function createDepcheckRouter(projectPath: string): Router {
+  const router = Router()
+
+  // GET /api/depcheck - run analysis (cached for 60s)
+  router.get('/', async (_req: Request, res: Response) => {
+    try {
+      if (cache && Date.now() - cache.timestamp < CACHE_TTL) {
+        res.json({ success: true, data: cache.result })
+        return
+      }
+
+      const result = await runDepcheck(projectPath)
+      cache = { result, timestamp: Date.now() }
+      res.json({ success: true, data: result })
+    } catch (error) {
+      console.error('Depcheck error:', error)
+      res.status(500).json({ success: false, error: 'Failed to run dependency analysis' })
+    }
+  })
+
+  // GET /api/depcheck/refresh - force fresh run
+  router.get('/refresh', async (_req: Request, res: Response) => {
+    try {
+      cache = null
+      const result = await runDepcheck(projectPath)
+      cache = { result, timestamp: Date.now() }
+      res.json({ success: true, data: result })
+    } catch (error) {
+      console.error('Depcheck error:', error)
+      res.status(500).json({ success: false, error: 'Failed to run dependency analysis' })
+    }
+  })
+
+  return router
+}
diff --git a/src/server/routes/packages.ts b/src/server/routes/packages.ts
index 63c970f..32c9001 100644
--- a/src/server/routes/packages.ts
+++ b/src/server/routes/packages.ts
@@ -1,6 +1,6 @@
 import { Router, type Request, type Response } from 'express'
 import { getPackages } from '../services/packageJson.js'
-import { getLatestVersion } from '../services/registryClient.js'
+import { getLatestVersion, getSmartMetadata } from '../services/registryClient.js'
 import {
   detectPackageManager,
   getUninstallCommand,
@@ -45,6 +45,23 @@ export function createPackagesRouter(projectPath: string): Router {
     }
   })
 
+  // GET /api/packages/smart-data - Batch enriched metadata for smart filters
+  router.get('/smart-data', async (_req: Request, res: Response) => {
+    try {
+      const packages = getPackages(projectPath)
+      const smartData = await Promise.all(
+        packages.map(async (pkg) => {
+          const meta = await getSmartMetadata(pkg.name)
+          return { name: pkg.name, ...meta }
+        })
+      )
+      res.json({ success: true, data: smartData })
+    } catch (error) {
+      console.error('Error fetching smart data:', error)
+      res.status(500).json({ success: false, error: 'Failed to fetch smart metadata' })
+    }
+  })
+
   // GET /api/packages/:name - Get a single package
   router.get('/:name', async (req: Request<{ name: string }>, res: Response) => {
     try {
diff --git a/src/server/services/depcheckService.ts b/src/server/services/depcheckService.ts
new file mode 100644
index 0000000..1d4f4f8
--- /dev/null
+++ b/src/server/services/depcheckService.ts
@@ -0,0 +1,27 @@
+import { createRequire } from 'module'
+import type { DepcheckResult } from '@shared/types'
+
+const require = createRequire(import.meta.url)
+
+interface DepcheckUnused {
+  dependencies: string[]
+  devDependencies: string[]
+  missing: Record<string, string[]>
+}
+
+type DepcheckFn = (path: string, options: Record<string, unknown>) => Promise<DepcheckUnused>
+
+export async function runDepcheck(projectPath: string): Promise<DepcheckResult> {
+  const depcheck = require('depcheck') as DepcheckFn
+
+  const result = await depcheck(projectPath, {
+    ignorePatterns: ['dist', 'build', '.packy-logs', 'coverage'],
+    ignoreMatches: ['@types/*', '@tailwindcss/postcss', 'autoprefixer', '@vue/test-utils', '@shared/*'],
+  })
+
+  return {
+    dependencies: result.dependencies,
+    devDependencies: result.devDependencies,
+    missing: result.missing,
+  }
+}
diff --git a/src/server/services/registryClient.ts b/src/server/services/registryClient.ts
index 8f2b5d5..933fd9f 100644
--- a/src/server/services/registryClient.ts
+++ b/src/server/services/registryClient.ts
@@ -190,3 +190,66 @@ export function clearCache(packageName?: string): void {
     cache.clear()
   }
 }
+
+// Cache for last-published date lookups
+const publishDateCache = new Map<string, { date: string | null; timestamp: number }>()
+
+/**
+ * Fetches the last published date for the latest version of a package.
+ */
+export async function getLastPublished(packageName: string): Promise<string | null> {
+  const cached = publishDateCache.get(packageName)
+  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+    return cached.date
+  }
+
+  try {
+    const encodedName = packageName.startsWith('@')
+      ? `@${encodeURIComponent(packageName.slice(1))}`
+      : encodeURIComponent(packageName)
+
+    const response = await fetch(`${NPM_REGISTRY}/${encodedName}`, {
+      headers: { Accept: 'application/vnd.npm.install-v1+json' },
+    })
+
+    if (!response.ok) {
+      publishDateCache.set(packageName, { date: null, timestamp: Date.now() })
+      return null
+    }
+
+    const data = await response.json() as {
+      'dist-tags': { latest: string }
+      time?: Record<string, string>
+    }
+
+    const latestVersion = data['dist-tags']?.latest
+    const date = (latestVersion && data.time?.[latestVersion]) ?? data.time?.modified ?? null
+
+    publishDateCache.set(packageName, { date, timestamp: Date.now() })
+    return date
+  } catch {
+    publishDateCache.set(packageName, { date: null, timestamp: Date.now() })
+    return null
+  }
+}
+
+/**
+ * Fetches smart filter metadata (license, downloads, lastPublished) for a package.
+ */
+export async function getSmartMetadata(packageName: string): Promise<{
+  license: string | null
+  weeklyDownloads: number | null
+  lastPublished: string | null
+}> {
+  const [info, downloads, lastPublished] = await Promise.all([
+    getPackageInfo(packageName),
+    getDownloadCounts(packageName),
+    getLastPublished(packageName),
+  ])
+
+  return {
+    license: info?.license ?? null,
+    weeklyDownloads: downloads?.weekly ?? null,
+    lastPublished,
+  }
+}
diff --git a/src/shared/types.ts b/src/shared/types.ts
index 9b3f305..b4740df 100644
--- a/src/shared/types.ts
+++ b/src/shared/types.ts
@@ -158,6 +158,21 @@ export interface AuditFixRequest {
   packageName?: string
 }
 
+// Smart filter types
+export interface SmartPackageData {
+  name: string
+  license: string | null
+  weeklyDownloads: number | null
+  lastPublished: string | null
+}
+
+// Depcheck types
+export interface DepcheckResult {
+  dependencies: string[]
+  devDependencies: string[]
+  missing: Record<string, string[]>
+}
+
 // Audit log types
 export interface AuditLogEntry {
   id: string

From 56c84f1d63e0e519c920d955b2a393d94c3d939f Mon Sep 17 00:00:00 2001
From: njevric <njevric9@gmail.com>
Date: Wed, 13 May 2026 00:28:40 +0200
Subject: [PATCH 5/7] fix: package-lock

---
 package-lock.json | 73 +++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 61 insertions(+), 12 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 9e5d1ca..6d13d42 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -50,6 +50,7 @@
         "vite": "^8.0.11",
         "vitest": "^4.1.5",
         "vue": "^3.5.34",
+        "vue-eslint-parser": "^9.4.3",
         "vue-router": "^5.0.6",
         "vue-tsc": "^3.2.8"
       },
@@ -8517,28 +8518,76 @@
       }
     },
     "node_modules/vue-eslint-parser": {
-      "version": "10.4.0",
-      "resolved": "https://registry.npmjs.org/vue-eslint-parser/-/vue-eslint-parser-10.4.0.tgz",
-      "integrity": "sha512-Vxi9pJdbN3ZnVGLODVtZ7y4Y2kzAAE2Cm0CZ3ZDRvydVYxZ6VrnBhLikBsRS+dpwj4Jv4UCv21PTEwF5rQ9WXg==",
+      "version": "9.4.3",
+      "resolved": "https://registry.npmjs.org/vue-eslint-parser/-/vue-eslint-parser-9.4.3.tgz",
+      "integrity": "sha512-2rYRLWlIpaiN8xbPiDyXZXRgLGOtWxERV7ND5fFAv5qo1D2N9Fu9MNajBNc6o13lZ+24DAWCkQCvj4klgmcITg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
-        "debug": "^4.4.0",
-        "eslint-scope": "^8.2.0 || ^9.0.0",
-        "eslint-visitor-keys": "^4.2.0 || ^5.0.0",
-        "espree": "^10.3.0 || ^11.0.0",
-        "esquery": "^1.6.0",
-        "semver": "^7.6.3"
+        "debug": "^4.3.4",
+        "eslint-scope": "^7.1.1",
+        "eslint-visitor-keys": "^3.3.0",
+        "espree": "^9.3.1",
+        "esquery": "^1.4.0",
+        "lodash": "^4.17.21",
+        "semver": "^7.3.6"
       },
       "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+        "node": "^14.17.0 || >=16.0.0"
       },
       "funding": {
         "url": "https://github.com/sponsors/mysticatea"
       },
       "peerDependencies": {
-        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0"
+        "eslint": ">=6.0.0"
+      }
+    },
+    "node_modules/vue-eslint-parser/node_modules/eslint-scope": {
+      "version": "7.2.2",
+      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-7.2.2.tgz",
+      "integrity": "sha512-dOt21O7lTMhDM+X9mB4GX+DZrZtCUJPL/wlcTqxyrx5IvO0IYtILdtrQGQp+8n5S0gwSVmOf9NQrjMOgfQZlIg==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "esrecurse": "^4.3.0",
+        "estraverse": "^5.2.0"
+      },
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/vue-eslint-parser/node_modules/eslint-visitor-keys": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",
+      "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/vue-eslint-parser/node_modules/espree": {
+      "version": "9.6.1",
+      "resolved": "https://registry.npmjs.org/espree/-/espree-9.6.1.tgz",
+      "integrity": "sha512-oruZaFkjorTpF32kDSI5/75ViwGeZginGGy2NoOSg3Q9bnwlnmDm4HLnkl0RE3n+njDXR037aY1+x58Z/zFdwQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "acorn": "^8.9.0",
+        "acorn-jsx": "^5.3.2",
+        "eslint-visitor-keys": "^3.4.1"
+      },
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
       }
     },
     "node_modules/vue-router": {

From ab509b03083a71175c32c7e4fdb7fc29bed89c6c Mon Sep 17 00:00:00 2001
From: njevric <njevric9@gmail.com>
Date: Wed, 13 May 2026 00:31:51 +0200
Subject: [PATCH 6/7] fix: lint error

---
 package-lock.json | 73 ++++++++---------------------------------------
 package.json      |  2 +-
 2 files changed, 13 insertions(+), 62 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 6d13d42..bb0e3a5 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -50,7 +50,7 @@
         "vite": "^8.0.11",
         "vitest": "^4.1.5",
         "vue": "^3.5.34",
-        "vue-eslint-parser": "^9.4.3",
+        "vue-eslint-parser": "^10.3.0",
         "vue-router": "^5.0.6",
         "vue-tsc": "^3.2.8"
       },
@@ -8518,76 +8518,27 @@
       }
     },
     "node_modules/vue-eslint-parser": {
-      "version": "9.4.3",
-      "resolved": "https://registry.npmjs.org/vue-eslint-parser/-/vue-eslint-parser-9.4.3.tgz",
-      "integrity": "sha512-2rYRLWlIpaiN8xbPiDyXZXRgLGOtWxERV7ND5fFAv5qo1D2N9Fu9MNajBNc6o13lZ+24DAWCkQCvj4klgmcITg==",
+      "version": "10.4.0",
+      "resolved": "https://registry.npmjs.org/vue-eslint-parser/-/vue-eslint-parser-10.4.0.tgz",
+      "integrity": "sha512-Vxi9pJdbN3ZnVGLODVtZ7y4Y2kzAAE2Cm0CZ3ZDRvydVYxZ6VrnBhLikBsRS+dpwj4Jv4UCv21PTEwF5rQ9WXg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "debug": "^4.3.4",
-        "eslint-scope": "^7.1.1",
-        "eslint-visitor-keys": "^3.3.0",
-        "espree": "^9.3.1",
-        "esquery": "^1.4.0",
-        "lodash": "^4.17.21",
-        "semver": "^7.3.6"
+        "debug": "^4.4.0",
+        "eslint-scope": "^8.2.0 || ^9.0.0",
+        "eslint-visitor-keys": "^4.2.0 || ^5.0.0",
+        "espree": "^10.3.0 || ^11.0.0",
+        "esquery": "^1.6.0",
+        "semver": "^7.6.3"
       },
       "engines": {
-        "node": "^14.17.0 || >=16.0.0"
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       },
       "funding": {
         "url": "https://github.com/sponsors/mysticatea"
       },
       "peerDependencies": {
-        "eslint": ">=6.0.0"
-      }
-    },
-    "node_modules/vue-eslint-parser/node_modules/eslint-scope": {
-      "version": "7.2.2",
-      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-7.2.2.tgz",
-      "integrity": "sha512-dOt21O7lTMhDM+X9mB4GX+DZrZtCUJPL/wlcTqxyrx5IvO0IYtILdtrQGQp+8n5S0gwSVmOf9NQrjMOgfQZlIg==",
-      "dev": true,
-      "license": "BSD-2-Clause",
-      "dependencies": {
-        "esrecurse": "^4.3.0",
-        "estraverse": "^5.2.0"
-      },
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/vue-eslint-parser/node_modules/eslint-visitor-keys": {
-      "version": "3.4.3",
-      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",
-      "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/vue-eslint-parser/node_modules/espree": {
-      "version": "9.6.1",
-      "resolved": "https://registry.npmjs.org/espree/-/espree-9.6.1.tgz",
-      "integrity": "sha512-oruZaFkjorTpF32kDSI5/75ViwGeZginGGy2NoOSg3Q9bnwlnmDm4HLnkl0RE3n+njDXR037aY1+x58Z/zFdwQ==",
-      "dev": true,
-      "license": "BSD-2-Clause",
-      "dependencies": {
-        "acorn": "^8.9.0",
-        "acorn-jsx": "^5.3.2",
-        "eslint-visitor-keys": "^3.4.1"
-      },
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0"
       }
     },
     "node_modules/vue-router": {
diff --git a/package.json b/package.json
index 72464e7..c9c6dc4 100644
--- a/package.json
+++ b/package.json
@@ -81,7 +81,7 @@
     "concurrently": "^9.2.1",
     "eslint": "^10.3.0",
     "eslint-plugin-vue": "^10.9.1",
-    "vue-eslint-parser": "^9.4.3",
+    "vue-eslint-parser": "^10.3.0",
     "jsdom": "^29.1.1",
     "lucide-vue-next": "^1.0.0",
     "pinia": "^3.0.4",

From 7201dcde75ed3e8951dd9d979e107e6c5283cf5f Mon Sep 17 00:00:00 2001
From: njevric <njevric9@gmail.com>
Date: Wed, 13 May 2026 00:37:43 +0200
Subject: [PATCH 7/7] fix: codeql analyze allert

---
 src/server/routes/audit.ts             |  9 ++++-----
 src/server/routes/packages.ts          |  9 +++------
 src/server/routes/scripts.ts           |  2 +-
 src/server/services/auditService.ts    | 26 +++++++++++++-------------
 src/server/services/operationRunner.ts | 16 +++++++---------
 src/server/services/packageManager.ts  | 26 +++++++++++++-------------
 6 files changed, 41 insertions(+), 47 deletions(-)

diff --git a/src/server/routes/audit.ts b/src/server/routes/audit.ts
index 177bc27..9d33d4e 100644
--- a/src/server/routes/audit.ts
+++ b/src/server/routes/audit.ts
@@ -81,8 +81,7 @@ export function createAuditRouter(projectPath: string): Router {
         return
       }
 
-      const command = getAuditCommand(packageManager)
-      const operationId = runCommand(command, projectPath, 'audit')
+      const operationId = runCommand(getAuditCommand(packageManager), projectPath, 'audit')
 
       // Accumulate stdout from the operation event stream directly — no second spawn needed
       let stdout = ''
@@ -169,11 +168,11 @@ export function createAuditRouter(projectPath: string): Router {
         return
       }
 
-      const command = getAuditFixCommand(packageManager, force, packageName)
-      console.log('[AUDIT FIX] Running command:', command)
+      const auditFixArgv = getAuditFixCommand(packageManager, force, packageName)
+      console.log('[AUDIT FIX] Running command:', auditFixArgv.join(' '))
       console.log('[AUDIT FIX] Force:', force, 'Package:', packageName)
 
-      const operationId = runCommand(command, projectPath, 'audit-fix', packageName)
+      const operationId = runCommand(auditFixArgv, projectPath, 'audit-fix', packageName)
 
       // Log the fix attempt
       addFixLog(projectPath, packageName, force, operationId)
diff --git a/src/server/routes/packages.ts b/src/server/routes/packages.ts
index 32c9001..3545f49 100644
--- a/src/server/routes/packages.ts
+++ b/src/server/routes/packages.ts
@@ -117,8 +117,7 @@ export function createPackagesRouter(projectPath: string): Router {
         return
       }
 
-      const command = getUpdateAllCommand(packageManager, outdated)
-      const operationId = runCommand(command, projectPath, 'update', undefined, undefined)
+      const operationId = runCommand(getUpdateAllCommand(packageManager, outdated), projectPath, 'update', undefined, undefined)
 
       res.json({ success: true, data: { operationId } })
     } catch (error) {
@@ -134,8 +133,7 @@ export function createPackagesRouter(projectPath: string): Router {
 
       // Handle scoped packages - the name might be URL encoded
       const packageName = decodeURIComponent(name)
-      const command = getUninstallCommand(packageManager, packageName)
-      const operationId = runCommand(command, projectPath, 'remove', packageName)
+      const operationId = runCommand(getUninstallCommand(packageManager, packageName), projectPath, 'remove', packageName)
 
       res.json({
         success: true,
@@ -163,8 +161,7 @@ export function createPackagesRouter(projectPath: string): Router {
 
       const packageName = decodeURIComponent(name)
       const fromVersion = getPackages(projectPath).find((p) => p.name === packageName)?.current
-      const command = getUpdateCommand(packageManager, packageName, version)
-      const operationId = runCommand(command, projectPath, 'update', packageName, fromVersion)
+      const operationId = runCommand(getUpdateCommand(packageManager, packageName, version), projectPath, 'update', packageName, fromVersion)
 
       res.json({
         success: true,
diff --git a/src/server/routes/scripts.ts b/src/server/routes/scripts.ts
index 7497dd4..2841d41 100644
--- a/src/server/routes/scripts.ts
+++ b/src/server/routes/scripts.ts
@@ -58,7 +58,7 @@ export function createScriptsRouter(projectPath: string): Router {
       }
 
       const operationId = runCommand(
-        `npm run ${name}`,
+        ['npm', 'run', name],
         projectPath,
         'script',
         undefined,
diff --git a/src/server/services/auditService.ts b/src/server/services/auditService.ts
index 2fd7ae7..b966583 100644
--- a/src/server/services/auditService.ts
+++ b/src/server/services/auditService.ts
@@ -205,16 +205,16 @@ export function clearCache(): void {
 /**
  * Gets the audit command for a package manager
  */
-export function getAuditCommand(packageManager: PackageManager): string {
+export function getAuditCommand(packageManager: PackageManager): string[] {
   switch (packageManager) {
     case 'npm':
-      return 'npm audit --json'
+      return ['npm', 'audit', '--json']
     case 'yarn':
-      return 'yarn audit --json'
+      return ['yarn', 'audit', '--json']
     case 'pnpm':
-      return 'pnpm audit --json'
+      return ['pnpm', 'audit', '--json']
     default:
-      return 'npm audit --json'
+      return ['npm', 'audit', '--json']
   }
 }
 
@@ -225,29 +225,29 @@ export function getAuditFixCommand(
   packageManager: PackageManager,
   force: boolean = false,
   packageName?: string
-): string {
+): string[] {
   if (packageName) {
     // Fix specific package by updating it
     switch (packageManager) {
       case 'npm':
-        return `npm update ${packageName}`
+        return ['npm', 'update', packageName]
       case 'yarn':
-        return `yarn upgrade ${packageName}`
+        return ['yarn', 'upgrade', packageName]
       case 'pnpm':
-        return `pnpm update ${packageName}`
+        return ['pnpm', 'update', packageName]
     }
   }
 
   // Fix all vulnerabilities
   switch (packageManager) {
     case 'npm':
-      return force ? 'npm audit fix --force' : 'npm audit fix'
+      return force ? ['npm', 'audit', 'fix', '--force'] : ['npm', 'audit', 'fix']
     case 'yarn':
       // yarn audit fix doesn't exist; npx yarn-audit-fix is the community equivalent
-      return 'npx yarn-audit-fix@10.1.1'
+      return ['npx', 'yarn-audit-fix@10.1.1']
     case 'pnpm':
-      return 'pnpm audit fix'
+      return ['pnpm', 'audit', 'fix']
     default:
-      return force ? 'npm audit fix --force' : 'npm audit fix'
+      return force ? ['npm', 'audit', 'fix', '--force'] : ['npm', 'audit', 'fix']
   }
 }
diff --git a/src/server/services/operationRunner.ts b/src/server/services/operationRunner.ts
index 4196e87..d0474f3 100644
--- a/src/server/services/operationRunner.ts
+++ b/src/server/services/operationRunner.ts
@@ -23,7 +23,7 @@ export const operationEvents = new EventEmitter()
  * Runs a shell command and streams output via events
  */
 export function runCommand(
-  command: string,
+  argv: string[],
   cwd: string,
   type: Operation['type'],
   packageName?: string,
@@ -31,6 +31,7 @@ export function runCommand(
   scriptName?: string
 ): string {
   const operationId = generateOperationId()
+  const command = argv.join(' ')
 
   const operation: Operation = {
     id: operationId,
@@ -47,23 +48,25 @@ export function runCommand(
 
   // Start operation asynchronously
   setImmediate(() => {
-    executeCommand(operationId, command, cwd)
+    executeCommand(operationId, argv, cwd)
   })
 
   return operationId
 }
 
-async function executeCommand(operationId: string, command: string, cwd: string): Promise<void> {
+async function executeCommand(operationId: string, argv: string[], cwd: string): Promise<void> {
   const operation = activeOperations.get(operationId)
   if (!operation) return
 
   operation.status = 'running'
 
+  const [cmd, ...args] = argv
+
   // Emit start event
   const startEvent: OperationEvent = {
     type: 'start',
     operationId,
-    command,
+    command: operation.command,
     operationType: operation.type,
     packageName: operation.packageName,
     scriptName: operation.scriptName,
@@ -71,11 +74,6 @@ async function executeCommand(operationId: string, command: string, cwd: string)
   }
   operationEvents.emit('event', startEvent)
 
-  // Parse command into parts
-  const parts = command.split(' ')
-  const cmd = parts[0]
-  const args = parts.slice(1)
-
   let childProcess: ChildProcess
 
   try {
diff --git a/src/server/services/packageManager.ts b/src/server/services/packageManager.ts
index d45cd74..eda2a74 100644
--- a/src/server/services/packageManager.ts
+++ b/src/server/services/packageManager.ts
@@ -45,15 +45,15 @@ export function getInstallCommand(
 export function getUninstallCommand(
   pm: PackageManager,
   packageName: string
-): string {
+): string[] {
   switch (pm) {
     case 'pnpm':
-      return `pnpm remove ${packageName}`
+      return ['pnpm', 'remove', packageName]
     case 'yarn':
-      return `yarn remove ${packageName}`
+      return ['yarn', 'remove', packageName]
     case 'npm':
     default:
-      return `npm uninstall ${packageName}`
+      return ['npm', 'uninstall', packageName]
   }
 }
 
@@ -64,34 +64,34 @@ export function getUpdateCommand(
   pm: PackageManager,
   packageName: string,
   version?: string
-): string {
+): string[] {
   const pkg = version ? `${packageName}@${version}` : `${packageName}@latest`
 
   switch (pm) {
     case 'pnpm':
-      return `pnpm add ${pkg}`
+      return ['pnpm', 'add', pkg]
     case 'yarn':
-      return `yarn add ${pkg}`
+      return ['yarn', 'add', pkg]
     case 'npm':
     default:
-      return `npm install ${pkg}`
+      return ['npm', 'install', pkg]
   }
 }
 
 /**
  * Returns a command to update all given packages to latest
  */
-export function getUpdateAllCommand(pm: PackageManager, packageNames: string[]): string {
-  const pkgs = packageNames.map((name) => `${name}@latest`).join(' ')
+export function getUpdateAllCommand(pm: PackageManager, packageNames: string[]): string[] {
+  const pkgs = packageNames.map((name) => `${name}@latest`)
 
   switch (pm) {
     case 'pnpm':
-      return `pnpm add ${pkgs}`
+      return ['pnpm', 'add', ...pkgs]
     case 'yarn':
-      return `yarn add ${pkgs}`
+      return ['yarn', 'add', ...pkgs]
     case 'npm':
     default:
-      return `npm install ${pkgs}`
+      return ['npm', 'install', ...pkgs]
   }
 }