Fission-AI/OpenSpec · error · StoreError

store_not_found

store_not_found

Error message

Unknown store '${selectedId}'.

What it means

Thrown by doctorStores when 'openspec store doctor' is invoked with an explicit store id but no store registry exists at all (readStoreRegistryState returned null), so the requested id cannot be found. The input at fault is the supplied store id; without a registry there are simply no stores to diagnose.

Solutions

1. Run 'openspec store list' to confirm whether any stores are registered
2. Register the store with 'openspec store add <path>' before running doctor on it
3. Run 'openspec store doctor' without an id to diagnose all registered stores

When it happens

Trigger: Thrown at src/core/store/operations.ts:1200 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Fission-AI/OpenSpec@6926ccb18a (2026-08-25). Data as JSON: /api/errors/987f24d961e20b25. Report an issue: GitHub.

Appendix: source

Thrown at src/core/store/operations.ts:1200

  return {
    id: entry.id,
    root,
    metadataPath,
    openspecRoot,
    metadata,
    git,
    diagnostics,
  };
}

export async function doctorStores(id?: string): Promise<StoreDoctorResult> {
  const selectedId = id !== undefined ? validateStoreId(id) : undefined;
  const registry = await readStoreRegistryState();

  if (!registry) {
    if (selectedId !== undefined) {
      throw new StoreError(`Unknown store '${selectedId}'.`, 'store_not_found', {
        target: 'store.id',
        fix: 'Run openspec store list to see registered stores.',
      });
    }

    return { stores: [], diagnostics: [] };
  }

  const entries = listStoreRegistryEntries(registry);
  const selected = selectedId
    ? entries.filter((entry) => entry.id === selectedId)
    : entries;

  if (selectedId && selected.length === 0) {
    throw new StoreError(`Unknown store '${selectedId}'.`, 'store_not_found', {
      target: 'store.id',
      fix: 'Run openspec store list to see registered stores.',
    });

View on GitHub (pinned to 6926ccb18a)