forgeplan discover list

forgeplan discover list prints every discovery session stored in the workspace — active and completed — with ID, status, creation time, and a short coverage summary. It’s the index view across sessions.

When to use

To pick up a stalled session — find the ID to pass to discover show or discover complete.
To audit discovery history — see how many onboarding / refresh passes the project has had.
Before starting a new session — avoid duplicating an active one.
In CI or scripting — enumerate sessions for automation.

When NOT to use

To inspect a single session’s findings — use discover show.
To start a new session — use discover start.

Usage

forgeplan discover list [OPTIONS]

Options

  -h, --help     Print help
  -V, --version  Print version

Examples

# All sessions
forgeplan discover list

# Typical "where was I" recovery flow
forgeplan discover list
forgeplan discover show disc-002
forgeplan discover complete disc-002

What you see

A table (or list) with one row per session, typically showing:

Session ID (disc-NNN)
Status — active / completed
Created at — ISO timestamp
Findings count — how many discover_finding calls hit this session
Coverage — short tier summary (which of code/git/tests/docs were touched)

How it fits

discover list is the enumeration primitive for the discovery subsystem. Everything else (show, complete) operates on a specific session ID that you typically pick from this listing.

discover list → pick an ID → discover show / complete