Fission-AI/OpenSpec · error · StoreError

store_setup_path_required

store_setup_path_required

Error message

Pass --path with the folder where this store should live.

What it means

Error "Pass --path with the folder where this store should live." thrown in Fission-AI/OpenSpec.

Source

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

      fix: 'Choose a path outside that Git repository.',
    }
  );
}

export function expandUserPath(inputPath: string): string {
  const trimmed = inputPath.trim();
  if (trimmed === '~') return os.homedir();
  if (trimmed.startsWith('~/') || trimmed.startsWith('~\\')) {
    return path.join(os.homedir(), trimmed.slice(2));
  }

  return trimmed;
}

function resolveSetupRoot(id: string, inputPath: string | undefined): string {
  // A store is a repo the user places; setup never silently picks app data.
  if (inputPath === undefined || inputPath.trim().length === 0) {
    throw new StoreError(
      'Pass --path with the folder where this store should live.',
      'store_setup_path_required',
      {
        target: 'store.root',
        fix: `openspec store setup ${id} --path ~/openspec/${id}`,
      }
    );
  }

  return path.resolve(expandUserPath(inputPath));
}

function resolveRegisterRoot(inputPath: string | undefined): string {
  if (inputPath === undefined || inputPath.trim().length === 0) {
    throw new StoreError('Pass a store path.', 'store_path_required', {
      target: 'store.root',
      fix: 'openspec store register /path/to/store',
    });

View on GitHub (pinned to 6926ccb18a)

When it happens

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