Fission-AI/OpenSpec · error · StoreError

store_path_missing

store_path_missing

Error message

Store path does not exist: ${storeRoot}

What it means

StoreError raised by registerExistingStore when resolveRegisterRoot's pathKind reports the store path is missing. Registration validates the store exists before recording it; the structured error (code store_path_missing) targets store.root and suggests cloning or creating the store first.

Solutions

  1. Clone or create the store folder first, then register it
  2. Check the path spelling and expand ~ manually if needed
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at src/core/store/operations.ts:744 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/df5709ee54389b71. Report an issue: GitHub.

Appendix: source

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

  }
}

export async function setupStore(
  input: SetupStoreInput
): Promise<StoreMutationResult> {
  return setupPreparedStore(await prepareStoreSetup(input), {
    initGit: input.initGit,
  });
}

export async function registerExistingStore(
  input: RegisterExistingStoreInput
): Promise<StoreMutationResult> {
  const storeRoot = resolveRegisterRoot(input.path);
  const kind = await pathKind(storeRoot);

  if (kind === 'missing') {
    throw new StoreError(
      `Store path does not exist: ${storeRoot}`,
      'store_path_missing',
      {
        target: 'store.root',
        fix: 'Clone or create the store folder before registering it.',
      }
    );
  }

  if (kind !== 'directory') {
    throw new StoreError(
      `Store path is not a directory: ${storeRoot}`,
      'store_path_not_directory',
      {
        target: 'store.root',
        fix: 'Pass an existing store directory.',
      }
    );

View on GitHub (pinned to 6926ccb18a)