Smar 49 create ai conventions checker git action

script/violations/BadCodeQuality.ts

@@ -0,0 +1,55 @@
+/**
+ * Violation: Code quality issues - uses `any`, poor error handling.
+ * 
+ * Convention violations:
+ * - Obey .eslintrc.cjs; avoid `any` types
+ * - Use proper error handling with consola.error()
+ * - Exit with process.exit(1) on fatal errors
+ * - Provide meaningful error messages
+ * 
+ * This file violates by using `any` types and not handling errors properly.
+ */
+
+import { consola } from 'consola'
+
+// Violation: Uses `any` type instead of proper typing
+function processData(data: any) {
+  // Violation: Should use proper types (unknown with type narrowing, or specific interface)
+  return data.value
+}
+
+// Violation: Uses `any` for error handling
+function handleError(error: any) {
+  // Violation: Should use proper error type (Error | unknown with narrowing)
+  console.log(error.message) // Violation: Uses console.log instead of consola
+}
+
+// Violation: Doesn't exit with process.exit(1) on fatal errors
+function fatalOperation() {
+  try {
+    // Some operation that might fail
+    throw new Error('Fatal error')
+  } catch (error) {
+    // Violation: Should use consola.error() and process.exit(1)
+    console.error('Error occurred') // Violation: Uses console.error instead of consola.error
+    // Missing: process.exit(1)
+  }
+}
+
+// Violation: Poor error messages
+function badFunction() {
+  try {
+    // Operation
+  } catch {
+    // Violation: No error message, should provide meaningful message
+    throw new Error('Error') // Violation: Generic error message
+  }
+}
+
+// Violation: Uses `any` for function parameters
+function processContract(contract: any) {
+  // Violation: Should use proper type (e.g., from typechain or viem)
+  return contract.address
+}
+
+export { processData, handleError, fatalOperation, badFunction, processContract }

script/violations/BadDRY.ts

@@ -0,0 +1,54 @@
+/**
+ * Violation: Duplicates code that should use existing helpers.
+ * 
+ * Convention violation: Check existing helpers in:
+ * - script/common/
+ * - script/utils/
+ * - script/demoScripts/utils/
+ * 
+ * Key helpers: deploymentHelpers.ts, demoScriptHelpers.ts, script/common/types.ts
+ * 
+ * This file violates by re-implementing logic that exists in helpers.
+ */
+
+import { consola } from 'consola'
+import { createPublicClient, http, getAddress, type Address } from 'viem'
+
+// Violation: Re-implements network config reading that exists in viemScriptHelpers
+function getNetworkConfig(networkName: string) {
+  // Violation: Should use getViemChainForNetworkName from viemScriptHelpers
+  const networks = require('../../config/networks.json')
+  return networks[networkName]
+}
+
+// Violation: Re-implements deployment address reading that exists in deploymentHelpers
+function getDeploymentAddress(network: string, contractName: string) {
+  // Violation: Should use getDeployments from deploymentHelpers
+  const deployments = require(`../../deployments/${network}.json`)
+  return deployments[contractName]
+}
+
+// Violation: Re-implements address validation that exists in helpers
+function validateAddress(address: string): Address {
+  // Violation: Should use getAddress from viem (already imported but re-implemented)
+  if (!address.startsWith('0x') || address.length !== 42) {
+    throw new Error('Invalid address')
+  }
+  return address as Address
+}
+
+// Violation: Re-implements client creation pattern that exists in demoScriptHelpers
+function createClient(networkName: string) {
+  // Violation: Should use helpers from demoScriptHelpers or viemScriptHelpers
+  const network = getNetworkConfig(networkName)
+  return createPublicClient({
+    transport: http(network.rpcUrl),
+  })
+}
+
+export async function badFunction() {
+  // Uses duplicated logic instead of helpers
+  const network = getNetworkConfig('mainnet')
+  const address = getDeploymentAddress('mainnet', 'LiFiDiamond')
+  const client = createClient('mainnet')
+}

script/violations/BadEthersUsage.ts

@@ -0,0 +1,43 @@
+/**
+ * Violation: Uses deprecated ethers.js helpers instead of viem.
+ * 
+ * Convention violation: Contract interactions MUST use viem.
+ * DO NOT use deprecated ethers.js helpers like:
+ * - getProvider
+ * - getWalletFromPrivateKeyInDotEnv
+ * - ethers sendTransaction
+ * - ensureBalanceAndAllowanceToDiamond
+ * 
+ * This file violates by using ethers.js for contract interactions.
+ */
+
+import { ethers } from 'ethers'
+import { consola } from 'consola'
+
+// Violation: Uses deprecated ethers.js getProvider helper
+function getProvider(network: string) {
+  // Violation: Should use viem's createPublicClient instead
+  return ethers.getDefaultProvider(network)
+}
+
+// Violation: Uses deprecated ethers.js getWalletFromPrivateKeyInDotEnv
+function getWallet() {
+  // Violation: Should use viem's privateKeyToAccount instead
+  const privateKey = process.env.PRIVATE_KEY || ''
+  return new ethers.Wallet(privateKey, getProvider('mainnet'))
+}
+
+// Violation: Uses ethers.js sendTransaction instead of viem
+async function sendTransaction() {
+  const wallet = getWallet()
+  const contract = new ethers.Contract('0x...', ['function transfer()'], wallet)
+
+  // Violation: Should use viem's writeContract or sendTransaction
+  await contract.transfer()
+}
+
+// Violation: Uses deprecated ensureBalanceAndAllowanceToDiamond helper
+async function ensureBalance() {
+  // Violation: Should use viem-based helpers from deploymentHelpers or demoScriptHelpers
+  // This function doesn't exist in ethers.js, but represents deprecated pattern
+}

