Stacks Linting

Use ./buddy lint, ./buddy lint:fix and ./buddy format. The code-style
commands call Pickier's SDK directly. Pickier is the linter and formatter;
it does not wrap ESLint. ESLint-style disable comments are compatibility syntax.

Commands

• ./buddy lint: report errors and warnings; errors fail the command.
• ./buddy lint --max-warnings 0: require zero errors and warnings.
• ./buddy lint:fix --max-warnings 0: fix supported findings and enforce the warning budget.
• ./buddy format: write formatting; ./buddy format --check checks without writing.
• ./buddy lint --stx: run the separate stx conformance checks from config/lint.ts.

For direct CLI use, run bunx --bun pickier ., adding --fix for supported
fixes. Re-run without --fix to confirm remaining findings. Only apply fixes
that preserve the source behavior; investigate false positives at Pickier's source.

Configuration and discovery

Pickier discovers its own configuration (pickier.config.ts, .config/pickier.ts,
and other supported names). config/code-style.ts is the framework's policy;
applications may supply their own Pickier config. An explicit CLI --config
selects that file. Keep the command and CI on the same policy.

Buddy discovers tracked files plus untracked files allowed by .gitignore.
Its extension and path predicate lives in @stacksjs/actions/lint/files;
Code-style discovery includes ts, js, stx, json, md, yaml and yml, including
ts-css checks in tracked and newly created STX templates. Use Pickier directly
to include shell sources. Generated framework
assets belong to the upstream framework's checks, not application edits.

Conventions

Use two spaces, single quotes and no optional semicolons. Use ts-css classes
and stx signals/directives in templates. Fix real findings in source, rather than
turning off rules to obtain a clean report. For intentional unused variables,
prefer a targeted // eslint-disable-next-line over an underscore prefix.

Source

• Actions: storage/framework/core/actions/src/lint/lint.ts
• CLI: storage/framework/core/buddy/src/commands/lint.ts
• Discovery: storage/framework/core/actions/src/lint/files.ts
• Formatter/linter: the first-party Pickier repository