startx 1.1.1 → 1.1.3

package/apps/cli/package.json

@@ -27,12 +27,12 @@
 		"vitest-config": "workspace:*"
 	},
 	"dependencies": {
-		"@inquirer/prompts": "^8.3.0",
+		"@inquirer/prompts": "catalog:",
 		"@repo/logger": "workspace:*",
 		"@repo/mail": "workspace:*",
 		"@repo/lib": "workspace:*",
 		"@repo/env": "workspace:*",
-		"commander": "^14.0.0",
+		"commander": "catalog:",
 		"@repo/queue": "workspace:*",
 		"aix": "workspace:*"
 	},

package/apps/startx-cli/dist/index.mjs

@@ -223,4 +223,4 @@ export default extend(baseConfig);
 `),l&&await o.writeFile(t.join(a,`vitest.config.ts`),`import vitestConfig from "vitest-config/node";
 
 export default vitestConfig;
-`),Z_.info(`Created package ${r} at ${t.relative(i.workspace,a)}`),Z_.info("Run `pnpm install` to link the new package.")}static async resolveEslintPreference(e){if(e.eslint===!1)return!1;let n=Iy.getDirectory(),r=await this.readRootPackage(n.workspace);return this.hasDependency(r,`eslint`)?e.eslint??!0:e.eslint===!0||await Xx.confirm({message:`ESLint is not installed in this monorepo. Install and enable it?`,default:!0})?(r.devDependencies={...r.devDependencies,eslint:await this.resolveDependencyVersion(n.workspace,`eslint`)},await this.writeJson(t.join(n.workspace,`package.json`),r),Z_.info(`Added eslint to the root devDependencies.`),e.install!==!1&&await this.installRootDependencies(n.workspace),!0):!1}static async getInstallTags(e){let t=new Set([`common`,`node`]),n=await this.readRootPackage(e.workspace);e.eslintEnabled&&t.add(`eslint`),this.hasDependency(n,`@biomejs/biome`)&&t.add(`biome`),this.hasDependency(n,`prettier`)&&t.add(`prettier`),this.hasDependency(n,`vitest`)&&t.add(`vitest`),this.hasDependency(n,`tsdown`)&&t.add(`tsdown`);for(let n of e.packages)n.packageJson?.startx?.tags?.forEach(e=>t.add(e)),n.packageJson?.startx?.iTags?.forEach(e=>t.add(e)),n.packageJson?.startx?.gTags?.forEach(e=>t.add(e)),(n.type===`apps`||n.packageJson?.startx?.mode===`standalone`)&&t.add(`runnable`);return Array.from(t)}static resolvePackageClosure(e){let t=new Map,n=[e.selectedPackage],r=r=>{let i=this.findPackage(e.packages,r);i&&!t.has(i.name)&&n.push(i)};for(e.includeEslintConfig&&r(`eslint-config`);n.length>0;){let e=n.shift();if(!t.has(e.name)){t.set(e.name,e);for(let t of[...e.packageJson?.startx?.requiredDeps??[],...e.packageJson?.startx?.requiredDevDeps??[]])r(t)}}return Array.from(t.values())}static async ensureTemplatePackage(e){let t=this.findPackage(e.packages,e.name);if(!t){Z_.warn(`Could not find template package ${e.name}; skipping.`);return}await this.installTemplatePackage({pkg:t,directory:e.directory,tags:e.tags})}static async installTemplatePackage(e){if(!e.pkg.packageJson)throw Error(`Missing package.json for ${e.pkg.name}`);let n=e.overrideRelativePath??e.pkg.relativePath,r=t.join(e.directory.workspace,n);if(await this.pathExists(t.join(r,`package.json`))&&!await Xx.confirm({message:`"${n}" already exists. Overwrite?`,default:!1})){Z_.info(`Skipping ${e.pkg.name}.`);return}let i=new Set([...e.tags,...e.pkg.packageJson.startx?.tags??[]]),a=e.pkg.packageJson.startx?.ignore??[];a.includes(`eslint-config`)&&i.delete(`eslint`),a.includes(`vitest-config`)&&i.delete(`vitest`);let{packageJson:o,isWorkspace:s}=By.handlePackageJson({app:e.pkg.packageJson,tags:Array.from(i),name:e.overrideName??e.pkg.packageJson.name??e.pkg.name});if(s)throw Error(`Cannot install workspace as a package: ${e.pkg.name}`);await Ny.writeJSONFile({dir:r,file:`package`,content:o}),await this.copyValidatedFilesFromFolder(e.pkg.path,r,i),await Ny.copyDirectory({from:t.join(e.pkg.path,`src`),to:t.join(r,`src`),exclude:i.has(`vitest`)?void 0:/\.test\.tsx?$/}),Z_.info(`Installed ${e.overrideName??e.pkg.name} at ${n}`)}static async copyValidatedFilesFromFolder(e,n,r){let i=await Ny.listFiles({dir:e}).catch(()=>[]);for(let a of i){let i=Py[a];i&&!i.tags.every(e=>r.has(e))||a!==`package.json`&&await Ny.copyFile({from:t.join(e,a),to:t.join(n,a)})}}static createPackageJson(e){let t={typecheck:`tsc --noEmit`,clean:`rimraf dist .turbo`},n={"typescript-config":`workspace:*`},r=[];return e.eslintEnabled?(t.lint=`eslint .`,t[`lint:fix`]=`eslint . --fix`,n[`eslint-config`]=`workspace:*`):r.push(`eslint-config`),e.vitestEnabled?(t.test=`vitest run`,n[`vitest-config`]=`workspace:*`):r.push(`vitest-config`),{name:e.name,version:`1.0.0`,type:`module`,scripts:t,exports:`./src/index.ts`,devDependencies:n,startx:{iTags:[`node`],requiredDevDeps:[`typescript-config`],...r.length>0?{ignore:r}:{}}}}static async checkAndInstallMissingDeps(e){let n=await this.readRootPackage(e.workspace),r=await Iy.parsePnpmWorkspace({dir:e.workspace}),i=[];for(let[t,a]of Object.entries(Ly)){if(!a.tags.every(t=>e.tags.includes(t))||a.tags.includes(`root`)||this.hasDependency(n,t))continue;let o=r?.catalog?.[t]?`catalog:`:a.version;i.push({name:t,version:o,isDev:a.isDevDependency??!0})}if(i.length!==0){Z_.warn(`The following workspace dependencies are required but not installed:`);for(let e of i)Z_.warn(`  - ${e.name}`);if(!await Xx.confirm({message:`Add them to the workspace root package.json?`,default:!0})){Z_.warn(`Skipping. Some features may not work correctly without these dependencies.`);return}for(let e of i)e.isDev?n.devDependencies[e.name]=e.version:n.dependencies[e.name]=e.version;await this.writeJson(t.join(e.workspace,`package.json`),n),Z_.info(`Added missing dependencies to root package.json.`),e.install!==!1&&await this.installRootDependencies(e.workspace)}}static getDestinationPath(e,n){let r=t.dirname(e),i=n.includes(`/`)?n.split(`/`).pop():n;return t.join(r,i)}static getDefaultPackagePath(e){if(e.startsWith(`@`)){let[n,r]=e.split(`/`);return t.join(`packages`,n,r)}return t.join(`packages`,e)}static findPackage(e,t){return e.find(e=>e.name===t||e.packageJson?.name===t)}static hasDependency(e,t){return!!(e.dependencies?.[t]||e.devDependencies?.[t]||e.peerDependencies?.[t])}static async readRootPackage(e){let n=await o.readFile(t.join(e,`package.json`),`utf-8`);return JSON.parse(n)}static async resolveDependencyVersion(e,t){return(await Iy.parsePnpmWorkspace({dir:e}))?.catalog?.[t]?`catalog:`:t===`eslint`?`^9.0.0`:`latest`}static async installRootDependencies(e){let t=(await this.readRootPackage(e)).packageManager?.split(`@`)[0]||`pnpm`,r=t===`yarn`?`yarn`:t,i=[`install`];Z_.info(`Running ${r} ${i.join(` `)} to install ESLint...`),await new Promise((t,a)=>{let o=n(r,i,{cwd:e,stdio:`inherit`,shell:process.platform===`win32`});o.on(`error`,a),o.on(`close`,e=>{if(e===0){t();return}a(Error(`${r} ${i.join(` `)} exited with code ${e}`))})}).catch(t=>{Z_.warn(`Could not install dependencies automatically: ${t instanceof Error?t.message:t}`),Z_.warn(`Run "${r} ${i.join(` `)}" manually in ${e}.`)})}static async writeJson(e,t){await o.writeFile(e,`${JSON.stringify(t,null,2)}\n`)}static async pathExists(e){try{return await o.access(e),!0}catch{return!1}}},eS=`1.1.1`;const tS=new dv;tS.name(`startx`).description(`StartX CLI - Your all in one monorepo startup tool.`).version(eS),tS.command(`ping`).action(()=>{Z_.info(`pong`)}),tS.addCommand(Zx.command),tS.addCommand($x.command),tS.parse(process.argv);export{};
+`),Z_.info(`Created package ${r} at ${t.relative(i.workspace,a)}`),Z_.info("Run `pnpm install` to link the new package.")}static async resolveEslintPreference(e){if(e.eslint===!1)return!1;let n=Iy.getDirectory(),r=await this.readRootPackage(n.workspace);return this.hasDependency(r,`eslint`)?e.eslint??!0:e.eslint===!0||await Xx.confirm({message:`ESLint is not installed in this monorepo. Install and enable it?`,default:!0})?(r.devDependencies={...r.devDependencies,eslint:await this.resolveDependencyVersion(n.workspace,`eslint`)},await this.writeJson(t.join(n.workspace,`package.json`),r),Z_.info(`Added eslint to the root devDependencies.`),e.install!==!1&&await this.installRootDependencies(n.workspace),!0):!1}static async getInstallTags(e){let t=new Set([`common`,`node`]),n=await this.readRootPackage(e.workspace);e.eslintEnabled&&t.add(`eslint`),this.hasDependency(n,`@biomejs/biome`)&&t.add(`biome`),this.hasDependency(n,`prettier`)&&t.add(`prettier`),this.hasDependency(n,`vitest`)&&t.add(`vitest`),this.hasDependency(n,`tsdown`)&&t.add(`tsdown`);for(let n of e.packages)n.packageJson?.startx?.tags?.forEach(e=>t.add(e)),n.packageJson?.startx?.iTags?.forEach(e=>t.add(e)),n.packageJson?.startx?.gTags?.forEach(e=>t.add(e)),(n.type===`apps`||n.packageJson?.startx?.mode===`standalone`)&&t.add(`runnable`);return Array.from(t)}static resolvePackageClosure(e){let t=new Map,n=[e.selectedPackage],r=r=>{let i=this.findPackage(e.packages,r);i&&!t.has(i.name)&&n.push(i)};for(e.includeEslintConfig&&r(`eslint-config`);n.length>0;){let e=n.shift();if(!t.has(e.name)){t.set(e.name,e);for(let t of[...e.packageJson?.startx?.requiredDeps??[],...e.packageJson?.startx?.requiredDevDeps??[]])r(t)}}return Array.from(t.values())}static async ensureTemplatePackage(e){let t=this.findPackage(e.packages,e.name);if(!t){Z_.warn(`Could not find template package ${e.name}; skipping.`);return}await this.installTemplatePackage({pkg:t,directory:e.directory,tags:e.tags})}static async installTemplatePackage(e){if(!e.pkg.packageJson)throw Error(`Missing package.json for ${e.pkg.name}`);let n=e.overrideRelativePath??e.pkg.relativePath,r=t.join(e.directory.workspace,n);if(await this.pathExists(t.join(r,`package.json`))&&!await Xx.confirm({message:`"${n}" already exists. Overwrite?`,default:!1})){Z_.info(`Skipping ${e.pkg.name}.`);return}let i=new Set([...e.tags,...e.pkg.packageJson.startx?.tags??[]]),a=e.pkg.packageJson.startx?.ignore??[];a.includes(`eslint-config`)&&i.delete(`eslint`),a.includes(`vitest-config`)&&i.delete(`vitest`);let{packageJson:o,isWorkspace:s}=By.handlePackageJson({app:e.pkg.packageJson,tags:Array.from(i),name:e.overrideName??e.pkg.packageJson.name??e.pkg.name});if(s)throw Error(`Cannot install workspace as a package: ${e.pkg.name}`);await this.syncDepsWithCatalog({workspace:e.directory.workspace,templateDir:e.directory.template,packageJson:o}),await Ny.writeJSONFile({dir:r,file:`package`,content:o}),await this.copyValidatedFilesFromFolder(e.pkg.path,r,i),await Ny.copyDirectory({from:t.join(e.pkg.path,`src`),to:t.join(r,`src`),exclude:i.has(`vitest`)?void 0:/\.test\.tsx?$/}),Z_.info(`Installed ${e.overrideName??e.pkg.name} at ${n}`)}static async copyValidatedFilesFromFolder(e,n,r){let i=await Ny.listFiles({dir:e}).catch(()=>[]);for(let a of i){let i=Py[a];i&&!i.tags.every(e=>r.has(e))||a!==`package.json`&&await Ny.copyFile({from:t.join(e,a),to:t.join(n,a)})}}static createPackageJson(e){let t={typecheck:`tsc --noEmit`,clean:`rimraf dist .turbo`},n={"typescript-config":`workspace:*`},r=[];return e.eslintEnabled?(t.lint=`eslint .`,t[`lint:fix`]=`eslint . --fix`,n[`eslint-config`]=`workspace:*`):r.push(`eslint-config`),e.vitestEnabled?(t.test=`vitest run`,n[`vitest-config`]=`workspace:*`):r.push(`vitest-config`),{name:e.name,version:`1.0.0`,type:`module`,scripts:t,exports:`./src/index.ts`,devDependencies:n,startx:{iTags:[`node`],requiredDevDeps:[`typescript-config`],...r.length>0?{ignore:r}:{}}}}static async checkAndInstallMissingDeps(e){let n=await this.readRootPackage(e.workspace),r=await Iy.parsePnpmWorkspace({dir:e.workspace}),i=[],a=[];for(let[t,o]of Object.entries(Ly))if(o.tags.every(t=>e.tags.includes(t))&&!o.tags.includes(`root`))if(o.version.startsWith(`workspace:`))await this.workspacePackageExists(e.workspace,t)||a.push(t);else{if(this.hasDependency(n,t))continue;let e=r?.catalog?.[t]?`catalog:`:o.version;i.push({name:t,version:e,isDev:o.isDevDependency??!0})}if(a.length>0){Z_.warn(`The following workspace packages are missing from this monorepo:`);for(let e of a)Z_.warn(`  - ${e}  →  run: startx package add ${e}`)}if(i.length!==0){Z_.warn(`The following npm dependencies are required but not installed:`);for(let e of i)Z_.warn(`  - ${e.name}`);if(!await Xx.confirm({message:`Add them to the workspace root package.json?`,default:!0})){Z_.warn(`Skipping. Some features may not work correctly without these dependencies.`);return}for(let e of i)e.isDev?n.devDependencies[e.name]=e.version:n.dependencies[e.name]=e.version;await this.writeJson(t.join(e.workspace,`package.json`),n),Z_.info(`Added missing dependencies to root package.json.`),e.install!==!1&&await this.installRootDependencies(e.workspace)}}static async workspacePackageExists(e,n){let r=n.startsWith(`@`)?t.join(...n.split(`/`)):n,i=[t.join(e,`configs`,r,`package.json`),t.join(e,`packages`,r,`package.json`),t.join(e,`apps`,r,`package.json`)];for(let e of i)if(await this.pathExists(e))return!0;return!1}static getDestinationPath(e,n){let r=t.dirname(e),i=n.includes(`/`)?n.split(`/`).pop():n;return t.join(r,i)}static getDefaultPackagePath(e){if(e.startsWith(`@`)){let[n,r]=e.split(`/`);return t.join(`packages`,n,r)}return t.join(`packages`,e)}static findPackage(e,t){return e.find(e=>e.name===t||e.packageJson?.name===t)}static hasDependency(e,t){return!!(e.dependencies?.[t]||e.devDependencies?.[t]||e.peerDependencies?.[t])}static async readRootPackage(e){let n=await o.readFile(t.join(e,`package.json`),`utf-8`);return JSON.parse(n)}static async resolveDependencyVersion(e,t){return(await Iy.parsePnpmWorkspace({dir:e}))?.catalog?.[t]?`catalog:`:t===`eslint`?`^9.0.0`:`latest`}static async installRootDependencies(e){let t=(await this.readRootPackage(e)).packageManager?.split(`@`)[0]||`pnpm`,r=t===`yarn`?`yarn`:t,i=[`install`];Z_.info(`Running ${r} ${i.join(` `)} to install ESLint...`),await new Promise((t,a)=>{let o=n(r,i,{cwd:e,stdio:`inherit`,shell:process.platform===`win32`});o.on(`error`,a),o.on(`close`,e=>{if(e===0){t();return}a(Error(`${r} ${i.join(` `)} exited with code ${e}`))})}).catch(t=>{Z_.warn(`Could not install dependencies automatically: ${t instanceof Error?t.message:t}`),Z_.warn(`Run "${r} ${i.join(` `)}" manually in ${e}.`)})}static async syncDepsWithCatalog(e){let n=t.join(e.workspace,`pnpm-workspace.yaml`),r;try{r=await o.readFile(n,`utf-8`)}catch{return}let i=jy.parseDocument(r),a=i.getIn([`catalog`]);if(!a)return;let s=await this.loadTemplateCatalog(e.templateDir),c=e.packageJson.dependencies,l=e.packageJson.devDependencies,u={},d=e=>{if(e){for(let[t,n]of Object.entries(e))if(!n.startsWith(`workspace:`))if(n===`catalog:`){if(!a[t]){let e=s[t];e&&(u[t]=e)}}else e[t]=`catalog:`,a[t]||(u[t]=n)}};if(d(c),d(l),Object.keys(u).length!==0){for(let[e,t]of Object.entries(u))i.setIn([`catalog`,e],t);await o.writeFile(n,i.toString()),Z_.info(`Added to pnpm-workspace.yaml catalog:`);for(let[e,t]of Object.entries(u))Z_.info(`  + ${e}: ${t}`)}}static async loadTemplateCatalog(e){try{let n=await o.readFile(t.join(e,`pnpm-workspace.yaml`),`utf-8`);return jy.parseDocument(n).getIn([`catalog`])??{}}catch{return{}}}static async writeJson(e,t){await o.writeFile(e,`${JSON.stringify(t,null,2)}\n`)}static async pathExists(e){try{return await o.access(e),!0}catch{return!1}}},eS=`1.1.3`;const tS=new dv;tS.name(`startx`).description(`StartX CLI - Your all in one monorepo startup tool.`).version(eS),tS.command(`ping`).action(()=>{Z_.info(`pong`)}),tS.addCommand(Zx.command),tS.addCommand($x.command),tS.parse(process.argv);export{};

