name: check-imports description: Import/export validation post-implementation. Checks that all imports resolve to actual exports, catches broken references and circular dependencies.

check-imports - Import/Export Validation

Validates import/export consistency after implementation. Catches broken imports, missing exports, and circular dependencies before code review.

Input Schema

{
  "project_dir": "/path/to/project",
  "scope": "changed|all",
  "ticket_id": "TICKET-XXX"
}

Instructions

1. Get Files to Check

cd $project_dir

# If scope=changed, get modified files
git diff --name-only HEAD~1 | grep -E '\.(js|jsx|ts|tsx|mjs)$'

# If scope=all, get all source files
find src -name "*.js" -o -name "*.jsx" -o -name "*.ts" -o -name "*.tsx"

2. Extract Imports

For each file, extract import statements:

// Named imports
import { Foo, Bar } from './module'

// Default imports
import Baz from './module'

// Namespace imports
import * as Utils from './utils'

// Dynamic imports
const Module = await import('./module')

3. Validate Each Import

For each import statement:
    1. Resolve import path relative to current file
    2. Check if target file exists
    3. If named import, check if export exists in target
    4. If default import, check for default export

4. Check for Circular Dependencies

Build dependency graph:
    A imports B
    B imports C
    C imports A  → CIRCULAR!

Report cycles that include changed files

Output Format

{
  "skill": "check-imports",
  "status": "success|errors",
  "files_checked": 8,
  "imports_validated": 42,
  "issues": [
    {
      "type": "broken_import",
      "file": "src/components/Dashboard.js",
      "line": 5,
      "import": "{ MetricCard }",
      "from": "./MetricCard",
      "error": "File not found: src/components/MetricCard.js",
      "suggestion": "Check if file was created or path is correct"
    },
    {
      "type": "missing_export",
      "file": "src/utils/helpers.js",
      "line": 2,
      "import": "{ formatDate }",
      "from": "./date-utils",
      "error": "formatDate is not exported from ./date-utils",
      "suggestion": "Add 'export' to formatDate function or check spelling"
    },
    {
      "type": "circular_dependency",
      "cycle": ["A.js", "B.js", "C.js", "A.js"],
      "severity": "warning",
      "suggestion": "Extract shared code to separate module"
    }
  ],
  "errors": [],
  "warnings": [],
  "next_action": "proceed|fix"
}

Issue Types

Decision Logic

Any broken_import or missing_export?
    YES → status: "errors", next_action: "fix"

Only circular_dependency warnings?
    YES → status: "success", add warnings

No issues?
    YES → status: "success", next_action: "proceed"

Usage Examples

Check changed files:

{
  "project_dir": "/projects/oxygen_site",
  "scope": "changed"
}

Check all files:

{
  "project_dir": "/projects/oxygen_site",
  "scope": "all"
}

Check ticket-specific files:

{
  "project_dir": "/projects/oxygen_site",
  "scope": "changed",
  "ticket_id": "TICKET-OXY-003"
}

Common Fixes

Platform Support

Token Efficiency

• AST-free regex parsing for speed
• Only validates changed files
• ~3-10 second execution
• Returns actionable fix suggestions