Method open

src/commands/workset.ts:336–505

(name: string, options: WorksetOpenOptions = {})

  }

  async open(name: string, options: WorksetOpenOptions = {}): Promise<void> {
    let prepared: PreparedOpen | undefined;

    try {
      if (options.json) {
        throw new StoreError(
          'workset open hands this terminal to the chosen tool and has no JSON mode.',
          'workset_open_json_unsupported',
          {
            target: 'workset.tool',
            fix: 'Inspect worksets with: openspec workset list --json',
          }
        );
      }

      // Regenerate the derived file FIRST (under the lock), so every
      // cannot-drive failure below can name an existing, current file.
      prepared = await withWorksetsLock(async (state): Promise<PreparedOpen> => {
        const workset = getWorkset(state, name);
        if (workset === null) {
          throw worksetNotFoundError(name, state);
        }

        const checks = await Promise.all(
          workset.members.map(async (member) => ({
            member,
            exists: await pathIsDirectory(member.path),
          }))
        );
        const surviving = checks
          .filter((check) => check.exists)
          .map((check) => check.member);
        const skipped = checks
          .filter((check) => !check.exists)
          .map((check) => check.member);

        if (surviving.length === 0) {
          throw new StoreError(
            `No member folder of workset '${name}' exists on this machine.`,
            'workset_no_members_available',
            {
              target: 'workset.member',
              fix: `Recompose it: openspec workset remove ${name} --yes && openspec workset create ${name} --member <path>`,
            }
          );
        }

        const codeWorkspacePath = getWorksetCodeWorkspacePath(name);
        await writeFileAtomically(
          codeWorkspacePath,
          buildWorksetCodeWorkspaceJson(surviving)
        );

        return { workset, surviving, skipped, codeWorkspacePath };
      });

      for (const member of prepared.skipped) {
        console.error(