swarmvault lint

Run anti-drift checks and wiki health validation.

Usage

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

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.

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.

Web search is currently scoped to deep lint. Compile, query, and explore continue to use local vault state plus the normal configured LLM providers instead of calling the webSearch adapter.

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.