@testspectra/cli 1.1.8-rc.2 → 1.1.8-rc.20

package/dist/commands/__tests__/run-e2e.test.js

@@ -146,10 +146,10 @@ describe('End-to-End (E2E) Test Plan: Native Orchestrator Execution (docs/v2/cor
         // Inject a failing step / invalid selector in a new test case
         const failingDir = path.join(tmpDir, 'specs', 'Playground', 'TC-0099-failing');
         fs.mkdirSync(failingDir, { recursive: true });
-        fs.writeFileSync(path.join(failingDir, 'web.test.ts'), `it("should fail when element does not exist", async () => {
-  await Step.verifyPlaygroundState();
-  await $("#non-existent-button-999").shouldBeVisible();
-});
+        fs.writeFileSync(path.join(failingDir, 'web.test.ts'), `it("should fail when element does not exist", async () => {
+  await Step.verifyPlaygroundState();
+  await $("#non-existent-button-999").shouldBeVisible();
+});
 `, 'utf-8');
         // Mock exit to prevent process termination during unit test assertion
         const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
@@ -166,13 +166,13 @@ describe('End-to-End (E2E) Test Plan: Native Orchestrator Execution (docs/v2/cor
         // 1. Test a valid spec using pure Spectra static commands
         const spectraStaticDir = path.join(tmpDir, 'specs', 'Playground', 'TC-0100-spectra-static');
         fs.mkdirSync(spectraStaticDir, { recursive: true });
-        fs.writeFileSync(path.join(spectraStaticDir, 'web.test.ts'), `it("should execute via unified Spectra static object", async () => {
-  await Spectra.navigate("/#playground");
-  await Spectra.type("#demo-email-input-pg", "automated@spectra.dev");
-  await Spectra.get("#demo-email-input-pg").shouldHaveValue("automated@spectra.dev");
-  await Spectra.wait(50);
-  await Spectra.getAll(".demo-product-item").shouldHaveLengthGreaterThan(0);
-});
+        fs.writeFileSync(path.join(spectraStaticDir, 'web.test.ts'), `it("should execute via unified Spectra static object", async () => {
+  await Spectra.navigate("/#playground");
+  await Spectra.type("#demo-email-input-pg", "automated@spectra.dev");
+  await Spectra.get("#demo-email-input-pg").shouldHaveValue("automated@spectra.dev");
+  await Spectra.wait(50);
+  await Spectra.getAll(".demo-product-item").shouldHaveLengthGreaterThan(0);
+});
 `, 'utf-8');
         await runCommand(['specs/Playground/TC-0100-spectra-static/web.test.ts'], { target: 'web', demo: true });
         const resultStatic = JSON.parse(fs.readFileSync(path.join(tmpDir, '.testspectra', 'reports', 'result.json'), 'utf-8'));
@@ -181,11 +181,11 @@ describe('End-to-End (E2E) Test Plan: Native Orchestrator Execution (docs/v2/cor
         // 2. Test that assertion mismatch on existing element strictly FAILS (no false positive)
         const mismatchDir = path.join(tmpDir, 'specs', 'Playground', 'TC-0101-mismatch');
         fs.mkdirSync(mismatchDir, { recursive: true });
-        fs.writeFileSync(path.join(mismatchDir, 'web.test.ts'), `it("should strictly fail when assertion text does not match", async () => {
-  await Spectra.navigate("/#playground");
-  // Element exists, but text is wrong -> MUST throw and fail
-  await Spectra.get("#demo-email-input-pg").shouldHaveValue("completely_wrong_value_xyz");
-});
+        fs.writeFileSync(path.join(mismatchDir, 'web.test.ts'), `it("should strictly fail when assertion text does not match", async () => {
+  await Spectra.navigate("/#playground");
+  // Element exists, but text is wrong -> MUST throw and fail
+  await Spectra.get("#demo-email-input-pg").shouldHaveValue("completely_wrong_value_xyz");
+});
 `, 'utf-8');
         const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
         await runCommand(['specs/Playground/TC-0101-mismatch/web.test.ts'], { target: 'web', demo: true });
@@ -375,39 +375,39 @@ describe('End-to-End (E2E) Test Plan: Native Orchestrator Execution (docs/v2/cor
     it('E2E-10: Spectra.intercept FIFO respondOnce sequential polling and abort simulation in real Chromium', async () => {
         const fifoAbortDir = path.join(tmpDir, 'specs', 'ApiInterception', 'TC-0010-fifo-abort');
         fs.mkdirSync(fifoAbortDir, { recursive: true });
-        fs.writeFileSync(path.join(fifoAbortDir, 'web.test.ts'), `it("should handle FIFO respondOnce queue and abort simulation", async () => {
-  await MatchersPage.open("api-fetch");
-
-  // Setup intercept with default fallback and FIFO queue
-  const mock = await Spectra.intercept("api/posts", "GET", [
-    { id: 999, title: "Default Fallback Post" }
-  ]);
-
-  await mock.respondOnce([
-    { id: 101, title: "FIFO Queued Post #1" }
-  ]);
-  await mock.respondOnce([
-    { id: 102, title: "FIFO Queued Post #2" }
-  ]);
-
-  // 1. First fetch triggers FIFO item #1
-  await MatchersPage.fetchApiButton.click();
-  await MatchersPage.fetchedItems.first().shouldContainText("FIFO Queued Post #1");
-
-  // 2. Second fetch triggers FIFO item #2
-  await MatchersPage.fetchApiButton.click();
-  await MatchersPage.fetchedItems.first().shouldContainText("FIFO Queued Post #2");
-
-  // 3. Third fetch falls back to default response
-  await MatchersPage.fetchApiButton.click();
-  await MatchersPage.fetchedItems.first().shouldContainText("Default Fallback Post");
-
-  // 4. Test abort simulation
-  await mock.abort("Failed");
-  await MatchersPage.fetchApiButton.click();
-  // On network failure, demo app shows fallback 200 OK from catch block
-  await MatchersPage.fetchStatusBadge.shouldHaveText("200 OK");
-});
+        fs.writeFileSync(path.join(fifoAbortDir, 'web.test.ts'), `it("should handle FIFO respondOnce queue and abort simulation", async () => {
+  await MatchersPage.open("api-fetch");
+
+  // Setup intercept with default fallback and FIFO queue
+  const mock = await Spectra.intercept("api/posts", "GET", [
+    { id: 999, title: "Default Fallback Post" }
+  ]);
+
+  await mock.respondOnce([
+    { id: 101, title: "FIFO Queued Post #1" }
+  ]);
+  await mock.respondOnce([
+    { id: 102, title: "FIFO Queued Post #2" }
+  ]);
+
+  // 1. First fetch triggers FIFO item #1
+  await MatchersPage.fetchApiButton.click();
+  await MatchersPage.fetchedItems.first().shouldContainText("FIFO Queued Post #1");
+
+  // 2. Second fetch triggers FIFO item #2
+  await MatchersPage.fetchApiButton.click();
+  await MatchersPage.fetchedItems.first().shouldContainText("FIFO Queued Post #2");
+
+  // 3. Third fetch falls back to default response
+  await MatchersPage.fetchApiButton.click();
+  await MatchersPage.fetchedItems.first().shouldContainText("Default Fallback Post");
+
+  // 4. Test abort simulation
+  await mock.abort("Failed");
+  await MatchersPage.fetchApiButton.click();
+  // On network failure, demo app shows fallback 200 OK from catch block
+  await MatchersPage.fetchStatusBadge.shouldHaveText("200 OK");
+});
 `, 'utf-8');
         await runCommand(['specs/ApiInterception/TC-0010-fifo-abort/web.test.ts'], { target: 'web' });
         const resultJsonPath = path.join(tmpDir, '.testspectra', 'reports', 'result.json');

package/dist/commands/add.js

@@ -289,6 +289,7 @@ export async function addCommand(moduleNameArg, options = {}) {
         copyRecursive(sampleE2eSrc, targetE2eDir, {
             'playground-e2e': e2eProjectName,
             'packages/playground/e2e': path.relative(rootDir, targetE2eDir).replace(/\\/g, '/'),
+            'testspectra:scope:playground': `testspectra:scope:${featureName}`,
             'scope:playground': `scope:${featureName}`,
         });
         // Adjust project.json
@@ -300,7 +301,7 @@ export async function addCommand(moduleNameArg, options = {}) {
                 pObj.sourceRoot = path.relative(rootDir, targetE2eDir).replace(/\\/g, '/');
                 pObj.targets.e2e.options.cwd = path.relative(rootDir, targetE2eDir).replace(/\\/g, '/');
                 pObj.targets['type-check'].options.cwd = '.';
-                pObj.tags = [`scope:${featureName}`, 'type:e2e'];
+                pObj.tags = ['testspectra:e2e', `testspectra:scope:${featureName}`];
                 fs.writeFileSync(projJsonPath, JSON.stringify(pObj, null, 2), 'utf-8');
             }
             catch { }

package/dist/commands/devices.js

@@ -32,6 +32,7 @@ export async function devicesCommand(options = {}) {
             cwd,
             env: getRunnerEnv(),
             stdio: 'inherit',
+            windowsHide: true,
         });
         child.on('close', (code) => {
             if (code === 0) {

package/dist/commands/doctor.js

@@ -42,6 +42,7 @@ export async function doctorCommand(options = {}) {
             cwd,
             env: getRunnerEnv(),
             stdio: 'inherit',
+            windowsHide: true,
         });
         child.on('close', (code) => {
             if (code === 0 || options.fix) {

package/dist/commands/init.js

@@ -508,6 +508,7 @@ export async function initCommand(options = {}) {
             copyRecursive(sampleE2eSrc, targetE2eDir, {
                 'playground-e2e': e2eProjectName,
                 'packages/playground/e2e': path.relative(cwd, targetE2eDir).replace(/\\/g, '/'),
+                'testspectra:scope:playground': `testspectra:scope:${featureName}`,
                 'scope:playground': `scope:${featureName}`,
             });
             // Adjust project.json
@@ -519,7 +520,7 @@ export async function initCommand(options = {}) {
                     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'];
+                    pObj.tags = ['testspectra:e2e', `testspectra:scope:${featureName}`];
                     fs.writeFileSync(projJsonPath, JSON.stringify(pObj, null, 2), 'utf-8');
                 }
                 catch { }
@@ -557,135 +558,135 @@ export async function initCommand(options = {}) {
         // 7. Generate Ambient Types in ROOT only
         TypeGenerator.writeDeclarationFiles(cwd);
         ensureVsCodeExtensions(cwd);
-        const archDocContent = `# TestSpectra Enterprise Monorepo Architecture
-
-This workspace uses TestSpectra's **"Centralized Configuration, Distributed Implementation"** model for automated cross-platform testing.
-
----
-
-## 1. Directory & File Overview
-
-### 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, 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 referencing \`./.testspectra/tsconfig.json\`.
-
-### Centralized Shared Testing Library (\`./${sharedTestingRelPath}\`)
-Provides cross-feature reusable test entities with **100% zero-import global resolution**:
-- \`page-objects/\`: Shared Page Object models (e.g. NavigationBar, AppHeader).
-- \`steps/\`: Cross-feature business step flows (e.g. \`Step.loginAsAdmin()\`).
-- \`actions/\`: Custom atomic actions (e.g. \`Spectra.dismissBanner()\`).
-- \`fixtures/\`: Common test data and environment configurations (e.g. \`Fixture.appConfig\`).
-
-### Distributed Feature E2E Modules (${featureE2eDirs.length} Features)
+        const archDocContent = `# TestSpectra Enterprise Monorepo Architecture
+
+This workspace uses TestSpectra's **"Centralized Configuration, Distributed Implementation"** model for automated cross-platform testing.
+
+---
+
+## 1. Directory & File Overview
+
+### 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, 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 referencing \`./.testspectra/tsconfig.json\`.
+
+### Centralized Shared Testing Library (\`./${sharedTestingRelPath}\`)
+Provides cross-feature reusable test entities with **100% zero-import global resolution**:
+- \`page-objects/\`: Shared Page Object models (e.g. NavigationBar, AppHeader).
+- \`steps/\`: Cross-feature business step flows (e.g. \`Step.loginAsAdmin()\`).
+- \`actions/\`: Custom atomic actions (e.g. \`Spectra.dismissBanner()\`).
+- \`fixtures/\`: Common test data and environment configurations (e.g. \`Fixture.appConfig\`).
+
+### Distributed Feature E2E Modules (${featureE2eDirs.length} Features)
 ${featureE2eDirs
             .map((d) => {
             const rel = path.relative(cwd, d);
             const name = path.basename(path.dirname(d));
             const e2eName = `${name}-${e2eFolderName}`;
-            return `- \`./${rel}\` (**${name}**, Nx Project: \`${e2eName}\`):
-  - \`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\`).
+            return `- \`./${rel}\` (**${name}**, Nx Project: \`${e2eName}\`):
+  - \`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')}
-
----
-
-## 2. Zero-Import Consumption Flow & Mechanics
-
-TestSpectra completely eliminates boilerplate \`import\` statements across all test specs, steps, and page objects.
-
-### How It Works:
-1. **Centralized Ambient Aggregation**:  
-   TestSpectra Language Service Plugin & CLI automatically scan:
-   - **Local Feature Entities**: \`<feature>/${e2eFolderName}/page-objects/\`, \`<feature>/${e2eFolderName}/steps/\`, \`<feature>/${e2eFolderName}/actions/\`
-   - **Shared Library Entities**: \`./${sharedTestingRelPath}/page-objects/\`, \`./${sharedTestingRelPath}/steps/\`, \`./${sharedTestingRelPath}/actions/\`, \`./${sharedTestingRelPath}/fixtures/\`
-2. **Ambient Typing Generation**:  
-   These are compiled into \`.testspectra/types/web.d.ts\`, \`android.d.ts\`, \`ios.d.ts\`, \`fixtures.d.ts\`.
-3. **Instant IDE Autocomplete & Zero Clutter**:  
-   Specs consume both local feature objects and shared library utilities globally.
-
-### Code Example:
-\`\`\`typescript
-// packages/features/auth/e2e/specs/Auth/TC-AUTH-01/web.test.ts
-// 🌟 NOTICE: 100% Zero-Import & Flat Execution! (No import statement, no describe wrapper)
-
-it("should navigate via shared header and login with local POM", async () => {
-  // 1. Consumed from Shared Testing Library (${sharedTestingRelPath}/page-objects/NavigationBar)
-  await NavigationBar.goToLogin();
-
-  // 2. Consumed from Shared Testing Library (${sharedTestingRelPath}/steps/loginAsAdmin)
-  await Step.loginAsAdmin();
-
-  // 3. Consumed from Local Feature POM (page-objects/LoginPage)
-  await LoginPage.flashAlert.shouldBeVisible();
-  await LoginPage.flashAlert.shouldContainText("Welcome");
-
-  // 4. Consumed from Shared Testing Library Custom Action (${sharedTestingRelPath}/actions/dismissBanner)
-  await Spectra.dismissBanner();
-});
-\`\`\`
-
----
-
-## 3. How to Run Tests
-
-You can execute tests either from the **Monorepo Root via Nx** or directly inside each **Feature Directory via CLI**:
-
-### Option A: From Root Monorepo via Nx (Recommended for CI & Team Workflows)
-
-\`\`\`bash
-# 1. Run E2E for a SPECIFIC feature module (e.g. auth)
-pnpm nx run auth-${e2eFolderName}:e2e
-
-# 2. Run E2E for a specific feature on ANDROID or IOS
-pnpm nx run auth-${e2eFolderName}:e2e --configuration=android
-pnpm nx run auth-${e2eFolderName}:e2e --configuration=ios
-
-# 3. Run E2E for a specific feature in HEADLESS browser mode
-pnpm nx run auth-${e2eFolderName}:e2e --configuration=headless
-
-# 4. Run ALL feature E2E suites across the entire monorepo in parallel
-pnpm nx run-many -t e2e
-
-# 5. Run only E2E tests for features modified in current Git branch / PR
-pnpm nx affected -t e2e
-\`\`\`
-
-### Option B: From Inside the Feature Directory (Direct CLI)
-
-\`\`\`bash
-# Navigate to the feature e2e folder
-cd ${featureE2eDirs.length > 0 ? path.relative(cwd, featureE2eDirs[0]).replace(/\\/g, '/') : `modules/auth/${e2eFolderName}`}
-
-# Run all specs in this feature
-pnpm spectra run
-
-# Run a specific test case file
-pnpm spectra run specs/Auth/TC-AUTH-01/web.test.ts
-
-# Target Android device or emulator
-pnpm spectra run --target android
-
-# Run in headed / interactive browser mode
-pnpm spectra run --no-headless
-\`\`\`
-
----
-
-## 4. Type Checking & Validation
-
-\`\`\`bash
-# Type check all E2E projects via Nx
-pnpm nx run-many -t type-check
-
-# Or standard TypeScript project references build from root
-pnpm type-check
-# or: npx tsc -b
-\`\`\`
+            .join('\n')}
+
+---
+
+## 2. Zero-Import Consumption Flow & Mechanics
+
+TestSpectra completely eliminates boilerplate \`import\` statements across all test specs, steps, and page objects.
+
+### How It Works:
+1. **Centralized Ambient Aggregation**:  
+   TestSpectra Language Service Plugin & CLI automatically scan:
+   - **Local Feature Entities**: \`<feature>/${e2eFolderName}/page-objects/\`, \`<feature>/${e2eFolderName}/steps/\`, \`<feature>/${e2eFolderName}/actions/\`
+   - **Shared Library Entities**: \`./${sharedTestingRelPath}/page-objects/\`, \`./${sharedTestingRelPath}/steps/\`, \`./${sharedTestingRelPath}/actions/\`, \`./${sharedTestingRelPath}/fixtures/\`
+2. **Ambient Typing Generation**:  
+   These are compiled into \`.testspectra/types/web.d.ts\`, \`android.d.ts\`, \`ios.d.ts\`, \`fixtures.d.ts\`.
+3. **Instant IDE Autocomplete & Zero Clutter**:  
+   Specs consume both local feature objects and shared library utilities globally.
+
+### Code Example:
+\`\`\`typescript
+// packages/features/auth/e2e/specs/Auth/TC-AUTH-01/web.test.ts
+// 🌟 NOTICE: 100% Zero-Import & Flat Execution! (No import statement, no describe wrapper)
+
+it("should navigate via shared header and login with local POM", async () => {
+  // 1. Consumed from Shared Testing Library (${sharedTestingRelPath}/page-objects/NavigationBar)
+  await NavigationBar.goToLogin();
+
+  // 2. Consumed from Shared Testing Library (${sharedTestingRelPath}/steps/loginAsAdmin)
+  await Step.loginAsAdmin();
+
+  // 3. Consumed from Local Feature POM (page-objects/LoginPage)
+  await LoginPage.flashAlert.shouldBeVisible();
+  await LoginPage.flashAlert.shouldContainText("Welcome");
+
+  // 4. Consumed from Shared Testing Library Custom Action (${sharedTestingRelPath}/actions/dismissBanner)
+  await Spectra.dismissBanner();
+});
+\`\`\`
+
+---
+
+## 3. How to Run Tests
+
+You can execute tests either from the **Monorepo Root via Nx** or directly inside each **Feature Directory via CLI**:
+
+### Option A: From Root Monorepo via Nx (Recommended for CI & Team Workflows)
+
+\`\`\`bash
+# 1. Run E2E for a SPECIFIC feature module (e.g. auth)
+pnpm nx run auth-${e2eFolderName}:e2e
+
+# 2. Run E2E for a specific feature on ANDROID or IOS
+pnpm nx run auth-${e2eFolderName}:e2e --configuration=android
+pnpm nx run auth-${e2eFolderName}:e2e --configuration=ios
+
+# 3. Run E2E for a specific feature in HEADLESS browser mode
+pnpm nx run auth-${e2eFolderName}:e2e --configuration=headless
+
+# 4. Run ALL feature E2E suites across the entire monorepo in parallel
+pnpm nx run-many -t e2e
+
+# 5. Run only E2E tests for features modified in current Git branch / PR
+pnpm nx affected -t e2e
+\`\`\`
+
+### Option B: From Inside the Feature Directory (Direct CLI)
+
+\`\`\`bash
+# Navigate to the feature e2e folder
+cd ${featureE2eDirs.length > 0 ? path.relative(cwd, featureE2eDirs[0]).replace(/\\/g, '/') : `modules/auth/${e2eFolderName}`}
+
+# Run all specs in this feature
+pnpm spectra run
+
+# Run a specific test case file
+pnpm spectra run specs/Auth/TC-AUTH-01/web.test.ts
+
+# Target Android device or emulator
+pnpm spectra run --target android
+
+# Run in headed / interactive browser mode
+pnpm spectra run --no-headless
+\`\`\`
+
+---
+
+## 4. Type Checking & Validation
+
+\`\`\`bash
+# Type check all E2E projects via Nx
+pnpm nx run-many -t type-check
+
+# Or standard TypeScript project references build from root
+pnpm type-check
+# or: npx tsc -b
+\`\`\`
 `;
         fs.writeFileSync(path.join(cwd, 'ARCHITECTURE.md'), archDocContent, 'utf-8');
         // 8. Ensure root .gitignore ignores .testspectra/ and *.tsbuildinfo
@@ -741,32 +742,32 @@ pnpm type-check
     TypeGenerator.writeDeclarationFiles(cwd);
     ensureVsCodeExtensions(cwd);
     // Standalone Architecture Documentation
-    const standaloneArchDoc = `# TestSpectra Project Architecture
-
-This project is built with the TestSpectra testing framework.
-
-## Structure & File Map
-- \`./spectra.config.ts\`: Typed runner configuration.
-- \`./specs/\`: Layered test cases (\`specs/<Suite>/<CaseId>/\` with \`web.test.ts\`, \`android.test.ts\`, \`ios.test.ts\`).
-- \`./page-objects/\`: Page Object models per platform.
-- \`./steps/\`: Business flows accessible globally via \`Step.*\`.
-- \`./actions/\`: Atomic actions accessible globally via \`Spectra.*\`.
-- \`./fixtures/\`: JSON fixtures accessible globally via \`Fixture.*\`.
-- \`./global-hooks/\`: Global suite lifecycle hooks.
-- \`./.testspectra/\`: Auto-generated ambient typings and local runtime cache.
-
-## Execution
-\`\`\`bash
-# Run web test suite
-pnpm test
-
-# Run Android / iOS
-pnpm spectra run --target android
-pnpm spectra run --target ios
-
-# Type check
-pnpm type-check
-\`\`\`
+    const standaloneArchDoc = `# TestSpectra Project Architecture
+
+This project is built with the TestSpectra testing framework.
+
+## Structure & File Map
+- \`./spectra.config.ts\`: Typed runner configuration.
+- \`./specs/\`: Layered test cases (\`specs/<Suite>/<CaseId>/\` with \`web.test.ts\`, \`android.test.ts\`, \`ios.test.ts\`).
+- \`./page-objects/\`: Page Object models per platform.
+- \`./steps/\`: Business flows accessible globally via \`Step.*\`.
+- \`./actions/\`: Atomic actions accessible globally via \`Spectra.*\`.
+- \`./fixtures/\`: JSON fixtures accessible globally via \`Fixture.*\`.
+- \`./global-hooks/\`: Global suite lifecycle hooks.
+- \`./.testspectra/\`: Auto-generated ambient typings and local runtime cache.
+
+## Execution
+\`\`\`bash
+# Run web test suite
+pnpm test
+
+# Run Android / iOS
+pnpm spectra run --target android
+pnpm spectra run --target ios
+
+# Type check
+pnpm type-check
+\`\`\`
 `;
     fs.writeFileSync(path.join(cwd, 'ARCHITECTURE.md'), standaloneArchDoc, 'utf-8');
     // Safely update root README.md (do not overwrite existing content)

package/dist/commands/install.js

@@ -34,6 +34,7 @@ export async function installCommand(item, options = {}) {
                 cwd: workspaceRoot,
                 env: runnerEnv,
                 stdio: 'inherit',
+                windowsHide: true,
             });
         }
         else {
@@ -41,6 +42,7 @@ export async function installCommand(item, options = {}) {
                 cwd,
                 env: runnerEnv,
                 stdio: 'inherit',
+                windowsHide: true,
             });
         }
         child.on('close', (code) => {

package/dist/commands/license.js

@@ -14,6 +14,7 @@ export async function licenseCommand(action = 'status', key, options = {}) {
         const child = spawn(binPath, args, {
             stdio: 'inherit',
             env: process.env,
+            windowsHide: true,
         });
         child.on('close', (code) => {
             if (code === 0) {

package/dist/commands/test.js

@@ -15,7 +15,7 @@ import { runSystemChecks } from './doctor.js';
 async function resolveBrowserExecutable(cwd) {
     try {
         const { dependencies } = await runSystemChecks(cwd);
-        const chrome = dependencies.find((d) => d.category === 'web' && (d.name.includes('Chrome') || d.name.includes('Chromium')));
+        const chrome = dependencies.find((d) => d.category === 'web' && d.name.includes('Chrome'));
         return chrome?.installed && chrome.location ? chrome.location : null;
     }
     catch {
@@ -81,9 +81,11 @@ export async function testCommand(options = {}) {
         concurrency: concurrency !== undefined && !isNaN(concurrency) ? concurrency : undefined,
         browserExecutablePath,
         onLine: (line) => {
-            if (!line.startsWith('[TESTSPECTRA_'))
+            // Strip ANSI and whitespace since Vitest might prefix or colorize console logs
+            const cleanLine = line.replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g, '').trim();
+            if (!cleanLine.startsWith('[TESTSPECTRA_'))
                 return;
-            reporter.addLog({ timestamp: new Date().toLocaleTimeString(), level: 'INFO', message: line });
+            reporter.addLog({ timestamp: new Date().toLocaleTimeString(), level: 'INFO', message: cleanLine });
             if (!reporter.isInteractiveMode()) {
                 console.log(line);
             }

package/dist/generator/__tests__/tsconfig-isolation.test.js

@@ -41,7 +41,8 @@ describe('Platform TSConfigs & Type Isolation (docs/v2/cli/tsconfig-platform-iso
         expect(rootConfig.references).toEqual([{ path: './.testspectra/tsconfig.json' }]);
         // Verify dynamic master solution references all 5 platform solution tsconfigs in .testspectra/tsconfig/
         const solutionConfig = JSON.parse(fs.readFileSync(path.join(tmpDir, '.testspectra', 'tsconfig.json'), 'utf-8'));
-        expect(solutionConfig.compilerOptions.noEmit).toBe(true);
+        expect(solutionConfig.compilerOptions.composite).toBe(true);
+        expect(solutionConfig.compilerOptions.noEmit).toBeUndefined();
         expect(solutionConfig.references).toEqual([
             { path: './tsconfig/web.json' },
             { path: './tsconfig/mobile.json' },

package/dist/generator/__tests__/type-generator.test.js

@@ -383,4 +383,42 @@ async function verifyZeroImport() {
         expect(fs.existsSync(path.join(tmpDir, '.testspectra', 'types', 'web.d.ts'))).toBe(false);
         expect(fs.existsSync(path.join(tmpDir, '.testspectra', 'types', 'common.d.ts'))).toBe(false);
     });
+    it('nx monorepo: does NOT treat feature library as shared library and discovers nested e2e subproject', () => {
+        // 1. Shared library with testspectra:shared
+        const sharedDir = path.join(tmpDir, 'shared', 'testing');
+        fs.mkdirSync(path.join(sharedDir, 'page-objects', 'SharedNav'), { recursive: true });
+        fs.writeFileSync(path.join(sharedDir, 'project.json'), JSON.stringify({ name: 'shared-testing', projectType: 'library', tags: ['testspectra:shared'] }));
+        fs.writeFileSync(path.join(sharedDir, 'page-objects', 'SharedNav', 'common.ts'), 'export default class SharedNav {}');
+        // 2. Nx Feature library (projectType: "library", standard Nx tags, NO testspectra tags)
+        const featureLibDir = path.join(tmpDir, 'packages', 'features', 'auth');
+        fs.mkdirSync(featureLibDir, { recursive: true });
+        fs.writeFileSync(path.join(featureLibDir, 'project.json'), JSON.stringify({
+            name: '@tagsamurai/feature-auth',
+            projectType: 'library',
+            sourceRoot: 'packages/features/auth',
+            targets: {},
+            tags: ['type:feature', 'scope:feature-auth'],
+        }));
+        // 3. Nested E2E subproject inside feature library
+        const featureE2eDir = path.join(featureLibDir, 'e2e');
+        fs.mkdirSync(path.join(featureE2eDir, 'specs', 'AuthSuite', 'TC-001'), { recursive: true });
+        fs.writeFileSync(path.join(featureE2eDir, 'project.json'), JSON.stringify({
+            name: 'feature-auth-e2e',
+            projectType: 'application',
+            tags: ['testspectra:e2e', 'testspectra:scope:feature-auth'],
+        }));
+        fs.writeFileSync(path.join(featureE2eDir, 'specs', 'AuthSuite', 'TC-001', 'web.test.ts'), 'it("auth test", async () => {});');
+        const scopes = TypeGenerator.getEntityScopes(tmpDir);
+        expect(scopes).toHaveLength(2);
+        const sharedScope = scopes.find((s) => s.isShared);
+        expect(sharedScope).toBeDefined();
+        expect(sharedScope?.name).toBe('shared');
+        expect(sharedScope?.dir).toBe(path.resolve(sharedDir));
+        const featureScope = scopes.find((s) => !s.isShared);
+        expect(featureScope).toBeDefined();
+        expect(featureScope?.name).toBe('feature-auth');
+        expect(featureScope?.dir).toBe(path.resolve(featureE2eDir));
+        // Verify packages/features/auth is NOT in scopes
+        expect(scopes.some((s) => s.dir === path.resolve(featureLibDir))).toBe(false);
+    });
 });

package/dist/generator/tsconfig-generator.js

@@ -16,7 +16,7 @@ export class TsConfigGenerator {
                 moduleResolution: 'NodeNext',
                 skipLibCheck: true,
                 strict: true,
-                noEmit: true,
+                composite: true,
             },
             files: [],
             references: references || [

package/dist/generator/type-generator.d.ts

@@ -9,8 +9,11 @@ export interface EntityScope {
  * Discovers all feature directories and shared library directories.
  * Standard discovery hierarchy:
  * 1. Nx / Monorepo Project Descriptors (`project.json`):
- *    - projectType: "library" OR tags: ["type:shared", "type:library", "scope:shared"] => Shared Library Scope (isShared: true)
- *    - projectType: "application" OR tags: ["type:e2e", "type:app"] => Feature Scope (isShared: false)
+ *    - tags: ["testspectra:shared"] => Shared Library Scope (isShared: true)
+ *    - tags: ["testspectra:e2e"] or ["testspectra:scope:<name>"] => Feature Scope (isShared: false)
+ *    - Generic Nx libraries/apps without testspectra tags are not TestSpectra scopes and recursion
+ *      continues into their subdirectories so nested e2e projects (e.g. `packages/features/auth/e2e`)
+ *      are discovered.
  * 2. Explicit User Configuration (`tsconfig.spectra.shared.json`):
  *    - Custom include path for shared testing utilities
  * 3. Dynamic Workspace Filesystem Discovery (Fallback for non-Nx / custom layouts):