@getpara/paramedic 2.7.0

package/dist/checks/query-client.check.js

@@ -0,0 +1,58 @@
+import { defineCheck } from "../core/check.js";
+import { findPatternInFiles } from "../utils/ast-parser.js";
+import { hasDependency } from "../utils/package-json.js";
+const queryClientCheck = defineCheck({
+  metadata: {
+    id: "query-client",
+    name: "QueryClientProvider Setup",
+    description: "Checks if QueryClientProvider wraps ParaProvider",
+    category: "setup",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType === "@getpara/react-sdk" || context.sdkType === "@getpara/react-sdk-lite";
+  },
+  async run(context) {
+    if (!context.packageJson) {
+      return [];
+    }
+    const hasReactQuery = hasDependency(context.packageJson, "@tanstack/react-query");
+    if (!hasReactQuery) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: false,
+          severity: this.metadata.severity,
+          message: "@tanstack/react-query is not installed",
+          recommendation: "Install: npm install @tanstack/react-query"
+        }
+      ];
+    }
+    const queryClientPattern = /QueryClientProvider|QueryClient\(/;
+    const locations = await findPatternInFiles(context.files, queryClientPattern, context.shouldIgnoreFile);
+    if (locations.length > 0) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: true,
+          severity: this.metadata.severity,
+          message: "QueryClientProvider is configured",
+          location: locations[0]
+        }
+      ];
+    }
+    return [
+      {
+        checkId: this.metadata.id,
+        passed: false,
+        severity: this.metadata.severity,
+        message: "QueryClientProvider not found",
+        recommendation: "Wrap ParaProvider with QueryClientProvider from @tanstack/react-query"
+      }
+    ];
+  }
+});
+export {
+  queryClientCheck
+};

package/dist/checks/use-client-directive.check.d.ts

@@ -0,0 +1,2 @@
+export declare const useClientDirectiveCheck: import("../core/check.js").Check;
+//# sourceMappingURL=use-client-directive.check.d.ts.map

package/dist/checks/use-client-directive.check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-client-directive.check.d.ts","sourceRoot":"","sources":["../../src/checks/use-client-directive.check.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uBAAuB,kCAwElC,CAAC"}

package/dist/checks/use-client-directive.check.js