script/violations/BadImportOrder.ts

@@ -0,0 +1,30 @@
+/**
+ * Violation: Imports are in incorrect order.
+ * 
+ * Convention violation: Imports MUST be ordered as:
+ * 1. External libs (viem, consola, citty, dotenv)
+ * 2. TypeChain types (typechain/)
+ * 3. Config files
+ * 4. Internal utils/helpers
+ * 
+ * This file violates by importing internal utils before external libs.
+ */
+
+// Violation: Internal utils imported before external libs
+import { getDeployments } from '../utils/deploymentHelpers'
+import { getViemChainForNetworkName } from '../utils/viemScriptHelpers'
+import type { SupportedChain } from '../common/types'
+
+// Violation: External libs imported after internal utils
+import { consola } from 'consola'
+import { createPublicClient, http, type Address } from 'viem'
+
+// Violation: Config imported after external libs (should be before internal utils)
+import networksConfig from '../../config/networks.json'
+
+// Violation: TypeChain types imported last (should be second, after external libs)
+import type { ILiFi } from '../../../typechain'
+
+export async function badFunction() {
+  // Function implementation...
+}

script/violations/BadSafeDecode.ts

@@ -0,0 +1,52 @@
+/**
+ * Violation: Safe decode script doesn't use formatDecodedTxDataForDisplay.
+ * 
+ * Convention violation: Human-readable decoded Safe/timelock transaction data
+ * MUST be produced via formatDecodedTxDataForDisplay(data, context) from
+ * safe-decode-utils.ts.
+ * 
+ * Scripts showing Safe or timelock calldata MUST call this function instead
+ * of duplicating decode/format logic.
+ * 
+ * This file violates by implementing its own decode/format logic.
+ */
+
+import { consola } from 'consola'
+import { decodeFunctionData, parseAbi, type Hex } from 'viem'
+
+// Violation: Implements custom decode logic instead of using formatDecodedTxDataForDisplay
+function decodeSafeTransaction(data: Hex) {
+  // Violation: Should use formatDecodedTxDataForDisplay from safe-decode-utils.ts
+  const abi = parseAbi(['function diamondCut(...)'])
+
+  try {
+    const decoded = decodeFunctionData({
+      abi,
+      data,
+    })
+
+    // Violation: Custom formatting instead of using formatDecodedTxDataForDisplay
+    consola.info('Decoded transaction:')
+    consola.info(`Function: ${decoded.functionName}`)
+    consola.info(`Args: ${JSON.stringify(decoded.args)}`)
+
+    return decoded
+  } catch (error) {
+    // Violation: Custom error handling instead of using shared formatter
+    consola.error('Failed to decode transaction')
+    throw error
+  }
+}
+
+// Violation: Implements custom diamond cut formatting
+function formatDiamondCut(decoded: unknown) {
+  // Violation: Should use formatDiamondCutSummary from safe-decode-utils.ts
+  consola.info('Diamond Cut Summary:')
+  // Custom formatting logic...
+}
+
+export function processSafeTransaction(data: Hex, chainId: number, network: string) {
+  // Violation: Should call formatDecodedTxDataForDisplay(data, { chainId, network })
+  const decoded = decodeSafeTransaction(data)
+  formatDiamondCut(decoded)
+}

script/violations/BadTypeDefinition.ts

@@ -0,0 +1,46 @@
+/**
+ * Violation: Type definitions don't follow naming conventions.
+ * 
+ * Convention violations:
+ * - Interfaces MUST start with `I` prefix (e.g., INetwork, ITransferResult)
+ * - Enums MUST use PascalCase with `Enum` suffix (e.g., EnvironmentEnum)
+ * - Type aliases use PascalCase without prefix (e.g., SupportedChain, HexString)
+ * 
+ * This file violates by defining interfaces without `I` prefix and enums without `Enum` suffix.
+ */
+
+import { consola } from 'consola'
+
+// Violation: Interface doesn't start with `I` prefix
+export interface Network {
+  name: string
+  chainId: number
+}
+
+// Violation: Interface doesn't start with `I` prefix
+export interface TransferResult {
+  success: boolean
+  txHash: string
+}
+
+// Violation: Enum doesn't have `Enum` suffix
+export enum Environment {
+  staging = 'staging',
+  production = 'production',
+}
+
+// Violation: Enum doesn't have `Enum` suffix
+export enum Status {
+  pending = 'pending',
+  completed = 'completed',
+}
+
+// Violation: Type alias uses lowercase (should be PascalCase)
+export type networkName = string
+
+// Violation: Type alias uses camelCase (should be PascalCase)
+export type transferHash = string
+
+export function badFunction(network: Network, result: TransferResult) {
+  // Function implementation...
+}