[OPIK-5696][TS SDK] Align TS wizard to also save project_name to ~/.opik.config

[yaricom]

Details

Context

The TS wizard (npx opik-configure) already asks for project name — good. But it should also save it to ~/.opik.config (in addition to .env) so that both SDKs share the same configuration. This way a user who configures via one SDK doesn't have to reconfigure for the other.

Changes needed

• node-wizard.ts: After saving to .env, also write project_name to ~/.opik.config
• Consider reading project_name from ~/.opik.config in loadFromConfigFile() (already supported in Config.ts)

Acceptance Criteria

• New user → npx opik-configure → creates Opik client → trace — Trace lands in the project name entered during configure (not Default Project)
• User has project_name in ~/.opik.config → trace — Trace lands in the correct project, no warning
• OPIK_CONFIG_PATH points to nonexistent file — SDK warns and continues (does not crash)

---

Summary

The TypeScript npx opik-configure wizard now saves configuration (including project_name) to ~/.opik.config in addition to the project's .env file, so both the Python and TypeScript SDKs share the same persistent configuration. Unit testing infrastructure was also added to the configure tool package.

Changes by Component

TypeScript SDK

• node-wizard.ts: After writing env vars to .env/.env.local, calls the new saveToOpikConfigStep to persist url_override, project_name, and (for cloud/self-hosted) api_key and workspace to ~/.opik.config.
• save-to-opik-config.ts (new): Implements saveToOpikConfigStep which reads, merges, and writes ~/.opik.config using the ini package (same as the main SDK's Config.ts). Respects OPIK_CONFIG_PATH env var with tilde expansion, creates missing parent directories, and falls back to the default path with a warning if directory creation fails.
• steps/index.ts: Re-exports the new step.
• package.json: Added ini ^5.0.0 (runtime dependency) and vitest ^3.0.5 (dev dependency); added test and test:watch scripts.
• tsconfig.json: Added tests directory to the TypeScript include list.
• vitest.config.ts (new): Minimal Vitest configuration for the configure tool package.
• tests/steps/save-to-opik-config.test.ts (new): 8 unit tests covering: new file creation, cloud vs local credential inclusion, merge with existing config, preservation of other INI sections, custom OPIK_CONFIG_PATH (existing parent dir), parent directory auto-creation, fallback on directory creation failure, and writeFile error handling. Uses module-level vi.mock('fs') for ESM compatibility and isolates OPIK_CONFIG_PATH via beforeEach/afterEach.

Infrastructure

• typescript_sdk_unit_tests.yml: Added two CI steps to install dependencies and run tests for the configure tool package (separate from the main SDK test run).

Files Changed

 .github/workflows/typescript_sdk_unit_tests.yml    |   8 +
 sdks/typescript/src/opik/configure/package.json    |   8 +-
 .../src/opik/configure/src/nodejs/node-wizard.ts   |  11 ++
 .../src/opik/configure/src/steps/index.ts          |   1 +
 .../configure/src/steps/save-to-opik-config.ts     |  82 ++++++++++
 .../tests/steps/save-to-opik-config.test.ts        | 172 +++++++++++++++++++++
 sdks/typescript/src/opik/configure/tsconfig.json   |   2 +-
 .../typescript/src/opik/configure/vitest.config.ts |   9 ++
 8 files changed, 290 insertions(+), 3 deletions(-)

Change checklist

• User facing
• Documentation update

Issues

• Resolves #
• OPIK-5696

AI-WATERMARK

AI-WATERMARK: yes

• If yes:
  • Tools: Claude Code v2.1.87
  • Model(s): Sonnet 4.6
  • Scope: Code and tests
  • Human verification: Done

Testing

Introduced new unit test

Documentation

Nothing added

[awkoy]

Great job!