// Lint, format, typecheck, and verify the project is clean. Use after making changes, before committing, or when the user asks to verify quality.
| name | devcheck |
| description | Lint, format, typecheck, and verify the project is clean. Use after making changes, before committing, or when the user asks to verify quality. |
| metadata | {"author":"cyanheads","version":"1.3","audience":"external","type":"workflow"} |
bun run devcheck runs a broader check suite than just lint + types. By default it includes local hygiene checks, MCP definition linting, Biome, TypeScript, and slow dependency/security checks unless --fast is passed. Tests are opt-in via --test.
| Check | Tool | Notes |
|---|---|---|
| TODOs / FIXMEs | git grep | Fails on tracked TODO/FIXME markers outside excluded files |
| Tracked secrets | git ls-files | Flags tracked .env, keys, credentials, and similar sensitive files |
| MCP definitions | bun run scripts/lint-mcp.ts | Validates tool/resource/prompt definitions against framework rules |
| Biome | biome check | Unified lint + format — read-only by default |
| TypeScript | tsc --noEmit | Full project type check |
| Unused dependencies | depcheck | Runs by default; network-free but slower on large repos |
| Security audit | bun audit | Runs by default unless --fast or --no-audit |
| Outdated dependencies | bun outdated | Runs by default unless --fast or --no-deps |
| Tests | vitest run | Off by default; enable with bun run devcheck --test |
To auto-fix lint/format issues, run bun run format.
bun run devcheckbun run devcheck until cleanbun run devcheck --test or bun run test| Check | Error Type | Typical Fix |
|---|---|---|
| TODOs / FIXMEs | Tracked work markers | Resolve or remove the marker before committing |
| Tracked secrets | Sensitive files in git | Add to .gitignore and remove from the index |
| MCP definitions | Definition lint errors | Fix schema/name/annotation issues reported by lint-mcp |
| Biome | Lint/format errors | Run bun run format to auto-fix, or address the flagged rule manually |
| TypeScript | Type errors | Fix type mismatches, missing properties, incorrect generics |
| Security audit | Vulnerabilities in direct deps | Update or replace the affected dependency |
| Outdated deps | Stale package versions | Run bun update or allowlist intentionally pinned packages |
bun run devcheck exits with no errorsbun run devcheck --test or bun run test)Catalog of OpenTelemetry instrumentation built into framework `@cyanheads/mcp-ts-core` — spans, metrics, completion logs, env config, runtime caveats, custom instrumentation patterns, and cardinality rules. Use when enabling OTel export, adding custom spans or metrics in services, debugging missing telemetry, looking up attribute names, or deciding what's safe to put on a metric attribute vs. a span.
API reference for all utilities exported from `@cyanheads/mcp-ts-core/utils`. Use when looking up utility method signatures, options, peer dependencies, or usage patterns.
File a bug or feature request against @cyanheads/mcp-ts-core when you hit a framework issue. Use when a builder, utility, context method, or config behaves contrary to the documented API — not for server-specific application bugs.
File a bug or feature request against this MCP server's own repo. Use for server-specific issues — tool logic, service integrations, config problems, or domain bugs that aren't caused by the framework.
Post-init orientation for an MCP server built on @cyanheads/mcp-ts-core. Use after running `@cyanheads/mcp-ts-core init` to understand the project structure, conventions, and skill sync model. Also use when onboarding to an existing project for the first time.