@@ -0,0 +1,82 @@
+import { defineCheck } from "../core/check.js";
+import { fileStartsWithDirective } from "../utils/ast-parser.js";
+import { readFile } from "../utils/file-system.js";
+const useClientDirectiveCheck = defineCheck({
+  metadata: {
+    id: "use-client-directive",
+    name: '"use client" Directive',
+    description: 'Checks for "use client" directive in Next.js App Router Para components',
+    category: "setup",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.framework === "nextjs" && (context.sdkType === "@getpara/react-sdk" || context.sdkType === "@getpara/react-sdk-lite");
+  },
+  async run(context) {
+    const results = [];
+    const missingDirective = [];
+    const hasDirective = [];
+    for (const file of context.files) {
+      if (!file.endsWith(".tsx") && !file.endsWith(".jsx")) {
+        continue;
+      }
+      if (context.shouldIgnoreFile(file)) {
+        continue;
+      }
+      const content = await readFile(file);
+      if (!content) continue;
+      const needsUseClient = checkIfNeedsUseClient(content);
+      if (!needsUseClient) {
+        continue;
+      }
+      const hasUseClient = await fileStartsWithDirective(file, "use client");
+      if (hasUseClient) {
+        hasDirective.push(file);
+      } else {
+        missingDirective.push(file);
+      }
+    }
+    if (missingDirective.length > 0) {
+      for (const file of missingDirective) {
+        results.push({
+          checkId: this.metadata.id,
+          passed: false,
+          severity: this.metadata.severity,
+          message: `Missing "use client" directive`,
+          details: "This file defines Para components or uses Para hooks",
+          location: { file, line: 1 },
+          recommendation: 'Add "use client" at the top of the file'
+        });
+      }
+    }
+    if (hasDirective.length > 0 && missingDirective.length === 0) {
+      results.push({
+        checkId: this.metadata.id,
+        passed: true,
+        severity: this.metadata.severity,
+        message: `All ${hasDirective.length} Para component file(s) have "use client" directive`
+      });
+    }
+    return results;
+  }
+});
+function checkIfNeedsUseClient(content) {
+  const definesParaProvider = /(?:function|const|let|var)\s+(?:ParaProvider|ParaSDKProvider)\s*[=(]/.test(content) || /export\s+(?:function|const)\s+(?:ParaProvider|ParaSDKProvider)/.test(content);
+  if (definesParaProvider) {
+    return true;
+  }
+  const usesParaHooks = /\b(?:usePara|useParaModal|useParaClient|useParaSelector|useParaWallet)\s*\(/.test(content);
+  if (usesParaHooks) {
+    return true;
+  }
+  const importsFromReactSdkLite = /@getpara\/react-sdk-lite/.test(content);
+  const usesDirectParaImport = importsFromReactSdkLite && /import\s+\{[^}]*(?:Para|usePara)[^}]*\}\s+from\s+['"]@getpara/.test(content);
+  if (usesDirectParaImport) {
+    return true;
+  }
+  return false;
+}
+export {
+  useClientDirectiveCheck
+};

package/dist/checks/version-consistency.check.d.ts

@@ -0,0 +1,2 @@
+export declare const versionConsistencyCheck: import("../core/check.js").Check;
+//# sourceMappingURL=version-consistency.check.d.ts.map

package/dist/checks/version-consistency.check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-consistency.check.d.ts","sourceRoot":"","sources":["../../src/checks/version-consistency.check.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,uBAAuB,kCAoGlC,CAAC"}

package/dist/checks/version-consistency.check.js

@@ -0,0 +1,93 @@
+import { defineCheck } from "../core/check.js";
+import { getParaPackages } from "../utils/package-json.js";
+function normalizeVersion(v) {
+  return v.replace(/^[\^~]/, "");
+}
+function isAlphaVersion(version) {
+  return /^2\.0\.0-alpha/.test(normalizeVersion(version));
+}
+function isV1Version(version) {
+  return /^1\./.test(normalizeVersion(version));
+}
+const versionConsistencyCheck = defineCheck({
+  metadata: {
+    id: "version-consistency",
+    name: "Package Version Consistency",
+    description: "Checks if all @getpara/* packages have matching and up-to-date versions",
+    category: "dependencies",
+    severity: "warning",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType !== "none" && context.packageJson !== null;
+  },
+  async run(context) {
+    if (!context.packageJson) {
+      return [];
+    }
+    const paraPackages = getParaPackages(context.packageJson);
+    if (paraPackages.length === 0) {
+      return [];
+    }
+    const results = [];
+    const alphaPackages = paraPackages.filter((p) => isAlphaVersion(p.version));
+    const v1Packages = paraPackages.filter((p) => isV1Version(p.version));
+    if (alphaPackages.length > 0) {
+      results.push({
+        checkId: this.metadata.id,
+        passed: false,
+        severity: "error",
+        message: "Deprecated alpha version detected",
+        details: alphaPackages.map((p) => `${p.name}@${p.version}`).join(", "),
+        recommendation: "Upgrade to latest stable 2.x.x version"
+      });
+    }
+    if (v1Packages.length > 0) {
+      results.push({
+        checkId: this.metadata.id,
+        passed: false,
+        severity: "error",
+        message: "Outdated v1 version detected",
+        details: v1Packages.map((p) => `${p.name}@${p.version}`).join(", "),
+        recommendation: "Upgrade to latest 2.x.x version"
+      });
+    }
+    if (paraPackages.length > 1) {
+      const versions = new Set(paraPackages.map((p) => normalizeVersion(p.version)));
+      if (versions.size > 1) {
+        const versionGroups = /* @__PURE__ */ new Map();
+        paraPackages.forEach(({ name, version }) => {
+          const normalized = normalizeVersion(version);
+          if (!versionGroups.has(normalized)) {
+            versionGroups.set(normalized, []);
+          }
+          versionGroups.get(normalized).push(name);
+        });
+        const details = Array.from(versionGroups.entries()).map(([version, packages]) => `  ${version}: ${packages.join(", ")}`).join("\n");
+        results.push({
+          checkId: this.metadata.id,
+          passed: false,
+          severity: this.metadata.severity,
+          message: "Inconsistent @getpara/* package versions",
+          details: `Version mismatch:
+${details}`,
+          recommendation: "Update all @getpara/* packages to the same 2.x.x version"
+        });
+      }
+    }
+    if (results.length === 0) {
+      const version = normalizeVersion(paraPackages[0].version);
+      const message = paraPackages.length === 1 ? `Single Para package: ${paraPackages[0].name}@${version}` : `All ${paraPackages.length} Para packages use version ${version}`;
+      results.push({
+        checkId: this.metadata.id,
+        passed: true,
+        severity: this.metadata.severity,
+        message
+      });
+    }
+    return results;
+  }
+});
+export {
+  versionConsistencyCheck
+};

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function cli(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAwDA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAyDzC"}

package/dist/cli.js

@@ -0,0 +1,96 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { createContext } from "./core/context.js";
+import { runChecks } from "./core/runner.js";
+import { printHeader, printDetection, printResults } from "./core/reporter.js";
+import { registerAllChecks } from "./checks/index.js";
+function parseArgs(args) {
+  let projectRoot = process.cwd();
+  let help = false;
+  let version = false;
+  for (const arg of args) {
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+    } else if (arg === "--version" || arg === "-v") {
+      version = true;
+    } else if (!arg.startsWith("-")) {
+      projectRoot = arg.startsWith("/") ? arg : `${process.cwd()}/${arg}`;
+    }
+  }
+  return { projectRoot, help, version };
+}
+function printHelp() {
+  console.log(`
+${pc.bold("Paramedic")} - Para SDK Diagnostic Tool
+
+${pc.bold("Usage:")}
+  npx @getpara/paramedic [path]
+
+${pc.bold("Options:")}
+  -h, --help      Show this help message
+  -v, --version   Show version number
+
+${pc.bold("Examples:")}
+  npx @getpara/paramedic              # Scan current directory
+  npx @getpara/paramedic ./my-app     # Scan specific directory
+
+${pc.bold("Checks performed:")}
+  \u2022 API key configuration
+  \u2022 CSS styles import
+  \u2022 ParaProvider setup
+  \u2022 QueryClientProvider wrapping
+  \u2022 Package version consistency
+  \u2022 Chain dependencies (EVM, Solana, Cosmos)
+  \u2022 "use client" directive (Next.js)
+  \u2022 Environment variable prefix
+`);
+}
+async function cli() {
+  const args = process.argv.slice(2);
+  const { projectRoot, help, version } = parseArgs(args);
+  if (version) {
+    console.log("@getpara/paramedic v2.7.0");
+    process.exit(0);
+  }
+  if (help) {
+    printHelp();
+    process.exit(0);
+  }
+  printHeader();
+  registerAllChecks();
+  const s = p.spinner();
+  s.start("Analyzing project...");
+  let context;
+  try {
+    context = await createContext(projectRoot);
+    s.stop("Analysis complete");
+  } catch (error) {
+    s.stop("Analysis failed");
+    console.log(pc.red("Failed to analyze project:"));
+    console.log(pc.dim(error instanceof Error ? error.message : String(error)));
+    process.exit(1);
+  }
+  printDetection(context);
+  if (context.sdkType === "none") {
+    console.log(pc.yellow("No Para SDK detected in this project."));
+    console.log(pc.dim("Make sure @getpara/react-sdk or @getpara/react-sdk-lite is installed."));
+    process.exit(0);
+  }
+  s.start("Running diagnostic checks...");
+  let runResult;
+  try {
+    runResult = await runChecks(context);
+    s.stop("Checks complete");
+  } catch (error) {
+    s.stop("Checks failed");
+    console.log(pc.red("Failed to run checks:"));
+    console.log(pc.dim(error instanceof Error ? error.message : String(error)));
+    process.exit(1);
+  }
+  printResults(runResult);
+  const exitCode = runResult.failed > 0 ? 1 : 0;
+  process.exit(exitCode);
+}
+export {
+  cli
+};

package/dist/core/check.d.ts

@@ -0,0 +1,21 @@
+import type { CheckResult, DiagnosticContext, CheckSeverity, CheckCategory } from '../types.js';
+export interface CheckMetadata {
+    id: string;
+    name: string;
+    description: string;
+    category: CheckCategory;
+    severity: CheckSeverity;
+    enabled: boolean;
+}
+export interface Check {
+    metadata: CheckMetadata;
+    shouldRun: (context: DiagnosticContext) => boolean;
+    run: (context: DiagnosticContext) => Promise<CheckResult[]>;
+}
+export interface CheckConfig {
+    metadata: CheckMetadata;
+    shouldRun?: (context: DiagnosticContext) => boolean;
+    run: (context: DiagnosticContext) => Promise<CheckResult[]>;
+}
+export declare function defineCheck(config: CheckConfig): Check;
+//# sourceMappingURL=check.d.ts.map

package/dist/core/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/core/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;IACnD,GAAG,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;IACpD,GAAG,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC7D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAMtD"}

package/dist/core/check.js

@@ -0,0 +1,10 @@
+function defineCheck(config) {
+  return {
+    metadata: config.metadata,
+    shouldRun: config.shouldRun ?? (() => true),
+    run: config.run
+  };
+}
+export {
+  defineCheck
+};

package/dist/core/context.d.ts

@@ -0,0 +1,3 @@
+import type { DiagnosticContext } from '../types.js';
+export declare function createContext(projectRoot: string): Promise<DiagnosticContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkDnF"}

package/dist/core/context.js

@@ -0,0 +1,56 @@
+import path from "node:path";
+import ignoreModule from "ignore";
+import { detectFramework } from "../detectors/framework.js";
+import { detectSDKType } from "../detectors/sdk.js";
+import { detectPackageManager } from "../detectors/package-manager.js";
+import { readPackageJson } from "../utils/package-json.js";
+import { findProjectFiles, readGitignore } from "../utils/file-system.js";
+async function createContext(projectRoot) {
+  const packageJson = await readPackageJson(projectRoot);
+  const ig = ignoreModule.default();
+  const gitignoreContent = await readGitignore(projectRoot);
+  if (gitignoreContent) {
+    ig.add(gitignoreContent);
+  }
+  ig.add([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    ".cache",
+    ".turbo",
+    "coverage",
+    ".output",
+    "out",
+    ".nuxt",
+    ".svelte-kit",
+    ".vercel",
+    ".netlify"
+  ]);
+  const shouldIgnoreFile = (file) => {
+    const relativePath = path.relative(projectRoot, file);
+    if (!relativePath || relativePath.startsWith("..")) {
+      return true;
+    }
+    return ig.ignores(relativePath);
+  };
+  const files = await findProjectFiles(projectRoot, shouldIgnoreFile);
+  const framework = await detectFramework(projectRoot, packageJson);
+  const { sdkType, sdkVersion } = detectSDKType(packageJson);
+  const packageManager = await detectPackageManager(projectRoot);
+  return {
+    projectRoot,
+    packageManager,
+    framework,
+    sdkType,
+    sdkVersion,
+    files,
+    packageJson,
+    shouldIgnoreFile,
+    cache: /* @__PURE__ */ new Map()
+  };
+}
+export {
+  createContext
+};

package/dist/core/registry.d.ts

@@ -0,0 +1,18 @@
+import type { Check } from './check.js';
+import type { CheckCategory, CheckSeverity } from '../types.js';
+declare class CheckRegistry {
+    private checks;
+    register(check: Check): void;
+    unregister(checkId: string): void;
+    get(checkId: string): Check | undefined;
+    getAll(): Check[];
+    getEnabled(): Check[];
+    filterBy(filters: {
+        categories?: CheckCategory[];
+        severity?: CheckSeverity[];
+    }): Check[];
+    clear(): void;
+}
+export declare const registry: CheckRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAA4B;IAE1C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAO5B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIvC,MAAM,IAAI,KAAK,EAAE;IAIjB,UAAU,IAAI,KAAK,EAAE;IAIrB,QAAQ,CAAC,OAAO,EAAE;QAAE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;KAAE,GAAG,KAAK,EAAE;IAcxF,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,QAAQ,eAAsB,CAAC"}

package/dist/core/registry.js

@@ -0,0 +1,38 @@
+class CheckRegistry {
+  checks = /* @__PURE__ */ new Map();
+  register(check) {
+    if (this.checks.has(check.metadata.id)) {
+      throw new Error(`Check "${check.metadata.id}" is already registered`);
+    }
+    this.checks.set(check.metadata.id, check);
+  }
+  unregister(checkId) {
+    this.checks.delete(checkId);
+  }
+  get(checkId) {
+    return this.checks.get(checkId);
+  }
+  getAll() {
+    return Array.from(this.checks.values());
+  }
+  getEnabled() {
+    return this.getAll().filter((c) => c.metadata.enabled);
+  }
+  filterBy(filters) {
+    let checks = this.getEnabled();
+    if (filters.categories?.length) {
+      checks = checks.filter((c) => filters.categories.includes(c.metadata.category));
+    }
+    if (filters.severity?.length) {
+      checks = checks.filter((c) => filters.severity.includes(c.metadata.severity));
+    }
+    return checks;
+  }
+  clear() {
+    this.checks.clear();
+  }
+}
+const registry = new CheckRegistry();
+export {
+  registry
+};

package/dist/core/reporter.d.ts

@@ -0,0 +1,5 @@
+import type { DiagnosticContext, RunResult } from '../types.js';
+export declare function printHeader(): void;
+export declare function printDetection(context: DiagnosticContext): void;
+export declare function printResults(runResult: RunResult): void;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/core/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/core/reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7E,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAM/D;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CA+CvD"}

package/dist/core/reporter.js

@@ -0,0 +1,82 @@
+import pc from "picocolors";
+const symbols = {
+  success: "\u2713",
+  error: "\u2717",
+  warning: "\u26A0",
+  info: "\u2139"
+};
+function printHeader() {
+  console.log();
+  console.log(pc.bgCyan(pc.black(" \u{1F3E5} Paramedic ")));
+  console.log(pc.dim("Para SDK Diagnostic Tool"));
+  console.log();
+}
+function printDetection(context) {
+  console.log(pc.dim("Project Info:"));
+  console.log(`  Framework: ${pc.cyan(context.framework)}`);
+  console.log(`  SDK: ${pc.cyan(context.sdkType)}${context.sdkVersion ? pc.dim(` (${context.sdkVersion})`) : ""}`);
+  console.log(`  Package Manager: ${pc.cyan(context.packageManager)}`);
+  console.log();
+}
+function printResults(runResult) {
+  console.log(pc.bold("Diagnostic Results"));
+  console.log(pc.dim("\u2500".repeat(50)));
+  console.log();
+  const errors = runResult.results.filter((r) => !r.passed && r.severity === "error");
+  const warnings = runResult.results.filter((r) => !r.passed && r.severity === "warning");
+  const info = runResult.results.filter((r) => !r.passed && r.severity === "info");
+  const passed = runResult.results.filter((r) => r.passed);
+  if (errors.length > 0) {
+    console.log(pc.red(pc.bold(`${symbols.error} Errors (${errors.length})`)));
+    errors.forEach((r) => printResult(r));
+    console.log();
+  }
+  if (warnings.length > 0) {
+    console.log(pc.yellow(pc.bold(`${symbols.warning} Warnings (${warnings.length})`)));
+    warnings.forEach((r) => printResult(r));
+    console.log();
+  }
+  if (info.length > 0) {
+    console.log(pc.blue(pc.bold(`${symbols.info} Info (${info.length})`)));
+    info.forEach((r) => printResult(r));
+    console.log();
+  }
+  if (passed.length > 0) {
+    console.log(pc.green(pc.bold(`${symbols.success} Passed (${passed.length})`)));
+    passed.forEach((r) => {
+      console.log(`  ${pc.green(symbols.success)} ${pc.dim(r.message)}`);
+    });
+    console.log();
+  }
+  console.log(pc.dim("\u2500".repeat(50)));
+  console.log();
+  console.log(pc.bold("Summary:"));
+  console.log(`  ${pc.green(symbols.success)} ${runResult.passed} passed`);
+  if (runResult.failed > 0) {
+    console.log(`  ${pc.red(symbols.error)} ${runResult.failed} errors`);
+  }
+  if (runResult.warnings > 0) {
+    console.log(`  ${pc.yellow(symbols.warning)} ${runResult.warnings} warnings`);
+  }
+  console.log();
+}
+function printResult(result) {
+  const symbol = result.severity === "error" ? pc.red(symbols.error) : result.severity === "warning" ? pc.yellow(symbols.warning) : pc.blue(symbols.info);
+  console.log(`  ${symbol} ${result.message}`);
+  if (result.details) {
+    console.log(`    ${pc.dim(result.details)}`);
+  }
+  if (result.location) {
+    const loc = result.location;
+    const locStr = loc.line ? `${loc.file}:${loc.line}${loc.column ? `:${loc.column}` : ""}` : loc.file;
+    console.log(`    ${pc.dim("at")} ${pc.cyan(locStr)}`);
+  }
+  if (result.recommendation) {
+    console.log(`    ${pc.cyan("\u2192")} ${result.recommendation}`);
+  }
+}
+export {
+  printDetection,
+  printHeader,
+  printResults
+};

package/dist/core/runner.d.ts

@@ -0,0 +1,3 @@
+import type { DiagnosticContext, CheckOptions, RunResult } from '../types.js';
+export declare function runChecks(context: DiagnosticContext, options?: CheckOptions): Promise<RunResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/core/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAe,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG3F,wBAAsB,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAsC1G"}

package/dist/core/runner.js

@@ -0,0 +1,38 @@
+import { registry } from "./registry.js";
+async function runChecks(context, options = {}) {
+  const checks = registry.filterBy({
+    categories: options.categories,
+    severity: options.severity
+  });
+  const results = [];
+  for (const check of checks) {
+    if (!check.shouldRun(context)) {
+      continue;
+    }
+    try {
+      const checkResults = await check.run(context);
+      results.push(...checkResults);
+    } catch (error) {
+      results.push({
+        checkId: check.metadata.id,
+        passed: false,
+        severity: "error",
+        message: `Check "${check.metadata.name}" threw an error`,
+        details: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  const passed = results.filter((r) => r.passed).length;
+  const failed = results.filter((r) => !r.passed && r.severity === "error").length;
+  const warnings = results.filter((r) => !r.passed && r.severity === "warning").length;
+  return {
+    results,
+    passed,
+    failed,
+    warnings,
+    total: results.length
+  };
+}
+export {
+  runChecks
+};

package/dist/detectors/framework.d.ts

@@ -0,0 +1,5 @@
+import type { Framework, PackageJsonData } from '../types.js';
+export declare function detectFramework(projectRoot: string, packageJson: PackageJsonData | null): Promise<Framework>;
+export declare function getEnvVarPrefix(framework: Framework): string;
+export declare function getEnvAccessPattern(framework: Framework): string;
+//# sourceMappingURL=framework.d.ts.map

package/dist/detectors/framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/detectors/framework.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CA0ClH;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAc5D;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAahE"}