Function resolveStoreRoot

src/core/root-selection.ts:136–215

(
  id: string,
  globalDataDir?: string,
  source: OpenSpecRootSource = 'store'
)

}

async function resolveStoreRoot(
  id: string,
  globalDataDir?: string,
  source: OpenSpecRootSource = 'store'
): Promise<ResolvedOpenSpecRoot> {
  try {
    validateStoreId(id);
  } catch (error) {
    fromStoreError(error);
  }

  let registry;
  try {
    registry = await readStoreRegistryState(globalDataDir ? { globalDataDir } : {});
  } catch (error) {
    fromStoreError(error);
  }
  const entries = registry ? listStoreRegistryEntries(registry) : [];
  const entry = entries.find((candidate) => candidate.id === id);

  if (!entry) {
    if (entries.length === 0) {
      throw new RootSelectionError(
        `Unknown store '${id}'. No stores are registered.`,
        'no_registered_stores',
        {
          target: 'store.id',
          fix: `Run openspec store setup ${id} or openspec store register <path> first.`,
        }
      );
    }

    throw new RootSelectionError(
      `Unknown store '${id}'. Registered stores: ${entries
        .map((candidate) => candidate.id)
        .join(', ')}.`,
      'unknown_store',
      {
        target: 'store.id',
        fix: 'Pass a registered store id, or run openspec store list.',
      }
    );
  }

  const storeRoot = getStoreRootForBackend(entry.backend);
  const inspection = await inspectRegisteredStore(id, storeRoot);

  switch (inspection.kind) {
    case 'metadata_error':
      return fromStoreError(inspection.error);
    case 'metadata_missing':
      // The doctor pointer lives in the message because human-mode command
      // wrappers print only the message, not the fix field.
      throw new RootSelectionError(
        `Store '${id}' is missing identity metadata at ${inspection.metadataPath}. ${doctorFix(id)}`,
        'store_identity_mismatch',
        { target: 'store.metadata', fix: doctorFix(id) }
      );