Skip to content

swarmvault lint

Run anti-drift checks and wiki health validation.

Usage

swarmvault lint [--deep] [--no-deep] [--web] [--conflicts] [--decay] [--tiers]

Options

  • --deep — Run an LLM-powered advisory lint pass in addition to structural lint
  • --no-deep — Skip the advisory deep-lint pass even when profile.deepLintDefault enables it in config
  • --web — Augment deep-lint findings with configured web-search evidence. Requires deep lint, either from --deep or profile.deepLintDefault
  • --conflicts — Filter to contradiction findings only. Surfaces deterministic cross-source contradictions without requiring --deep. Combine with --deep to include LLM-detected contradictions.
  • --decay — Filter to decay-related findings only
  • --tiers — Filter to consolidation-tier findings only (see consolidate)

Structural Checks

  • Missing graph output — warns if you have not compiled yet
  • Stale pages — page source hashes no longer match current manifests
  • Orphaned pages — non-index pages with no backlinks
  • Uncited claim bullets — claim sections that contain bullets without [source:...]

Deep Lint

Set profile.deepLintDefault: true in swarmvault.config.json when swarmvault lint should include the advisory pass by default, and use --no-deep for a structural-only run.

swarmvault lint --deep can add advisory findings such as:

  • coverage_gap
  • contradiction_candidate
  • contradiction
  • missing_citation
  • candidate_page
  • follow_up_question

This pass does not mutate the vault. It suggests where the vault is thin, contradictory, or missing structure.

Web-Augmented Deep Lint

swarmvault lint --deep --web runs the local deep-lint pass first, then attaches external evidence snippets and URLs using the configured webSearch adapter. The same applies when deep lint is active through profile.deepLintDefault.

Compile never calls the webSearch adapter. Query, chat, and explore call it only when you pass --gap-fill and the matching webSearch.tasks entry is configured; see Web Search.

If you request --web without configuring webSearch.tasks.deepLintProvider, SwarmVault fails clearly instead of silently skipping web evidence.

Output

Reports findings with severity levels:

[warning] stale_page: Page Transformer Scaling Laws is stale because source paper-1 changed. (/path/to/wiki/concepts/transformer-scaling-laws.md)
[info] orphan_page: Page Research Notes has no backlinks. (/path/to/wiki/outputs/research-notes.md)

If no issues are found:

No findings.