Skip to main content

Interface: SpecListEntry

Defined in: packages/core/src/application/use-cases/list-specs.ts:15

A spec entry returned by ListSpecs, with resolved title and optional summary.

Properties​

metadataStatus?​

readonly optional metadataStatus?: SpecMetadataStatus

Defined in: packages/core/src/application/use-cases/list-specs.ts:39

Metadata freshness status, present only when includeMetadataStatus was requested.

  • fresh: metadata exists, is structurally valid, and all content hashes match current files
  • stale: metadata exists and is valid but hashes are missing or don't match
  • invalid: metadata file exists but fails structural validation
  • missing: no metadata.json file

path​

readonly path: string

Defined in: packages/core/src/application/use-cases/list-specs.ts:19

The spec's capability path within the workspace (e.g. auth/login).

summary?​

readonly optional summary?: string

Defined in: packages/core/src/application/use-cases/list-specs.ts:31

Short summary, present only when includeSummary was requested and a summary could be resolved. Sources in priority order:

  1. description field from metadata.json
  2. Extracted from spec.md via extractSpecSummary

title​

readonly title: string

Defined in: packages/core/src/application/use-cases/list-specs.ts:24

Human-readable title: the title field from metadata.json when present and non-empty, otherwise the last segment of the capability path.

workspace​

readonly workspace: string

Defined in: packages/core/src/application/use-cases/list-specs.ts:17

The workspace this spec belongs to.