@testspectra/cli 1.0.70 → 1.1.0-rc.1

package/dist/commands/init.js

@@ -1,27 +1,28 @@
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import * as p from "@clack/prompts";
-import chalk from "chalk";
-import { ConfigLoader } from "../config/loader.js";
-import { TypeGenerator } from "../types/generator.js";
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { ConfigLoader } from '../config/loader.js';
+import { TypeGenerator } from '../types/generator.js';
+import { TsConfigGenerator } from '../generator/tsconfig-generator.js';
 function parsePnpmWorkspaceGlobs(content) {
-    const lines = content.split("\n");
+    const lines = content.split('\n');
     const globs = [];
     let inPackages = false;
     for (const line of lines) {
         const trimmed = line.trim();
-        if (trimmed.startsWith("packages:")) {
+        if (trimmed.startsWith('packages:')) {
             inPackages = true;
             continue;
         }
         if (inPackages) {
-            if (trimmed.startsWith("-")) {
-                const item = trimmed.replace(/^-\s*['"]?/, "").replace(/['"]?\s*$/, "");
+            if (trimmed.startsWith('-')) {
+                const item = trimmed.replace(/^-\s*['"]?/, '').replace(/['"]?\s*$/, '');
                 if (item)
                     globs.push(item);
             }
-            else if (trimmed && !trimmed.startsWith("#")) {
+            else if (trimmed && !trimmed.startsWith('#')) {
                 break;
             }
         }
@@ -29,27 +30,28 @@ function parsePnpmWorkspaceGlobs(content) {
     return globs;
 }
 function ensurePnpmWorkspaceIncludes(pnpmWorkspacePath, targetPath) {
-    const normalizedTarget = targetPath.replace(/\\/g, "/");
+    const normalizedTarget = targetPath.replace(/\\/g, '/');
     if (!fs.existsSync(pnpmWorkspacePath)) {
         const newContent = `packages:\n  - '${normalizedTarget}'\n`;
-        fs.writeFileSync(pnpmWorkspacePath, newContent, "utf-8");
+        fs.writeFileSync(pnpmWorkspacePath, newContent, 'utf-8');
         return;
     }
-    const content = fs.readFileSync(pnpmWorkspacePath, "utf-8");
+    const content = fs.readFileSync(pnpmWorkspacePath, 'utf-8');
     const currentGlobs = parsePnpmWorkspaceGlobs(content);
     // Check if target is already covered by an existing glob or exact path
     const isAlreadyCovered = currentGlobs.some((glob) => {
-        const normGlob = glob.replace(/\\/g, "/");
+        const normGlob = glob.replace(/\\/g, '/');
         if (normGlob === normalizedTarget)
             return true;
         if (normGlob === `${normalizedTarget}/*` || normGlob === `${normalizedTarget}/**`)
             return true;
-        if (normGlob.endsWith("/*")) {
+        if (normGlob.endsWith('/*')) {
             const parent = normGlob.slice(0, -2);
-            if (normalizedTarget.startsWith(`${parent}/`) && normalizedTarget.split("/").length === parent.split("/").length + 1)
+            if (normalizedTarget.startsWith(`${parent}/`) &&
+                normalizedTarget.split('/').length === parent.split('/').length + 1)
                 return true;
         }
-        if (normGlob.endsWith("/**")) {
+        if (normGlob.endsWith('/**')) {
             const parent = normGlob.slice(0, -3);
             if (normalizedTarget.startsWith(`${parent}/`))
                 return true;
@@ -58,42 +60,42 @@ function ensurePnpmWorkspaceIncludes(pnpmWorkspacePath, targetPath) {
     });
     if (!isAlreadyCovered) {
         // Insert new package pattern right under packages:
-        const lines = content.split("\n");
+        const lines = content.split('\n');
         let insertIndex = -1;
         for (let i = 0; i < lines.length; i++) {
-            if (lines[i].trim().startsWith("packages:")) {
+            if (lines[i].trim().startsWith('packages:')) {
                 insertIndex = i + 1;
                 break;
             }
         }
         if (insertIndex !== -1) {
             lines.splice(insertIndex, 0, `  - '${normalizedTarget}'`);
-            fs.writeFileSync(pnpmWorkspacePath, lines.join("\n"), "utf-8");
+            fs.writeFileSync(pnpmWorkspacePath, lines.join('\n'), 'utf-8');
         }
         else {
             const newContent = `packages:\n  - '${normalizedTarget}'\n` + content;
-            fs.writeFileSync(pnpmWorkspacePath, newContent, "utf-8");
+            fs.writeFileSync(pnpmWorkspacePath, newContent, 'utf-8');
         }
     }
 }
 function ensureVsCodeExtensions(cwd) {
-    const vscodeDir = path.join(cwd, ".vscode");
-    const extFile = path.join(vscodeDir, "extensions.json");
+    const vscodeDir = path.join(cwd, '.vscode');
+    const extFile = path.join(vscodeDir, 'extensions.json');
     if (!fs.existsSync(vscodeDir))
         fs.mkdirSync(vscodeDir, { recursive: true });
     let config = { recommendations: [] };
     if (fs.existsSync(extFile)) {
         try {
-            config = JSON.parse(fs.readFileSync(extFile, "utf-8"));
+            config = JSON.parse(fs.readFileSync(extFile, 'utf-8'));
         }
         catch { }
     }
     if (!Array.isArray(config.recommendations))
         config.recommendations = [];
-    if (!config.recommendations.includes("testspectra.testspectra-vscode")) {
-        config.recommendations.push("testspectra.testspectra-vscode");
+    if (!config.recommendations.includes('testspectra.testspectra-vscode')) {
+        config.recommendations.push('testspectra.testspectra-vscode');
     }
-    fs.writeFileSync(extFile, JSON.stringify(config, null, 2) + "\n", "utf-8");
+    fs.writeFileSync(extFile, JSON.stringify(config, null, 2) + '\n', 'utf-8');
 }
 function scanDirectoriesForProjects(cwd, patterns) {
     const foundProjects = [];
@@ -102,11 +104,11 @@ function scanDirectoriesForProjects(cwd, patterns) {
         if (currentDepth > maxDepth || !fs.existsSync(dir))
             return;
         const base = path.basename(dir);
-        if (base === "node_modules" || base === "dist" || base === ".testspectra" || base === ".git" || base === "shared") {
+        if (base === 'node_modules' || base === 'dist' || base === '.testspectra' || base === '.git' || base === 'shared') {
             return;
         }
-        const hasPkg = fs.existsSync(path.join(dir, "package.json"));
-        const hasNx = fs.existsSync(path.join(dir, "project.json"));
+        const hasPkg = fs.existsSync(path.join(dir, 'package.json'));
+        const hasNx = fs.existsSync(path.join(dir, 'project.json'));
         if ((hasPkg || hasNx) && dir !== cwd) {
             const rel = path.relative(cwd, dir);
             if (!visited.has(rel)) {
@@ -114,7 +116,7 @@ function scanDirectoriesForProjects(cwd, patterns) {
                 let name = path.basename(dir);
                 if (hasPkg) {
                     try {
-                        const pkg = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf-8"));
+                        const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf-8'));
                         if (pkg.name)
                             name = pkg.name;
                     }
@@ -122,7 +124,7 @@ function scanDirectoriesForProjects(cwd, patterns) {
                 }
                 else if (hasNx) {
                     try {
-                        const nxJson = JSON.parse(fs.readFileSync(path.join(dir, "project.json"), "utf-8"));
+                        const nxJson = JSON.parse(fs.readFileSync(path.join(dir, 'project.json'), 'utf-8'));
                         if (nxJson.name)
                             name = nxJson.name;
                     }
@@ -150,7 +152,7 @@ function scanDirectoriesForProjects(cwd, patterns) {
     // If patterns exist from pnpm-workspace.yaml, search those roots
     if (patterns.length > 0) {
         for (const pat of patterns) {
-            const cleanPat = pat.replace(/\/\*\*?$/, "").replace(/\/\*$/, "");
+            const cleanPat = pat.replace(/\/\*\*?$/, '').replace(/\/\*$/, '');
             const searchRoot = path.join(cwd, cleanPat);
             if (fs.existsSync(searchRoot)) {
                 const stat = fs.statSync(searchRoot);
@@ -167,7 +169,7 @@ function scanDirectoriesForProjects(cwd, patterns) {
     }
     // Fallback search in standard directories if nothing found
     if (foundProjects.length === 0) {
-        for (const fallback of ["modules", "packages", "apps", "libs", "features"]) {
+        for (const fallback of ['modules', 'packages', 'apps', 'libs', 'features']) {
             const fbPath = path.join(cwd, fallback);
             if (fs.existsSync(fbPath)) {
                 search(fbPath, 1, 3);
@@ -183,16 +185,16 @@ export async function initCommand(options = {}) {
         p.log.warn(chalk.yellow(`Config already exists at ${path.basename(existingConfig)}. Use --force to overwrite.`));
         return;
     }
-    p.intro(chalk.bold.cyan("✨ TestSpectra Enterprise Scaffolder"));
+    p.intro(chalk.bold.cyan('✨ TestSpectra Enterprise Scaffolder'));
     // Detect monorepo environment
     let isMonorepo = false;
     let pnpmPatterns = [];
-    const pnpmWorkspacePath = path.join(cwd, "pnpm-workspace.yaml");
-    const nxJsonPath = path.join(cwd, "nx.json");
+    const pnpmWorkspacePath = path.join(cwd, 'pnpm-workspace.yaml');
+    const nxJsonPath = path.join(cwd, 'nx.json');
     if (fs.existsSync(pnpmWorkspacePath)) {
         isMonorepo = true;
         try {
-            const content = fs.readFileSync(pnpmWorkspacePath, "utf-8");
+            const content = fs.readFileSync(pnpmWorkspacePath, 'utf-8');
             pnpmPatterns = parsePnpmWorkspaceGlobs(content);
         }
         catch { }
@@ -204,28 +206,33 @@ export async function initCommand(options = {}) {
     let selectedTemplate = options.template;
     if (!selectedTemplate && !options.force) {
         const templateChoice = await p.select({
-            message: "Select TestSpectra setup mode:",
-            initialValue: isMonorepo ? "nx" : "default",
+            message: 'Select TestSpectra setup mode:',
+            initialValue: isMonorepo ? 'nx' : 'default',
             options: [
                 {
-                    label: "Nx Monorepo (Recommended)",
-                    value: "nx",
-                    hint: "Interactive workspace feature discovery & centralized config",
+                    label: 'Nx Monorepo (Recommended)',
+                    value: 'nx',
+                    hint: 'Interactive workspace feature discovery & centralized config',
                 },
                 {
-                    label: "Standard Project",
-                    value: "default",
-                    hint: "Standalone single-suite E2E testing project",
+                    label: 'Standard E2E Project',
+                    value: 'default',
+                    hint: 'Standalone single-suite E2E testing project',
+                },
+                {
+                    label: 'React Component Testing',
+                    value: 'react-component',
+                    hint: 'Real-browser React component testing with Vite & Testing Library',
                 },
             ],
         });
         if (p.isCancel(templateChoice)) {
-            p.cancel("Setup cancelled.");
+            p.cancel('Setup cancelled.');
             return;
         }
         selectedTemplate = templateChoice;
     }
-    const templateName = selectedTemplate || (isMonorepo ? "nx" : "default");
+    const templateName = selectedTemplate || (isMonorepo ? 'nx' : 'default');
     // 1. Resolve template directory
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = path.dirname(__filename);
@@ -241,14 +248,14 @@ export async function initCommand(options = {}) {
         return;
     }
     // 2. Resolve CLI dependency version
-    let cliVersion = "^1.0.65";
+    let cliVersion = '^1.0.65';
     try {
         let pDir = __dirname;
         while (pDir !== path.dirname(pDir)) {
-            const cand = path.join(pDir, "package.json");
+            const cand = path.join(pDir, 'package.json');
             if (fs.existsSync(cand)) {
-                const cliPkg = JSON.parse(fs.readFileSync(cand, "utf-8"));
-                if (cliPkg.name === "@testspectra/cli" && cliPkg.version) {
+                const cliPkg = JSON.parse(fs.readFileSync(cand, 'utf-8'));
+                if (cliPkg.name === '@testspectra/cli' && cliPkg.version) {
                     cliVersion = `^${cliPkg.version}`;
                     break;
                 }
@@ -258,11 +265,11 @@ export async function initCommand(options = {}) {
     }
     catch { }
     const projectName = path.basename(cwd);
-    const cliDepVersion = cliVersion.startsWith("^") ? cliVersion : `^${cliVersion}`;
+    const cliDepVersion = cliVersion.startsWith('^') ? cliVersion : `^${cliVersion}`;
     // Helper: Copy directory contents recursively
     function copyRecursive(src, dest, replacements = {}) {
         const base = path.basename(src);
-        if (base === "node_modules" || base === "dist" || base === ".testspectra" || base === ".git") {
+        if (base === 'node_modules' || base === 'dist' || base === '.testspectra' || base === '.git') {
             return;
         }
         const stat = fs.statSync(src);
@@ -279,26 +286,30 @@ export async function initCommand(options = {}) {
             if (fs.existsSync(dest) && !options.force) {
                 return;
             }
-            let content = fs.readFileSync(src, "utf-8");
+            let content = fs.readFileSync(src, 'utf-8');
             for (const [k, v] of Object.entries(replacements)) {
                 content = content.replaceAll(k, v);
             }
-            if (dest.endsWith("package.json")) {
+            if (dest.endsWith('package.json')) {
                 try {
                     const pkg = JSON.parse(content);
-                    if (!pkg.name || pkg.name.startsWith("@testspectra/template-") || pkg.name === "spectra-monorepo") {
+                    if (!pkg.name || pkg.name.startsWith('@testspectra/template-') || pkg.name === 'spectra-monorepo') {
                         pkg.name = projectName;
                     }
                     if (pkg.devDependencies) {
                         for (const key of Object.keys(pkg.devDependencies)) {
-                            if (key.startsWith("@testspectra/") || pkg.devDependencies[key] === "workspace:*") {
+                            if (key.startsWith('@testspectra/') ||
+                                pkg.devDependencies[key] === 'workspace:*' ||
+                                (typeof pkg.devDependencies[key] === 'string' && pkg.devDependencies[key].startsWith('link:'))) {
                                 pkg.devDependencies[key] = cliDepVersion;
                             }
                         }
                     }
                     if (pkg.dependencies) {
                         for (const key of Object.keys(pkg.dependencies)) {
-                            if (key.startsWith("@testspectra/") || pkg.dependencies[key] === "workspace:*") {
+                            if (key.startsWith('@testspectra/') ||
+                                pkg.dependencies[key] === 'workspace:*' ||
+                                (typeof pkg.dependencies[key] === 'string' && pkg.dependencies[key].startsWith('link:'))) {
                                 pkg.dependencies[key] = cliDepVersion;
                             }
                         }
@@ -307,11 +318,11 @@ export async function initCommand(options = {}) {
                 }
                 catch { }
             }
-            fs.writeFileSync(dest, content, "utf-8");
+            fs.writeFileSync(dest, content, 'utf-8');
         }
     }
     // --- MONOREPO INTERACTIVE FLOW ---
-    if (templateName === "nx") {
+    if (templateName === 'nx') {
         let chosenProjects = [];
         if (options.force) {
             chosenProjects = detectedProjects.map((p) => p.relPath);
@@ -319,86 +330,81 @@ export async function initCommand(options = {}) {
         else if (detectedProjects.length > 0) {
             p.log.step(chalk.cyan(`Monorepo Auto-Discovery: Found ${detectedProjects.length} workspace feature package(s)`));
             const projectChoices = await p.multiselect({
-                message: "Select workspace features to initialize with TestSpectra:",
+                message: 'Select workspace features to initialize with TestSpectra:',
                 options: detectedProjects.map((proj) => ({
                     value: proj.relPath,
                     label: `${proj.relPath} (${proj.name})`,
-                    hint: proj.hasNxProject ? "Nx project.json" : "package.json",
+                    hint: proj.hasNxProject ? 'Nx project.json' : 'package.json',
                 })),
                 initialValues: detectedProjects.map((p) => p.relPath),
                 required: true,
             });
             if (p.isCancel(projectChoices)) {
-                p.cancel("Setup cancelled.");
+                p.cancel('Setup cancelled.');
                 return;
             }
             chosenProjects = projectChoices;
         }
         else {
             // No packages auto-detected — ask user to manually enter feature names
-            p.log.warn(chalk.yellow("No feature packages found in workspace. You can enter feature names to scaffold."));
+            p.log.warn(chalk.yellow('No feature packages found in workspace. You can enter feature names to scaffold.'));
             const featureNamesInput = await p.text({
-                message: "Enter feature module names (comma-separated), or leave blank to skip:",
-                placeholder: "playground, matchers, navigation",
-                defaultValue: "",
+                message: 'Enter feature module names (comma-separated), or leave blank to skip:',
+                placeholder: 'playground, matchers, navigation',
+                defaultValue: '',
             });
             if (p.isCancel(featureNamesInput)) {
-                p.cancel("Setup cancelled.");
+                p.cancel('Setup cancelled.');
                 return;
             }
             const raw = featureNamesInput.trim();
             if (raw) {
                 // Build relPaths from feature names using a sensible default location
                 const featureBaseInput = await p.text({
-                    message: "Enter base directory for feature modules:",
-                    placeholder: "packages",
-                    defaultValue: "packages",
+                    message: 'Enter base directory for feature modules:',
+                    placeholder: 'packages',
+                    defaultValue: 'packages',
                 });
                 if (p.isCancel(featureBaseInput)) {
-                    p.cancel("Setup cancelled.");
+                    p.cancel('Setup cancelled.');
                     return;
                 }
-                const featureBase = featureBaseInput.trim() || "packages";
-                chosenProjects = raw.split(",").map((n) => `${featureBase}/${n.trim()}`).filter(Boolean);
+                const featureBase = featureBaseInput.trim() || 'packages';
+                chosenProjects = raw
+                    .split(',')
+                    .map((n) => `${featureBase}/${n.trim()}`)
+                    .filter(Boolean);
             }
         }
-        let e2eFolderName = "e2e";
-        let sharedTestingRelPath = "shared/testing";
+        let e2eFolderName = 'e2e';
+        let sharedTestingRelPath = 'shared/testing';
         if (!options.force) {
             const e2eFolderNameInput = await p.text({
-                message: "Enter E2E test folder name for each selected feature:",
-                placeholder: "e2e",
-                defaultValue: "e2e",
+                message: 'Enter E2E test folder name for each selected feature:',
+                placeholder: 'e2e',
+                defaultValue: 'e2e',
             });
             if (p.isCancel(e2eFolderNameInput)) {
-                p.cancel("Setup cancelled.");
+                p.cancel('Setup cancelled.');
                 return;
             }
             const sharedTestingPathInput = await p.text({
-                message: "Enter path for Shared Testing library (POMs, Steps, Actions, Fixtures):",
-                placeholder: "shared/testing",
-                defaultValue: "shared/testing",
+                message: 'Enter path for Shared Testing library (POMs, Steps, Actions, Fixtures):',
+                placeholder: 'shared/testing',
+                defaultValue: 'shared/testing',
             });
             if (p.isCancel(sharedTestingPathInput)) {
-                p.cancel("Setup cancelled.");
+                p.cancel('Setup cancelled.');
                 return;
             }
-            e2eFolderName = e2eFolderNameInput.trim() || "e2e";
-            sharedTestingRelPath = sharedTestingPathInput.trim() || "shared/testing";
+            e2eFolderName = e2eFolderNameInput.trim() || 'e2e';
+            sharedTestingRelPath = sharedTestingPathInput.trim() || 'shared/testing';
         }
         const sharedTestingAbsPath = path.join(cwd, sharedTestingRelPath);
         const s = p.spinner();
-        s.start("Scaffolding distributed monorepo structure and ambient types...");
+        s.start('Scaffolding distributed monorepo structure and ambient types...');
         // 1. Centralized Root Configs & Orchestration
-        const rootConfigFiles = [
-            "spectra.config.ts",
-            "tsconfig.spectra.json",
-            "tsconfig.spectra.shared.json",
-            "tsconfig.spectra.web.json",
-            "tsconfig.spectra.android.json",
-            "tsconfig.spectra.ios.json",
-            "nx.json",
-        ];
+        const rootConfigFiles = ['spectra.config.ts', 'nx.json'];
         for (const cf of rootConfigFiles) {
             const src = path.join(templateDir, cf);
             const dest = path.join(cwd, cf);
@@ -406,31 +412,33 @@ export async function initCommand(options = {}) {
                 fs.copyFileSync(src, dest);
             }
         }
+        // Write tsconfig.json and auto-generate .testspectra/tsconfig.json and sub-configs
+        TsConfigGenerator.scaffoldConfigs(cwd, options.force);
         // Ensure root package.json has TestSpectra devDependencies
-        const rootPkgPath = path.join(cwd, "package.json");
+        const rootPkgPath = path.join(cwd, 'package.json');
         if (!fs.existsSync(rootPkgPath)) {
-            const templatePkgSrc = path.join(templateDir, "package.json");
+            const templatePkgSrc = path.join(templateDir, 'package.json');
             if (fs.existsSync(templatePkgSrc)) {
                 try {
-                    const tPkg = JSON.parse(fs.readFileSync(templatePkgSrc, "utf-8"));
-                    if (!tPkg.name || tPkg.name.startsWith("@testspectra/template-") || tPkg.name === "spectra-monorepo") {
+                    const tPkg = JSON.parse(fs.readFileSync(templatePkgSrc, 'utf-8'));
+                    if (!tPkg.name || tPkg.name.startsWith('@testspectra/template-') || tPkg.name === 'spectra-monorepo') {
                         tPkg.name = projectName;
                     }
                     if (tPkg.devDependencies) {
                         for (const key of Object.keys(tPkg.devDependencies)) {
-                            if (key.startsWith("@testspectra/") || tPkg.devDependencies[key] === "workspace:*") {
+                            if (key.startsWith('@testspectra/') || tPkg.devDependencies[key] === 'workspace:*') {
                                 tPkg.devDependencies[key] = cliDepVersion;
                             }
                         }
                     }
                     if (tPkg.dependencies) {
                         for (const key of Object.keys(tPkg.dependencies)) {
-                            if (key.startsWith("@testspectra/") || tPkg.dependencies[key] === "workspace:*") {
+                            if (key.startsWith('@testspectra/') || tPkg.dependencies[key] === 'workspace:*') {
                                 tPkg.dependencies[key] = cliDepVersion;
                             }
                         }
                     }
-                    fs.writeFileSync(rootPkgPath, JSON.stringify(tPkg, null, 2), "utf-8");
+                    fs.writeFileSync(rootPkgPath, JSON.stringify(tPkg, null, 2), 'utf-8');
                 }
                 catch {
                     fs.copyFileSync(templatePkgSrc, rootPkgPath);
@@ -439,107 +447,116 @@ export async function initCommand(options = {}) {
         }
         else {
             try {
-                const rootPkg = JSON.parse(fs.readFileSync(rootPkgPath, "utf-8"));
+                const rootPkg = JSON.parse(fs.readFileSync(rootPkgPath, 'utf-8'));
                 if (!rootPkg.devDependencies)
                     rootPkg.devDependencies = {};
-                if (!rootPkg.devDependencies["@testspectra/cli"] || rootPkg.devDependencies["@testspectra/cli"] === "workspace:*")
-                    rootPkg.devDependencies["@testspectra/cli"] = cliDepVersion;
-                if (!rootPkg.devDependencies["@testspectra/matchers"] || rootPkg.devDependencies["@testspectra/matchers"] === "workspace:*")
-                    rootPkg.devDependencies["@testspectra/matchers"] = cliDepVersion;
-                if (!rootPkg.devDependencies["typescript"])
-                    rootPkg.devDependencies["typescript"] = "^5.4.5";
-                if (!rootPkg.devDependencies["@wdio/cli"])
-                    rootPkg.devDependencies["@wdio/cli"] = "^9.2.8";
-                if (!rootPkg.devDependencies["@wdio/local-runner"])
-                    rootPkg.devDependencies["@wdio/local-runner"] = "^9.2.8";
-                if (!rootPkg.devDependencies["@wdio/spec-reporter"])
-                    rootPkg.devDependencies["@wdio/spec-reporter"] = "^9.2.8";
-                if (!rootPkg.devDependencies["@wdio/devtools-service"])
-                    rootPkg.devDependencies["@wdio/devtools-service"] = "^8.46.0";
-                if (!rootPkg.devDependencies["@wdio/globals"])
-                    rootPkg.devDependencies["@wdio/globals"] = "^9.2.8";
-                if (!rootPkg.devDependencies["@wdio/mocha-framework"])
-                    rootPkg.devDependencies["@wdio/mocha-framework"] = "^9.2.8";
-                if (!rootPkg.devDependencies["@types/node"])
-                    rootPkg.devDependencies["@types/node"] = "^20.14.0";
-                if (!rootPkg.devDependencies["webdriverio"])
-                    rootPkg.devDependencies["webdriverio"] = "^9.2.8";
-                fs.writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, 2), "utf-8");
+                if (!rootPkg.devDependencies['@testspectra/cli'] ||
+                    rootPkg.devDependencies['@testspectra/cli'] === 'workspace:*' ||
+                    (typeof rootPkg.devDependencies['@testspectra/cli'] === 'string' &&
+                        rootPkg.devDependencies['@testspectra/cli'].startsWith('link:')))
+                    rootPkg.devDependencies['@testspectra/cli'] = cliDepVersion;
+                if (!rootPkg.devDependencies['@testspectra/matchers'] ||
+                    rootPkg.devDependencies['@testspectra/matchers'] === 'workspace:*' ||
+                    (typeof rootPkg.devDependencies['@testspectra/matchers'] === 'string' &&
+                        rootPkg.devDependencies['@testspectra/matchers'].startsWith('link:')))
+                    rootPkg.devDependencies['@testspectra/matchers'] = cliDepVersion;
+                if (!rootPkg.devDependencies['typescript'])
+                    rootPkg.devDependencies['typescript'] = '^5.4.5';
+                if (!rootPkg.devDependencies['@wdio/cli'])
+                    rootPkg.devDependencies['@wdio/cli'] = '^9.2.8';
+                if (!rootPkg.devDependencies['@wdio/local-runner'])
+                    rootPkg.devDependencies['@wdio/local-runner'] = '^9.2.8';
+                if (!rootPkg.devDependencies['@wdio/spec-reporter'])
+                    rootPkg.devDependencies['@wdio/spec-reporter'] = '^9.2.8';
+                if (!rootPkg.devDependencies['@wdio/devtools-service'])
+                    rootPkg.devDependencies['@wdio/devtools-service'] = '^8.46.0';
+                if (!rootPkg.devDependencies['@wdio/globals'])
+                    rootPkg.devDependencies['@wdio/globals'] = '^9.2.8';
+                if (!rootPkg.devDependencies['@wdio/mocha-framework'])
+                    rootPkg.devDependencies['@wdio/mocha-framework'] = '^9.2.8';
+                if (!rootPkg.devDependencies['@types/node'])
+                    rootPkg.devDependencies['@types/node'] = '^20.14.0';
+                if (!rootPkg.devDependencies['webdriverio'])
+                    rootPkg.devDependencies['webdriverio'] = '^9.2.8';
+                if (!rootPkg.scripts)
+                    rootPkg.scripts = {};
+                if (!rootPkg.scripts['postinstall'])
+                    rootPkg.scripts['postinstall'] = 'spectra sync-types';
+                if (!rootPkg.scripts['type-check'])
+                    rootPkg.scripts['type-check'] = 'tsc -b';
+                fs.writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, 2), 'utf-8');
             }
             catch { }
         }
         // 2. Centralized Root .testspectra folder for cache/logs
-        const rootTestDataDir = path.join(cwd, ".testspectra");
+        const rootTestDataDir = path.join(cwd, '.testspectra');
         if (!fs.existsSync(rootTestDataDir)) {
             fs.mkdirSync(rootTestDataDir, { recursive: true });
         }
         // 3. Centralized Shared Testing Library
-        const sharedTestingSrc = path.join(templateDir, "shared/testing");
+        const sharedTestingSrc = path.join(templateDir, 'shared/testing');
         if (fs.existsSync(sharedTestingSrc)) {
             copyRecursive(sharedTestingSrc, sharedTestingAbsPath);
         }
         // 4. Distribute E2E Folders to Selected Feature Modules
-        const sampleE2eSrc = path.join(templateDir, "packages/playground/e2e");
+        const sampleE2eSrc = path.join(templateDir, 'packages/playground/e2e');
         const featureE2eDirs = [];
         for (const projRel of chosenProjects) {
             const targetE2eDir = path.join(cwd, projRel, e2eFolderName);
             const featureName = path.basename(projRel);
             const e2eProjectName = `${featureName}-${e2eFolderName}`;
             copyRecursive(sampleE2eSrc, targetE2eDir, {
-                "playground-e2e": e2eProjectName,
-                "packages/playground/e2e": path.relative(cwd, targetE2eDir).replace(/\\/g, "/"),
-                "scope:playground": `scope:${featureName}`,
+                'playground-e2e': e2eProjectName,
+                'packages/playground/e2e': path.relative(cwd, targetE2eDir).replace(/\\/g, '/'),
+                'scope:playground': `scope:${featureName}`,
             });
             // Adjust project.json
-            const projJsonPath = path.join(targetE2eDir, "project.json");
+            const projJsonPath = path.join(targetE2eDir, 'project.json');
             if (fs.existsSync(projJsonPath)) {
                 try {
-                    const pObj = JSON.parse(fs.readFileSync(projJsonPath, "utf-8"));
+                    const pObj = JSON.parse(fs.readFileSync(projJsonPath, 'utf-8'));
                     pObj.name = e2eProjectName;
-                    pObj.sourceRoot = path.relative(cwd, targetE2eDir).replace(/\\/g, "/");
-                    pObj.targets.e2e.options.cwd = path.relative(cwd, targetE2eDir).replace(/\\/g, "/");
-                    pObj.targets["type-check"].options.cwd = ".";
-                    pObj.tags = [`scope:${featureName}`, "type:e2e"];
-                    fs.writeFileSync(projJsonPath, JSON.stringify(pObj, null, 2), "utf-8");
+                    pObj.sourceRoot = path.relative(cwd, targetE2eDir).replace(/\\/g, '/');
+                    pObj.targets.e2e.options.cwd = path.relative(cwd, targetE2eDir).replace(/\\/g, '/');
+                    pObj.targets['type-check'].options.cwd = '.';
+                    pObj.tags = [`scope:${featureName}`, 'type:e2e'];
+                    fs.writeFileSync(projJsonPath, JSON.stringify(pObj, null, 2), 'utf-8');
                 }
                 catch { }
             }
             // Ensure no local spectra.config.ts (centralized in root)
-            const localConfig = path.join(targetE2eDir, "spectra.config.ts");
+            const localConfig = path.join(targetE2eDir, 'spectra.config.ts');
             if (fs.existsSync(localConfig))
                 fs.unlinkSync(localConfig);
             featureE2eDirs.push(targetE2eDir);
         }
         // 5. Ensure pnpm-workspace.yaml includes shared library (feature modules are already part of existing workspace globs)
-        const pnpmWorkspaceFilePath = path.join(cwd, "pnpm-workspace.yaml");
+        const pnpmWorkspaceFilePath = path.join(cwd, 'pnpm-workspace.yaml');
         ensurePnpmWorkspaceIncludes(pnpmWorkspaceFilePath, sharedTestingRelPath);
-        // 6. Update Root Solution tsconfig.json to reference tsconfig.spectra.json
-        const rootTsConfigPath = path.join(cwd, "tsconfig.json");
+        // 6. Update Root Solution tsconfig.json to reference .testspectra/tsconfig.json
+        const rootTsConfigPath = path.join(cwd, 'tsconfig.json');
         let rootTsConfig = { files: [], references: [] };
         if (fs.existsSync(rootTsConfigPath)) {
             try {
-                rootTsConfig = JSON.parse(fs.readFileSync(rootTsConfigPath, "utf-8"));
+                rootTsConfig = JSON.parse(fs.readFileSync(rootTsConfigPath, 'utf-8'));
                 if (!rootTsConfig.references)
                     rootTsConfig.references = [];
-                if (!rootTsConfig.references.some((r) => r.path === "./tsconfig.spectra.json")) {
-                    rootTsConfig.references.push({ path: "./tsconfig.spectra.json" });
+                rootTsConfig.references = rootTsConfig.references.filter((r) => r.path !== './tsconfig.spectra.json');
+                if (!rootTsConfig.references.some((r) => r.path === './.testspectra/tsconfig.json')) {
+                    rootTsConfig.references.push({ path: './.testspectra/tsconfig.json' });
                 }
             }
             catch {
-                rootTsConfig = { files: [], references: [{ path: "./tsconfig.spectra.json" }] };
+                rootTsConfig = { files: [], references: [{ path: './.testspectra/tsconfig.json' }] };
             }
         }
         else {
-            rootTsConfig = { files: [], references: [{ path: "./tsconfig.spectra.json" }] };
+            rootTsConfig = { files: [], references: [{ path: './.testspectra/tsconfig.json' }] };
         }
-        fs.writeFileSync(rootTsConfigPath, JSON.stringify(rootTsConfig, null, 2), "utf-8");
+        fs.writeFileSync(rootTsConfigPath, JSON.stringify(rootTsConfig, null, 2), 'utf-8');
         // 7. Generate Ambient Types in ROOT only
         TypeGenerator.writeDeclarationFiles(cwd);
         ensureVsCodeExtensions(cwd);
-        const sharedPoLine = `${sharedTestingRelPath}/page-objects`.padEnd(28, " ");
-        const sharedStepsLine = `${sharedTestingRelPath}/steps`.padEnd(28, " ");
-        const sharedActLine = `${sharedTestingRelPath}/actions`.padEnd(28, " ");
-        const sharedFixLine = `${sharedTestingRelPath}/fixtures`.padEnd(28, " ");
         const archDocContent = `# TestSpectra Enterprise Monorepo Architecture
 
 This workspace uses TestSpectra's **"Centralized Configuration, Distributed Implementation"** model for automated cross-platform testing.
@@ -550,14 +567,10 @@ This workspace uses TestSpectra's **"Centralized Configuration, Distributed Impl
 
 ### Centralized Root Elements
 - \`./spectra.config.ts\`: Single source of truth for runtime configurations (Base URL, Appium devices, browser targets, timeouts).
-- \`./.testspectra/\`: Local test project cache (execution logs, temp artifacts, and universal ambient types in \`.testspectra/types/\`). Global binaries and drivers are managed at \`~/.testspectra/drivers/\`.
-- \`./tsconfig.spectra.json\`: Solution TypeScript entry point equipped with TestSpectra language service plugin.
-- \`./tsconfig.spectra.web.json\`: Strongly-typed composite configuration for Web platform tests.
-- \`./tsconfig.spectra.android.json\`: Strongly-typed composite configuration for Android platform tests.
-- \`./tsconfig.spectra.ios.json\`: Strongly-typed composite configuration for iOS platform tests.
+- \`./.testspectra/\`: Local test project cache, runtime metadata, auto-generated master TSConfig (\`.testspectra/tsconfig.json\`), platform sub-configs (\`.testspectra/tsconfig/\`), and universal ambient types (\`.testspectra/types/\`). Global binaries and drivers are managed at \`~/.testspectra/drivers/\`.
 - \`./nx.json\`: Nx target defaults with execution caching and inputs.
 - \`./pnpm-workspace.yaml\`: Monorepo package glob definitions.
-- \`./tsconfig.json\`: Solution-style TypeScript orchestrator linking all distributed E2E projects and shared libraries.
+- \`./tsconfig.json\`: Solution-style TypeScript orchestrator referencing \`./.testspectra/tsconfig.json\`.
 
 ### Centralized Shared Testing Library (\`./${sharedTestingRelPath}\`)
 Provides cross-feature reusable test entities with **100% zero-import global resolution**:
@@ -567,7 +580,8 @@ Provides cross-feature reusable test entities with **100% zero-import global res
 - \`fixtures/\`: Common test data and environment configurations (e.g. \`Fixture.appConfig\`).
 
 ### Distributed Feature E2E Modules (${featureE2eDirs.length} Features)
-${featureE2eDirs.map((d) => {
+${featureE2eDirs
+            .map((d) => {
             const rel = path.relative(cwd, d);
             const name = path.basename(path.dirname(d));
             const e2eName = `${name}-${e2eFolderName}`;
@@ -575,7 +589,8 @@ ${featureE2eDirs.map((d) => {
   - \`specs/\`: Feature test cases (\`specs/<SuiteName>/<CaseId>/\` with \`web.test.ts\`, \`android.test.ts\`, \`ios.test.ts\`).
   - \`page-objects/\`: Feature-specific Page Objects (e.g. \`LoginPage\`, \`ProductPage\`).
   - \`project.json\`: Nx targets (\`e2e\`, \`type-check\`) supporting configurations (\`--configuration=android\`, \`--configuration=ios\`, \`--configuration=headless\`).`;
-        }).join("\n")}
+        })
+            .join('\n')}
 
 ---
 
@@ -644,7 +659,7 @@ pnpm nx affected -t e2e
 
 \`\`\`bash
 # Navigate to the feature e2e folder
-cd ${featureE2eDirs.length > 0 ? path.relative(cwd, featureE2eDirs[0]).replace(/\\/g, "/") : `modules/auth/${e2eFolderName}`}
+cd ${featureE2eDirs.length > 0 ? path.relative(cwd, featureE2eDirs[0]).replace(/\\/g, '/') : `modules/auth/${e2eFolderName}`}
 
 # Run all specs in this feature
 pnpm spectra run
@@ -672,12 +687,12 @@ pnpm type-check
 # or: npx tsc -b
 \`\`\`
 `;
-        fs.writeFileSync(path.join(cwd, "ARCHITECTURE.md"), archDocContent, "utf-8");
+        fs.writeFileSync(path.join(cwd, 'ARCHITECTURE.md'), archDocContent, 'utf-8');
         // 8. Ensure root .gitignore ignores .testspectra/ and *.tsbuildinfo
-        const rootGitignorePath = path.join(cwd, ".gitignore");
-        const ignoreEntries = [".testspectra/", "*.tsbuildinfo", ".nx/cache"];
+        const rootGitignorePath = path.join(cwd, '.gitignore');
+        const ignoreEntries = ['.testspectra/', '*.tsbuildinfo', '.nx/cache'];
         if (fs.existsSync(rootGitignorePath)) {
-            let giContent = fs.readFileSync(rootGitignorePath, "utf-8");
+            let giContent = fs.readFileSync(rootGitignorePath, 'utf-8');
             let added = false;
             for (const entry of ignoreEntries) {
                 if (!giContent.includes(entry)) {
@@ -686,42 +701,42 @@ pnpm type-check
                 }
             }
             if (added) {
-                fs.writeFileSync(rootGitignorePath, giContent.trim() + "\n", "utf-8");
+                fs.writeFileSync(rootGitignorePath, giContent.trim() + '\n', 'utf-8');
             }
         }
         else {
-            fs.writeFileSync(rootGitignorePath, `node_modules/\ndist/\n${ignoreEntries.join("\n")}\n`, "utf-8");
+            fs.writeFileSync(rootGitignorePath, `node_modules/\ndist/\n${ignoreEntries.join('\n')}\n`, 'utf-8');
         }
         // 9. Safely append to root README.md (do not overwrite existing content)
-        const rootReadmePath = path.join(cwd, "README.md");
+        const rootReadmePath = path.join(cwd, 'README.md');
         const archSection = `\n## E2E Testing Architecture (TestSpectra)\n\nThis workspace uses TestSpectra's **Centralized Configuration, Distributed Implementation** architecture.\nDetailed architecture, folder map, and zero-import mechanics are documented in:  \n👉 **[ARCHITECTURE.md](./ARCHITECTURE.md)**\n\n- **Run all E2E tests**: \`pnpm nx run-many -t e2e\`\n- **Run affected E2E tests**: \`pnpm nx affected -t e2e\`\n- **Type-check E2E suites**: \`pnpm type-check\`\n`;
         if (fs.existsSync(rootReadmePath)) {
-            const existing = fs.readFileSync(rootReadmePath, "utf-8");
-            if (!existing.includes("ARCHITECTURE.md")) {
-                fs.appendFileSync(rootReadmePath, archSection, "utf-8");
+            const existing = fs.readFileSync(rootReadmePath, 'utf-8');
+            if (!existing.includes('ARCHITECTURE.md')) {
+                fs.appendFileSync(rootReadmePath, archSection, 'utf-8');
             }
         }
         else {
             const readmeContent = `# ${projectName}\n\nAutomated cross-platform E2E testing powered by [TestSpectra](https://github.com/testspectra).\n${archSection}`;
-            fs.writeFileSync(rootReadmePath, readmeContent, "utf-8");
+            fs.writeFileSync(rootReadmePath, readmeContent, 'utf-8');
         }
-        s.stop("Monorepo scaffolding complete!");
-        p.log.success(chalk.green("Centralized Configuration: ./spectra.config.ts"));
-        p.log.success(chalk.green("Centralized App Data/Cache: ./.testspectra/"));
+        s.stop('Monorepo scaffolding complete!');
+        p.log.success(chalk.green('Centralized Configuration: ./spectra.config.ts'));
+        p.log.success(chalk.green('Centralized App Data/Cache: ./.testspectra/'));
         p.log.success(chalk.green(`Shared Testing Library: ./${sharedTestingRelPath}`));
-        p.log.success(chalk.green("Architecture Documentation: ./ARCHITECTURE.md"));
-        p.log.message(chalk.cyan(`Initialized Features (${featureE2eDirs.length}):\n${featureE2eDirs.map((d) => `  - ./${path.relative(cwd, d)}`).join("\n")}`));
-        p.outro(chalk.bold.green("🎉 Enterprise Nx Monorepo ready for testing!"));
+        p.log.success(chalk.green('Architecture Documentation: ./ARCHITECTURE.md'));
+        p.log.message(chalk.cyan(`Initialized Features (${featureE2eDirs.length}):\n${featureE2eDirs.map((d) => `  - ./${path.relative(cwd, d)}`).join('\n')}`));
+        p.outro(chalk.bold.green('🎉 Enterprise Nx Monorepo ready for testing!'));
         return;
     }
     // --- STANDALONE / DEFAULT PROJECT FLOW ---
     const s = p.spinner();
-    s.start("Scaffolding standalone TestSpectra project...");
+    s.start('Scaffolding standalone TestSpectra project...');
     copyRecursive(templateDir, cwd);
-    const standaloneWsPath = path.join(cwd, "pnpm-workspace.yaml");
+    const standaloneWsPath = path.join(cwd, 'pnpm-workspace.yaml');
     if (!fs.existsSync(standaloneWsPath) || options.force) {
         const pnpmWsContent = `allowBuilds:\n  chromedriver: true\n  edgedriver: true\n  geckodriver: true\n`;
-        fs.writeFileSync(standaloneWsPath, pnpmWsContent, "utf-8");
+        fs.writeFileSync(standaloneWsPath, pnpmWsContent, 'utf-8');
     }
     TypeGenerator.writeDeclarationFiles(cwd);
     ensureVsCodeExtensions(cwd);
@@ -753,22 +768,22 @@ pnpm spectra run --target ios
 pnpm type-check
 \`\`\`
 `;
-    fs.writeFileSync(path.join(cwd, "ARCHITECTURE.md"), standaloneArchDoc, "utf-8");
+    fs.writeFileSync(path.join(cwd, 'ARCHITECTURE.md'), standaloneArchDoc, 'utf-8');
     // Safely update root README.md (do not overwrite existing content)
-    const standaloneReadmePath = path.join(cwd, "README.md");
+    const standaloneReadmePath = path.join(cwd, 'README.md');
     const standaloneArchSection = `\n## E2E Testing Architecture (TestSpectra)\n\nDetailed test architecture and folder map are documented in:  \n👉 **[ARCHITECTURE.md](./ARCHITECTURE.md)**\n\n- **Run tests**: \`pnpm test\`\n- **Type-check**: \`pnpm type-check\`\n`;
     if (fs.existsSync(standaloneReadmePath)) {
-        const existing = fs.readFileSync(standaloneReadmePath, "utf-8");
-        if (!existing.includes("ARCHITECTURE.md")) {
-            fs.appendFileSync(standaloneReadmePath, standaloneArchSection, "utf-8");
+        const existing = fs.readFileSync(standaloneReadmePath, 'utf-8');
+        if (!existing.includes('ARCHITECTURE.md')) {
+            fs.appendFileSync(standaloneReadmePath, standaloneArchSection, 'utf-8');
         }
     }
     else {
         const standaloneReadme = `# ${projectName}\n\nTestSpectra automated testing project.\n${standaloneArchSection}`;
-        fs.writeFileSync(standaloneReadmePath, standaloneReadme, "utf-8");
+        fs.writeFileSync(standaloneReadmePath, standaloneReadme, 'utf-8');
     }
-    s.stop("Standalone project ready!");
-    p.log.success(chalk.green("Generated ambient multi-platform types in .testspectra/types/"));
-    p.log.success(chalk.green("Architecture documentation created at ./ARCHITECTURE.md"));
-    p.outro(chalk.bold.green("🎉 Project initialized successfully!"));
+    s.stop('Standalone project ready!');
+    p.log.success(chalk.green('Generated ambient multi-platform types in .testspectra/types/'));
+    p.log.success(chalk.green('Architecture documentation created at ./ARCHITECTURE.md'));
+    p.outro(chalk.bold.green('🎉 Project initialized successfully!'));
 }