swarmvault next

swarmvault next is the read-only orientation command. Run it when you are not sure whether the current folder needs initialization, source ingest, compile, graph refresh, review work, or query work.

Usage

swarmvault next
swarmvault next --json

What It Reports

The command detects three states:

Status	Meaning	Typical recommendation
`uninitialized`	No SwarmVault config or schema in this folder	`swarmvault quickstart ./your-repo`, `swarmvault demo`, or `swarmvault init`
`initialized`	Config and schema exist, but no graph has been compiled	`swarmvault ingest ./your-source` and `swarmvault compile`
`compiled`	A graph artifact exists	Query, serve, review, doctor, or refresh commands based on graph status and vault checks

Human output prints the important paths first: config, schema, raw/, wiki/, state/graph.json, and the graph report. JSON output includes:

{
  "status": "compiled",
  "paths": {},
  "checks": [],
  "recommendations": []
}

Guarantees

It does not initialize, ingest, compile, repair, or write files.
It does not emit update or provider notices.
It is safe to run before choosing a workflow.
It can be used in automation with --json.

Use `quickstart` when you want the one-command beginner path, and `doctor` when you want the full health report.