@vsuite/workflows

Headless, IO-light decision logic shared by the CLI and the desktop UI: wizard options and config building, stack changes, graph rendering, packs, MCP settings, AI-assisted recommendations, and project read/write/generate workflows.

This is a private, source-only workspace package (exports → ./src/index.ts), bundled into the @krizic/vsuite CLI and the UI main process.

Public API

Module	Exports	Purpose
`wizard-model`	`wizardOptions`, `wizardMessages`, `buildConfig`, `checkServerAvailability`, prompt helpers (`modelPrompt`, `envPrompt`, `companionPrompt`), `envVariableName`, `validateEnvVariable`, `splitCapabilityAnswer`, `describeAddedDependencies`	Wizard step options and building a `vsuite.json` from answers, without any prompt library.
`initial-agents`	`buildInitialAgents`	Default agent selection for a new project.
`stack`	`applyStackResolution`, `emptyStackResolution`, `describeStackAdditions`, `optInCandidates`, `withoutUnavailableServers`, `defaultEnvVariable`, `isOnPath`	Applies `resolveStack` ownership changes to a config.
`set-stack`	`setStack`	The `vsuite stack set` workflow.
`graph`	`renderGraph`, `renderGraphJson`, `renderGraphMermaid`, `renderGraphFile`, `graphFormats`, `mermaidId`, `writeTextAtomically`	Dependency graph rendering in text, JSON, and Mermaid.
`project`	`inspectProject`, `createProject`, `detectDefaults`, `validateConfig`, `applyEdit`, `saveConfig`, `saveRawConfig`	Read, validate, edit, and write a project’s `vsuite.json`.
`migrate`	`previewMigration`, `describeMigration`, `applyMigration`	Preview and apply config schema migrations.
`generate`	`generateProject`, `formatWarning`	Run generation and report per-output status.
`packs`	`addPack`, `removePack`, `updatePacks`, `listPacks`, `packContributions`, `useSource`, `validatePackDir`, `previewRender`, `outputPath`, `PackOperationError`	The `vsuite pack`, `agent use`, and `skill use` workflows, and the preview render.
`mcp-settings`	`readMcpSettings`, `saveMcpSettings`	Read and save MCP server settings, with secrets in `.vsuite/.env`.
`recommendation`, `recommendation-candidates`	`buildRecommendationRequest`, `applyRecommendationResponse`, `loadRecommendationCandidates`, `estimateTokens`, limits	Build the local-model request for AI-assisted setup and apply its suggestions.

Dependencies

Workspace: @vsuite/catalog, @vsuite/config, @vsuite/core, @vsuite/detection, @vsuite/packs, @vsuite/templates.
Third-party: diff.
Used by: @krizic/vsuite, the UI main process.

Testing

pnpm vitest run --project @vsuite/workflows