Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import fs from 'node:fs'
import path from 'node:path'
import process from 'node:process'
import { pathToFileURL } from 'node:url'
import { readTrackedSources, runEntryRatchet } from './ratchet-baseline.mjs'
// Ratchet gate for the oxlint `max-lines` rule.
//
// oxlint already fails any file that exceeds max-lines WITHOUT a suppression, so
// the only way a file grows past the budget is by adding an `eslint/oxlint-disable
// max-lines` comment or a per-file `max-lines` bump in mobile/.oxlintrc.json. This
// check freezes the set of files currently allowed to do that (the baseline) and
// fails CI when a NEW bypass appears — the existing over-limit files are
// grandfathered; new ones must split instead. The baseline may only shrink.
const BASELINE_PATH = 'config/max-lines-baseline.txt'
const MOBILE_CONFIG_PATH = 'mobile/.oxlintrc.json'
// Exclude gate/fixtures containing directive text as data or scanning self-flags.
const SELF_FILES = new Set([
'config/scripts/check-max-lines-ratchet.mjs',
'config/scripts/check-max-lines-ratchet.test.mjs'
])
export function defaultLimitForPath(p) {
if (/\.(test|spec)\.(ts|tsx|mts|cts)$/.test(p)) {
return 800
}
if (p.endsWith('.tsx')) {
return 400
}
if (p.endsWith('.mjs')) {
return 600
}
return 300
}
// True if the source contains an eslint/oxlint disable directive listing `max-lines`
// (block or line, bare or compound, with or without a `-- Why:` reason).
export function hasMaxLinesDisable(sourceText) {
const re = /(?:eslint|oxlint)-disable(?:-next-line|-line)?\b([^\n]*)/g
let m
while ((m = re.exec(sourceText)) !== null) {
let rules = m[1]
rules = rules.split('--')[0]
const close = rules.indexOf('*/')
if (close !== -1) {
rules = rules.slice(0, close)
}
if (/\bmax-lines\b/.test(rules)) {
return true
}
}
return false
}
// Only budget increases bypass max-lines; lower maxima are stricter.
export function collectMobileBumps(configText) {
const cfg = JSON.parse(configText)
const bumps = []
for (const override of cfg.overrides ?? []) {
const rule = override.rules?.['max-lines']
if (!Array.isArray(rule) || typeof rule[1]?.max !== 'number') {
continue
}
for (const glob of override.files ?? []) {
if (rule[1].max > defaultLimitForPath(glob)) {
bumps.push(`mobile-config ${glob}`)
}
}
}
return bumps
}
export function collectCurrentSuppressions(root = process.cwd()) {
const sources = readTrackedSources(
root,
['*.ts', '*.tsx', '*.mts', '*.cts', '*.mjs'],
(rel) => !SELF_FILES.has(rel)
)
const entries = [...sources]
.filter(([, src]) => hasMaxLinesDisable(src))
.map(([rel]) => `inline ${rel}`)
const mobileCfgPath = path.join(root, MOBILE_CONFIG_PATH)
if (fs.existsSync(mobileCfgPath)) {
entries.push(...collectMobileBumps(fs.readFileSync(mobileCfgPath, 'utf8')))
}
return entries.sort()
}
const RATCHET = {
name: 'max-lines',
baselinePath: BASELINE_PATH,
header: [
'# Files/globs currently allowed to exceed the oxlint `max-lines` budget.',
'# This is a RATCHET: the list may only SHRINK. Do NOT add entries to get CI green —',
'# split the oversized file instead.',
'# Regenerate/prune: pnpm check:max-lines-ratchet --prune (removes stale entries only)'
],
collect: collectCurrentSuppressions,
fix: [
'An `inline` entry added an eslint/oxlint-disable max-lines comment; a `mobile-config` entry',
'added a per-file max-lines bump in mobile/.oxlintrc.json. Orca caps file size (300',
'.ts/.mts/.cts / 400 .tsx / 600 .mjs / 800 test — non-blank, non-comment lines).',
'Fix it: SPLIT the file into focused modules — do NOT suppress the rule.'
]
}
export function main(root = process.cwd(), arg = undefined) {
return runEntryRatchet(RATCHET, root, arg)
}
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
process.exit(main(process.cwd(), process.argv[2]))
}