LintSAFE

A platform for packaging and launching blockchain infra. Think docker compose for blockchain

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: lint
description: Lint and format Kurtosis Starlark files. Check syntax, validate docstrings, and auto-format .star files. Use when writing or reviewing Starlark packages to ensure code quality.
compatibility: Requires kurtosis CLI.
metadata:
  author: ethpandaops
  version: "1.0"
---

# Lint

Lint and format Kurtosis Starlark (.star) files.

## Check formatting

```bash
# Check a single file
kurtosis lint main.star

# Check a directory
kurtosis lint ./my-package/

# Check multiple files
kurtosis lint main.star lib.star helpers.star
```

Returns non-zero exit code if formatting issues are found.

## Auto-format

Fix formatting in place:

```bash
kurtosis lint -f main.star

# Format all files in a package
kurtosis lint -f ./my-package/
```

## Check docstrings

Validate that the main function has a proper docstring:

```bash
kurtosis lint -c ./my-package/main.star

# Or point to the package directory
kurtosis lint -c ./my-package/
```

This checks that the `run` function has a valid docstring describing its parameters.

## CI integration

```bash
# Check formatting (fails if not formatted)
kurtosis lint ./my-package/

# Check docstrings
kurtosis lint -c ./my-package/

# Fix-and-retry pattern: auto-fix, then re-lint to verify
kurtosis lint -f ./my-package/
kurtosis lint ./my-package/
```

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.