package/apps/startx-cli/package.json

@@ -20,20 +20,21 @@
 	"author": "",
 	"license": "ISC",
 	"devDependencies": {
-		"cross-env": "^10.1.0",
+		"cross-env": "catalog:",
 		"eslint-config": "workspace:*",
 		"tsdown-config": "workspace:*",
 		"typescript-config": "workspace:*",
 		"vitest-config": "workspace:*"
 	},
 	"dependencies": {
-		"@inquirer/prompts": "^8.3.0",
+		"@inquirer/prompts": "catalog:",
 		"@repo/lib": "workspace:*",
 		"@repo/logger": "workspace:*",
 		"@repo/env": "workspace:*",
-		"chokidar": "^4.0.3",
-		"commander": "^14.0.0",
-		"type-fest": "^5.4.4"
+		"chokidar": "catalog:",
+		"commander": "catalog:",
+		"type-fest": "catalog:",
+		"yaml": "catalog:"
 	},
 	"startx": {
 		"mode": "silent",

package/apps/startx-cli/src/commands/package.ts

@@ -4,6 +4,7 @@ import { spawn } from "child_process";
 import { Command } from "commander";
 import fs from "fs/promises";
 import path from "path";
+import * as YAML from "yaml";
 import z from "zod";
 
 import { DepCheck } from "../configs/deps";
@@ -261,11 +262,7 @@ export class PackageCommand {
 		return true;
 	}
 
-	private static async getInstallTags(props: {
-		workspace: string;
-		packages: PackageItem[];
-		eslintEnabled: boolean;
-	}) {
+	private static async getInstallTags(props: { workspace: string; packages: PackageItem[]; eslintEnabled: boolean }) {
 		const tags = new Set<TAGS>(["common", "node"]);
 		const rootPackage = await this.readRootPackage(props.workspace);
 
@@ -377,6 +374,12 @@ export class PackageCommand {
 			throw new Error(`Cannot install workspace as a package: ${props.pkg.name}`);
 		}
 
+		await this.syncDepsWithCatalog({
+			workspace: props.directory.workspace,
+			templateDir: props.directory.template,
+			packageJson: packageJson as Record<string, unknown>,
+		});
+
 		await fsTool.writeJSONFile({ dir: destination, file: "package", content: packageJson });
 		await this.copyValidatedFilesFromFolder(props.pkg.path, destination, tags);
 		await fsTool.copyDirectory({
@@ -442,27 +445,39 @@ export class PackageCommand {
 		};
 	}
 
-	private static async checkAndInstallMissingDeps(props: {
-		workspace: string;
-		tags: TAGS[];
-		install?: boolean;
-	}) {
+	private static async checkAndInstallMissingDeps(props: { workspace: string; tags: TAGS[]; install?: boolean }) {
 		const rootPackage = await this.readRootPackage(props.workspace);
 		const pnpmWorkspace = await CliUtils.parsePnpmWorkspace({ dir: props.workspace });
 
-		const missing: Array<{ name: string; version: string; isDev: boolean }> = [];
+		const missingNpm: Array<{ name: string; version: string; isDev: boolean }> = [];
+		const missingWorkspace: string[] = [];
+
 		for (const [dep, config] of Object.entries(DepCheck)) {
-			if (!config.tags.every(tag => props.tags.includes(tag as TAGS))) continue;
+			if (!config.tags.every(tag => props.tags.includes(tag))) continue;
 			if (config.tags.includes("root")) continue;
-			if (this.hasDependency(rootPackage, dep)) continue;
-			const version = pnpmWorkspace?.catalog?.[dep] ? "catalog:" : config.version;
-			missing.push({ name: dep, version, isDev: config.isDevDependency ?? true });
+
+			if (config.version.startsWith("workspace:")) {
+				// Workspace packages live in configs/, packages/, apps/ — not in root package.json
+				const exists = await this.workspacePackageExists(props.workspace, dep);
+				if (!exists) missingWorkspace.push(dep);
+			} else {
+				if (this.hasDependency(rootPackage, dep)) continue;
+				const version = pnpmWorkspace?.catalog?.[dep] ? "catalog:" : config.version;
+				missingNpm.push({ name: dep, version, isDev: config.isDevDependency ?? true });
+			}
 		}
 
-		if (missing.length === 0) return;
+		if (missingWorkspace.length > 0) {
+			logger.warn("The following workspace packages are missing from this monorepo:");
+			for (const name of missingWorkspace) {
+				logger.warn(`  - ${name}  →  run: startx package add ${name}`);
+			}
+		}
 
-		logger.warn(`The following workspace dependencies are required but not installed:`);
-		for (const dep of missing) {
+		if (missingNpm.length === 0) return;
+
+		logger.warn("The following npm dependencies are required but not installed:");
+		for (const dep of missingNpm) {
 			logger.warn(`  - ${dep.name}`);
 		}
 
@@ -475,7 +490,7 @@ export class PackageCommand {
 			return;
 		}
 
-		for (const dep of missing) {
+		for (const dep of missingNpm) {
 			if (dep.isDev) {
 				(rootPackage.devDependencies as Record<string, string>)[dep.name] = dep.version;
 			} else {
@@ -491,6 +506,24 @@ export class PackageCommand {
 		}
 	}
 
+	private static async workspacePackageExists(workspace: string, packageName: string): Promise<boolean> {
+		// Resolve scoped names: @repo/lib → packages/@repo/lib
+		const subPath = packageName.startsWith("@")
+			? path.join(...packageName.split("/"))
+			: packageName;
+
+		const candidates = [
+			path.join(workspace, "configs", subPath, "package.json"),
+			path.join(workspace, "packages", subPath, "package.json"),
+			path.join(workspace, "apps", subPath, "package.json"),
+		];
+
+		for (const candidate of candidates) {
+			if (await this.pathExists(candidate)) return true;
+		}
+		return false;
+	}
+
 	private static getDestinationPath(templateRelativePath: string, newName: string): string {
 		const parentDir = path.dirname(templateRelativePath);
 		const leafName = newName.includes("/") ? newName.split("/").pop()! : newName;
@@ -559,6 +592,76 @@ export class PackageCommand {
 		});
 	}
 
+	private static async syncDepsWithCatalog(props: {
+		workspace: string;
+		templateDir: string;
+		packageJson: Record<string, unknown>;
+	}): Promise<void> {
+		const workspacePath = path.join(props.workspace, "pnpm-workspace.yaml");
+		let content: string;
+		try {
+			content = await fs.readFile(workspacePath, "utf-8");
+		} catch {
+			return;
+		}
+
+		const doc = YAML.parseDocument(content);
+		const catalog = doc.getIn(["catalog"]) as Record<string, string> | undefined;
+		if (!catalog) return;
+
+		// Load template's catalog to resolve "catalog:" entries to real versions
+		const templateCatalog = await this.loadTemplateCatalog(props.templateDir);
+
+		const deps = props.packageJson.dependencies as Record<string, string> | undefined;
+		const devDeps = props.packageJson.devDependencies as Record<string, string> | undefined;
+		const newEntries: Record<string, string> = {};
+
+		const processMap = (depMap: Record<string, string> | undefined) => {
+			if (!depMap) return;
+			for (const [name, version] of Object.entries(depMap)) {
+				if (version.startsWith("workspace:")) continue;
+
+				if (version === "catalog:") {
+					// Valid only if the user's catalog already has this entry.
+					// If not, resolve the real version from the template's catalog and add it.
+					if (!catalog[name]) {
+						const templateVersion = templateCatalog[name];
+						if (templateVersion) newEntries[name] = templateVersion;
+					}
+				} else {
+					// Hardcoded version — normalize to catalog:
+					depMap[name] = "catalog:";
+					if (!catalog[name]) newEntries[name] = version;
+				}
+			}
+		};
+
+		processMap(deps);
+		processMap(devDeps);
+
+		if (Object.keys(newEntries).length === 0) return;
+
+		for (const [name, version] of Object.entries(newEntries)) {
+			doc.setIn(["catalog", name], version);
+		}
+
+		await fs.writeFile(workspacePath, doc.toString());
+		logger.info("Added to pnpm-workspace.yaml catalog:");
+		for (const [name, version] of Object.entries(newEntries)) {
+			logger.info(`  + ${name}: ${version}`);
+		}
+	}
+
+	private static async loadTemplateCatalog(templateDir: string): Promise<Record<string, string>> {
+		try {
+			const raw = await fs.readFile(path.join(templateDir, "pnpm-workspace.yaml"), "utf-8");
+			const doc = YAML.parseDocument(raw);
+			return (doc.getIn(["catalog"]) as Record<string, string>) ?? {};
+		} catch {
+			return {};
+		}
+	}
+
 	private static async writeJson(file: string, content: object) {
 		await fs.writeFile(file, `${JSON.stringify(content, null, 2)}\n`);
 	}

package/apps/web-client/package.json

@@ -23,7 +23,7 @@
 		"react": "catalog:",
 		"react-dom": "catalog:",
 		"react-router": "catalog:",
-		"zustand": "^5.0.13",
+		"zustand": "catalog:",
 		"@repo/common": "workspace:*"
 	},
 	"devDependencies": {

package/configs/eslint-config/package.json

@@ -20,29 +20,29 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@eslint/compat": "^2.0.2",
-		"@eslint/js": "^9.0.0",
-		"@stylistic/eslint-plugin": "^2.0.0",
-		"eslint-config-prettier": "^9.1.0",
-		"eslint-import-resolver-typescript": "^3.6.1",
-		"eslint-plugin-import-x": "^4.0.0",
-		"eslint-plugin-jsx-a11y": "^6.9.0",
-		"eslint-plugin-lodash": "^8.0.0",
-		"eslint-plugin-react": "^7.35.0",
-		"eslint-plugin-react-hooks": "^5.0.0",
-		"eslint-plugin-unicorn": "^55.0.0",
-		"eslint-plugin-unused-imports": "^4.0.0",
-		"globals": "^15.9.0"
+		"@eslint/compat": "catalog:",
+		"@eslint/js": "catalog:",
+		"@stylistic/eslint-plugin": "catalog:",
+		"eslint-config-prettier": "catalog:",
+		"eslint-import-resolver-typescript": "catalog:",
+		"eslint-plugin-import-x": "catalog:",
+		"eslint-plugin-jsx-a11y": "catalog:",
+		"eslint-plugin-lodash": "catalog:",
+		"eslint-plugin-react": "catalog:",
+		"eslint-plugin-react-hooks": "catalog:",
+		"eslint-plugin-unicorn": "catalog:",
+		"eslint-plugin-unused-imports": "catalog:",
+		"globals": "catalog:"
 	},
 	"devDependencies": {
-		"typescript-eslint": "^8.54.0",
-		"@types/eslint-config-prettier": "^6.11.3",
-		"@types/eslint-plugin-jsx-a11y": "^6.10.1",
-		"@typescript-eslint/eslint-plugin": "^8.0.0",
-		"@typescript-eslint/rule-tester": "^8.54.0",
-		"@typescript-eslint/utils": "^8.0.0",
+		"@types/eslint-config-prettier": "catalog:",
+		"@types/eslint-plugin-jsx-a11y": "catalog:",
+		"@typescript-eslint/eslint-plugin": "catalog:",
+		"@typescript-eslint/rule-tester": "catalog:",
+		"@typescript-eslint/utils": "catalog:",
 		"eslint": "catalog:",
 		"typescript-config": "workspace:*",
+		"typescript-eslint": "catalog:",
 		"vitest-config": "workspace:*"
 	},
 	"startx": {

package/configs/vitest-config/package.json

@@ -3,7 +3,7 @@
 	"version": "1.5.0",
 	"type": "module",
 	"devDependencies": {
-		"jsdom": "^29.0.1",
+		"jsdom": "catalog:",
 		"typescript-config": "workspace:*",
 		"vite": "catalog:",
 		"vitest": "catalog:"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "startx",
   "description": "",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/avinashid/startx.git"

package/packages/@repo/lib/package.json

@@ -18,8 +18,8 @@
 		"./*": "./src/*/index.ts"
 	},
 	"devDependencies": {
-		"@types/jsonwebtoken": "^9.0.7",
-		"@types/nodemailer": "^6.4.16",
+		"@types/jsonwebtoken": "catalog:",
+		"@types/nodemailer": "catalog:",
 		"eslint-config": "workspace:*",
 		"typescript-config": "workspace:*",
 		"vine": "link:@types/vinejs/vine",
@@ -38,7 +38,7 @@
 		"firebase-admin": "catalog:",
 		"jsonwebtoken": "catalog:",
 		"nodemailer": "catalog:",
-		"yaml": "^2.8.2"
+		"yaml": "catalog:"
 	},
 	"startx": {
 		"iTags": [

package/packages/@repo/lib/src/file-system-module/index.ts

@@ -1,6 +1,6 @@
 import fs from "fs/promises";
 import path from "path";
-import YAML from "yaml";
+import * as YAML from "yaml";
 
 import { __dirname } from "../utils.js";
 

package/packages/aix/package.json

@@ -21,14 +21,14 @@
 		"vitest-config": "workspace:*"
 	},
 	"dependencies": {
-		"@aws-sdk/client-bedrock": "^3.1047.0",
-		"@aws-sdk/client-bedrock-runtime": "^3.1047.0",
+		"@aws-sdk/client-bedrock": "catalog:",
+		"@aws-sdk/client-bedrock-runtime": "catalog:",
 		"@repo/env": "workspace:*",
 		"@repo/lib": "workspace:*",
 		"@repo/logger": "workspace:*",
-		"@toon-format/toon": "^2.1.0",
+		"@toon-format/toon": "catalog:",
 		"js-tiktoken": "catalog:",
-		"jsonrepair": "^3.14.0",
+		"jsonrepair": "catalog:",
 		"openai": "catalog:",
 		"pg": "catalog:",
 		"quickjs-emscripten": "catalog:",

package/packages/ui/package.json

@@ -19,34 +19,34 @@
 		"@tailwindcss/vite": "catalog:",
 		"@types/react": "catalog:",
 		"@types/react-dom": "catalog:",
-		"autoprefixer": "^10",
+		"autoprefixer": "catalog:",
 		"eslint-config": "workspace:*",
 		"tailwindcss": "catalog:",
 		"typescript-config": "workspace:*",
 		"vitest-config": "workspace:*"
 	},
 	"dependencies": {
-		"@fontsource-variable/eb-garamond": "^5.2.7",
-		"@fontsource-variable/inter": "^5.2.8",
-		"@hookform/resolvers": "^3.9.1",
-		"@phosphor-icons/react": "^2.1.10",
-		"@tailwindcss/postcss": "^4",
-		"@tailwindcss/typography": "^0.5.19",
+		"@fontsource-variable/eb-garamond": "catalog:",
+		"@fontsource-variable/inter": "catalog:",
+		"@hookform/resolvers": "catalog:",
+		"@phosphor-icons/react": "catalog:",
+		"@tailwindcss/postcss": "catalog:",
+		"@tailwindcss/typography": "catalog:",
 		"@tanstack/react-query": "catalog:",
 		"@tanstack/react-query-devtools": "catalog:",
-		"class-variance-authority": "^0.7.1",
-		"clsx": "^2.1.1",
-		"cmdk": "^1.1.1",
-		"embla-carousel-react": "^8.6.0",
-		"input-otp": "^1.4.2",
+		"class-variance-authority": "catalog:",
+		"clsx": "catalog:",
+		"cmdk": "catalog:",
+		"embla-carousel-react": "catalog:",
+		"input-otp": "catalog:",
 		"lucide-react": "catalog:",
-		"next-themes": "^0.4.6",
-		"radix-ui": "^1.4.3",
-		"react-hook-form": "^7.75.0",
-		"react-icons": "^5.5.0",
-		"sonner": "^2.0.7",
-		"tailwind-merge": "^2.3.0",
-		"tw-animate-css": "^1.4.0"
+		"next-themes": "catalog:",
+		"radix-ui": "catalog:",
+		"react-hook-form": "catalog:",
+		"react-icons": "catalog:",
+		"sonner": "catalog:",
+		"tailwind-merge": "catalog:",
+		"tw-animate-css": "catalog:"
 	},
 	"exports": {
 		"./globals.css": "./src/styles/globals.css",

package/pnpm-workspace.yaml

@@ -14,6 +14,28 @@ catalog:
   rimraf: "^6.1.2"
   turbo: "^2.9.14"
   tsx: "^4.21.0"
+  cross-env: "^10.1.0"
+
+  # eslint plugins
+  "@eslint/compat": "^2.0.2"
+  "@eslint/js": "^9.0.0"
+  "@stylistic/eslint-plugin": "^2.0.0"
+  "@typescript-eslint/eslint-plugin": "^8.0.0"
+  "@typescript-eslint/rule-tester": "^8.54.0"
+  "@typescript-eslint/utils": "^8.0.0"
+  "@types/eslint-config-prettier": "^6.11.3"
+  "@types/eslint-plugin-jsx-a11y": "^6.10.1"
+  eslint-config-prettier: "^9.1.0"
+  eslint-import-resolver-typescript: "^3.6.1"
+  eslint-plugin-import-x: "^4.0.0"
+  eslint-plugin-jsx-a11y: "^6.9.0"
+  eslint-plugin-lodash: "^8.0.0"
+  eslint-plugin-react: "^7.35.0"
+  eslint-plugin-react-hooks: "^5.0.0"
+  eslint-plugin-unicorn: "^55.0.0"
+  eslint-plugin-unused-imports: "^4.0.0"
+  globals: "^15.9.0"
+  typescript-eslint: "^8.54.0"
 
   # utils
   "@biomejs/biome": "^2.3.13"
@@ -24,12 +46,22 @@ catalog:
   date-fns: "^4.1.0"
   nanoid: "^5.1.6"
   xlsx: "^0.18.5"
+
+  # cli
+  "@inquirer/prompts": "^8.3.0"
+  commander: "^14.0.0"
+  chokidar: "^4.0.3"
+  type-fest: "^5.4.4"
+
   # testing
   vitest: "^4.0.18"
   "@vitest/coverage-v8": "^4.0.18"
+  jsdom: "^29.0.1"
 
   # types
   "@types/node": "^25.1.0"
+  "@types/jsonwebtoken": "^9.0.7"
+  "@types/nodemailer": "^6.4.16"
 
   # frontend
   isbot: "^5.1.36"
@@ -42,6 +74,7 @@ catalog:
   lucide-react: "^0.563.0"
   tailwindcss: "^4.2.2"
   "@tailwindcss/vite": "^4.2.2"
+  zustand: "^5.0.13"
 
   # email
   react-email: "^5.2.11"
@@ -53,6 +86,25 @@ catalog:
   # ui
   "@tanstack/react-query": "^5.100.9"
   "@tanstack/react-query-devtools": "^5.100.9"
+  "@fontsource-variable/eb-garamond": "^5.2.7"
+  "@fontsource-variable/inter": "^5.2.8"
+  "@hookform/resolvers": "^3.9.1"
+  "@phosphor-icons/react": "^2.1.10"
+  "@tailwindcss/postcss": "^4"
+  "@tailwindcss/typography": "^0.5.19"
+  autoprefixer: "^10"
+  class-variance-authority: "^0.7.1"
+  clsx: "^2.1.1"
+  cmdk: "^1.1.1"
+  embla-carousel-react: "^8.6.0"
+  input-otp: "^1.4.2"
+  next-themes: "^0.4.6"
+  radix-ui: "^1.4.3"
+  react-hook-form: "^7.75.0"
+  react-icons: "^5.5.0"
+  sonner: "^2.0.7"
+  tailwind-merge: "^2.3.0"
+  tw-animate-css: "^1.4.0"
 
   # frontend types
   "@types/react": "^19.2.4"
@@ -93,12 +145,17 @@ catalog:
   winston: "^3.19.0"
   winston-daily-rotate-file: "^5.0.0"
   jsonwebtoken: "^9.0.3"
+  yaml: "^2.8.2"
 
   # aix
   js-tiktoken: "^1.0.21"
   quickjs-emscripten: "^0.32.0"
   quicktype-core: "^23.2.6"
   openai: "^6.34.0"
+  "@aws-sdk/client-bedrock": "^3.1047.0"
+  "@aws-sdk/client-bedrock-runtime": "^3.1047.0"
+  "@toon-format/toon": "^2.1.0"
+  jsonrepair: "^3.14.0"
 
   # bullmq
   bullmq: "^5.76.4"