@testspectra/cli 1.1.8-rc.3 → 1.1.8-rc.30

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/architecture-doc-generator.d.ts

@@ -0,0 +1,14 @@
+export interface ArchitectureDocResult {
+    mode: 'nx' | 'default';
+    path: string;
+    sharedTestingRelPath?: string;
+    featureCount?: number;
+}
+export declare function buildFeatureModulesSection(cwd: string, featureE2eDirs: string[]): string;
+/**
+ * (Re)generates `ARCHITECTURE.md` from the current on-disk workspace state — no prompts, no other
+ * scaffolding side effects. Nx/monorepo mode is auto-detected via `TsConfigGenerator.getEntityScopes`
+ * (the same shared/feature discovery `sync-types` already relies on), so this stays accurate after
+ * features are added/removed/renamed without needing to re-run `spectra init`.
+ */
+export declare function generateArchitectureDoc(cwd: string): ArchitectureDocResult;

package/dist/generator/architecture-doc-generator.js

@@ -0,0 +1,80 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { TsConfigGenerator } from './tsconfig-generator.js';
+function resolveDocsTemplateDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const candidates = [
+        path.resolve(__dirname, '../templates/docs'),
+        path.resolve(__dirname, '../../templates/docs'),
+        path.resolve(__dirname, '../../../templates/docs'),
+    ];
+    return candidates.find((d) => fs.existsSync(d)) ?? candidates[candidates.length - 1];
+}
+function renderArchitectureDoc(templatePath, replacements) {
+    let content = fs.readFileSync(templatePath, 'utf-8');
+    for (const [token, value] of Object.entries(replacements)) {
+        content = content.replaceAll(token, value);
+    }
+    return content;
+}
+/** Reads a feature e2e dir's project.json for its Nx project name, falling back to `<parentDirName>-<e2eDirName>`. */
+function resolveNxProjectName(featureDir) {
+    const parentName = path.basename(path.dirname(featureDir));
+    const fallback = `${parentName}-${path.basename(featureDir)}`;
+    const projJsonPath = path.join(featureDir, 'project.json');
+    if (!fs.existsSync(projJsonPath))
+        return fallback;
+    try {
+        const pObj = JSON.parse(fs.readFileSync(projJsonPath, 'utf-8'));
+        return typeof pObj.name === 'string' && pObj.name ? pObj.name : fallback;
+    }
+    catch {
+        return fallback;
+    }
+}
+export function buildFeatureModulesSection(cwd, featureE2eDirs) {
+    return featureE2eDirs
+        .map((d) => {
+        const rel = path.relative(cwd, d).replace(/\\/g, '/');
+        const featureName = path.basename(path.dirname(d));
+        const e2eName = resolveNxProjectName(d);
+        return `- \`./${rel}\` (**${featureName}**, 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');
+}
+/**
+ * (Re)generates `ARCHITECTURE.md` from the current on-disk workspace state — no prompts, no other
+ * scaffolding side effects. Nx/monorepo mode is auto-detected via `TsConfigGenerator.getEntityScopes`
+ * (the same shared/feature discovery `sync-types` already relies on), so this stays accurate after
+ * features are added/removed/renamed without needing to re-run `spectra init`.
+ */
+export function generateArchitectureDoc(cwd) {
+    const docsTemplateDir = resolveDocsTemplateDir();
+    const destPath = path.join(cwd, 'ARCHITECTURE.md');
+    const scopes = TsConfigGenerator.getEntityScopes(cwd);
+    const isNxMode = scopes.length > 0 || fs.existsSync(path.join(cwd, 'nx.json'));
+    if (!isNxMode) {
+        fs.copyFileSync(path.join(docsTemplateDir, 'ARCHITECTURE.default.md'), destPath);
+        return { mode: 'default', path: destPath };
+    }
+    const sharedScope = scopes.find((s) => s.isShared);
+    const featureE2eDirs = scopes.filter((s) => !s.isShared).map((s) => s.dir);
+    const sharedTestingRelPath = sharedScope ? path.relative(cwd, sharedScope.dir).replace(/\\/g, '/') : 'shared/testing';
+    const e2eFolderName = featureE2eDirs.length > 0 ? path.basename(featureE2eDirs[0]) : 'e2e';
+    const content = renderArchitectureDoc(path.join(docsTemplateDir, 'ARCHITECTURE.nx.md'), {
+        __SHARED_TESTING_REL_PATH__: sharedTestingRelPath,
+        __FEATURE_COUNT__: String(featureE2eDirs.length),
+        __FEATURE_MODULES_SECTION__: buildFeatureModulesSection(cwd, featureE2eDirs),
+        __E2E_FOLDER_NAME__: e2eFolderName,
+        __SAMPLE_FEATURE_E2E_PATH__: featureE2eDirs.length > 0
+            ? path.relative(cwd, featureE2eDirs[0]).replace(/\\/g, '/')
+            : `modules/auth/${e2eFolderName}`,
+    });
+    fs.writeFileSync(destPath, content, 'utf-8');
+    return { mode: 'nx', path: destPath, sharedTestingRelPath, featureCount: featureE2eDirs.length };
+}

package/dist/generator/index.d.ts

@@ -1,2 +1,3 @@
 export * from './type-generator.js';
 export * from './tsconfig-generator.js';
+export * from './architecture-doc-generator.js';

package/dist/generator/index.js

@@ -1,2 +1,3 @@
 export * from './type-generator.js';
 export * from './tsconfig-generator.js';
+export * from './architecture-doc-generator.js';

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):

package/dist/generator/type-generator.js

@@ -13,8 +13,11 @@ export const PLATFORM_HIERARCHY = {
  * 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):
@@ -48,16 +51,9 @@ export function discoverEntityScopes(cwd) {
         if (fs.existsSync(projectJsonPath)) {
             try {
                 const pObj = JSON.parse(fs.readFileSync(projectJsonPath, 'utf-8'));
-                const projectType = pObj.projectType;
                 const tags = Array.isArray(pObj.tags) ? pObj.tags : [];
-                const isSharedLib = projectType === 'library' ||
-                    tags.includes('type:shared') ||
-                    tags.includes('type:library') ||
-                    tags.includes('scope:shared');
-                const isE2eApp = projectType === 'application' ||
-                    tags.includes('type:e2e') ||
-                    tags.includes('type:app') ||
-                    tags.some((t) => t.startsWith('scope:') && t !== 'scope:shared');
+                const isSharedLib = tags.includes('testspectra:shared');
+                const isE2eApp = tags.includes('testspectra:e2e') || tags.some((t) => t.startsWith('testspectra:scope:'));
                 if (isSharedLib) {
                     if (!scopes.some((s) => s.dir === dir)) {
                         scopes.push({ name: 'shared', dir, isShared: true });
@@ -65,9 +61,9 @@ export function discoverEntityScopes(cwd) {
                     return; // Do not recurse into subdirectories of an identified project
                 }
                 else if (isE2eApp) {
-                    // Extract scope name from tags (e.g. "scope:matchers" => "matchers") or project name
-                    const scopeTag = tags.find((t) => t.startsWith('scope:') && t !== 'scope:shared');
-                    let featureName = scopeTag ? scopeTag.replace('scope:', '') : '';
+                    // Extract scope name from tags (e.g. "testspectra:scope:matchers" => "matchers") or project name
+                    const scopeTag = tags.find((t) => t.startsWith('testspectra:scope:'));
+                    let featureName = scopeTag ? scopeTag.replace('testspectra:scope:', '') : '';
                     if (!featureName && pObj.name) {
                         featureName = pObj.name.replace(/-e2e$/, '').replace(/^e2e-/, '');
                     }
@@ -329,6 +325,9 @@ export class TypeGenerator {
             const hierarchy = PLATFORM_HIERARCHY[platform];
             let content = `// Auto-generated ambient declarations for TestSpectra [${platform.toUpperCase()}]\n`;
             content += `// Managed automatically by TestSpectra Language Service Plugin.\n\n`;
+            content += `/// <reference types="@testspectra/matchers" />\n`;
+            content += `/// <reference path="./fixtures.d.ts" />\n`;
+            content += `/// <reference path="${envRefPath}" />\n\n`;
             // TestSpectra's Rust-native orchestrator worker (core/orchestrator/src/worker/bdd_runner.ts)
             // registers its own `it`/`test`/lifecycle-hook globals directly — there is no WDIO or Mocha
             // runtime involved at all (not just for component testing; this is true across every
@@ -346,9 +345,7 @@ export class TypeGenerator {
                 // — the Rust orchestrator's BDD runtime has no `expect` global at all.
                 content += `declare const expect: import('@testspectra/react').ExpectStatic;\n`;
             }
-            content += `/// <reference types="@testspectra/matchers" />\n`;
-            content += `/// <reference path="./fixtures.d.ts" />\n`;
-            content += `/// <reference path="${envRefPath}" />\n\n`;
+            content += `\n`;
             // 1. Page Objects Global Declarations
             const declaredPOMs = new Set();
             for (const poDir of poDirs) {

package/dist/index.js

@@ -7,12 +7,13 @@ import { initCommand } from './commands/init.js';
 import { installCommand } from './commands/install.js';
 import { runCommand } from './commands/run.js';
 import { testCommand } from './commands/test.js';
-import { updateCommand } from './commands/update.js';
+import { upgradeCommand } from './commands/upgrade.js';
 import { watchCommand } from './commands/watch.js';
 import { syncTypesCommand } from './commands/sync-types.js';
 import { refactorCommand } from './commands/refactor.js';
 import { lintCommand } from './commands/lint.js';
 import { licenseCommand } from './commands/license.js';
+import { docsUpdateCommand } from './commands/docs.js';
 import { skillsInitCommand, skillsListCommand, skillsAddCommand, skillsUpdateCommand, skillsRemoveCommand, } from './commands/skills.js';
 export * from './config/schema.js';
 export * from './config/loader.js';
@@ -24,10 +25,10 @@ export * from './types/generator.js';
 export * from '@testspectra/matchers';
 export function createCliProgram() {
     const program = new Command();
-    program.name('spectra').description('TestSpectra Zero-Config Cross-Platform Test Runner CLI').version('1.0.0');
+    program.name('spectra').description('TestSpectra Cross-Platform Test Runner CLI').version('1.0.0');
     program
         .command('init')
-        .description('Initialize testspectra.config.json and project directories')
+        .description('Initialize spectra.config.ts and project directories')
         .option('-t, --template <template>', 'Project template: default, nx, react-component')
         .option('-f, --force', 'Overwrite existing configuration if present')
         .action(initCommand);
@@ -40,15 +41,16 @@ export function createCliProgram() {
     program
         .command('install [dependency]')
         .description('Install missing testing dependencies, browser drivers, and workspace packages')
-        .option('-f, --force', 'Force re-installation of dependencies')
-        .addHelpText('after', `
-Examples:
-  $ spectra install                 Install all missing required dependencies automatically
-  $ spectra install chrome          Install Google Chrome for Testing & matching Chromedriver
-  $ spectra install adb             Install Google Android SDK Platform Tools (ADB)
-  $ spectra install bun             Install Bun runtime
-  $ spectra install android-driver  Install Spectra Android Native Driver & WDIO Service
-  $ spectra install wdio            Install WebDriverIO core packages and matchers`)
+        .option('-f, --force', 'Remove existing artifacts and perform a clean reinstall of the dependency')
+        .addHelpText('after', `
+Examples:
+  $ spectra install                 Install all missing required dependencies automatically
+  $ spectra install chrome          Install Google Chrome for Testing & matching Chromedriver
+  $ spectra install adb             Install Google Android SDK Platform Tools (ADB)
+  $ spectra install bun             Install Bun runtime
+  $ spectra install android-agent   Install Spectra Android Native Agent (spectra-agent.jar)
+  $ spectra install android-agent -f  Clean reinstall Spectra Android Native Agent
+  $ spectra install packages        Install TestSpectra CLI, Matchers & Android Agent packages`)
         .action(installCommand);
     program
         .command('demo')
@@ -85,30 +87,41 @@ Examples:
         .action(lintCommand);
     program
         .command('doctor')
-        .description('Verify local environment prerequisites (ADB, Spectra Android Driver, Chrome, Bun)')
+        .description('Verify local environment prerequisites (Bun, Git, ADB, Chrome, Spectra Android Agent, workspace packages)')
         .option('-v, --verbose', 'Show full installation paths for all detected runtimes and packages')
+        .option('--scope <category>', 'Only check one category: core, web, mobile (default: all)')
+        .option('--only <keys>', 'Only check specific dependencies (comma-separated): bun, git, cli, chrome, matchers, adb, agent')
         .option('--fix', 'Attempt automatic fix / download of missing tools')
         .option('--json', 'Output diagnostic results as JSON')
         .action(doctorCommand);
     program
-        .command('update')
-        .description('Update @testspectra/cli and @testspectra/matchers to the latest version from npm')
+        .command('upgrade [packages...]')
+        .alias('update')
+        .description('Upgrade TestSpectra ecosystem packages and system drivers to the latest versions')
         .option('--check', 'Only check for available updates without installing')
-        .action(updateCommand);
+        .option('--packages-only', 'Only upgrade NPM packages in package.json')
+        .option('--drivers-only', 'Only upgrade system binaries and drivers (ADB, Agent, Chrome)')
+        .option('--json', 'Output the update check (packages + drivers) as JSON (implies --check, no changes applied)')
+        .addHelpText('after', `
+Examples:
+  $ spectra upgrade                                    Upgrade all packages and system drivers
+  $ spectra upgrade @testspectra/cli                   Upgrade only the CLI package
+  $ spectra upgrade @testspectra/cli @testspectra/matchers  Upgrade specific packages
+  $ spectra upgrade --check                            Check what is outdated (packages + drivers)`)
+        .action(upgradeCommand);
     program
         .command('devices')
-        .description('List connected Android/iOS devices and local browsers')
-        .option('-t, --target <target>', 'Filter scope: android, ios, web, all', 'all')
+        .description('List connected Android devices (ADB)')
         .option('--json', 'Output results as JSON')
         .action(devicesCommand);
     program
         .command('license [action] [key]')
         .description('Manage TestSpectra commercial license (activate, status, remove)')
         .option('--json', 'Output license details as JSON')
-        .addHelpText('after', `
-Examples:
-  $ spectra license activate <KEY>   Activate license key and auto-configure private driver registry
-  $ spectra license status           Display active license organization, plan, and expiration
+        .addHelpText('after', `
+Examples:
+  $ spectra license activate <KEY>   Activate license key and auto-configure private driver registry
+  $ spectra license status           Display active license organization, plan, and expiration
   $ spectra license remove           Remove locally activated license credentials`)
         .action(licenseCommand);
     const skills = program
@@ -147,6 +160,12 @@ Examples:
         .option('-w, --cwd <dir>', 'Custom workspace directory')
         .option('-a, --agent <ids>', 'One-off override: comma-separated agent(s) to target, bypassing the saved "init" selection (claude, opencode, kilo, agents, gemini)')
         .action(skillsRemoveCommand);
+    const docs = program.command('docs').description('Manage generated TestSpectra workspace documentation');
+    docs
+        .command('update')
+        .description('Regenerate ARCHITECTURE.md from the current workspace state, without re-running init')
+        .option('-w, --cwd <dir>', 'Custom workspace directory')
+        .action(docsUpdateCommand);
     program
         .command('run [paths...]')
         .description('Execute test suite or individual test case')
@@ -170,20 +189,29 @@ Examples:
         .action(runCommand);
     program
         .command('test')
-        .description('Run React component tests via @testspectra/react (bundled Vitest browser mode)')
+        .description('Run React component tests via @testspectra/react')
+        .option('-r, --runner <engine>', 'Component test runner engine: spectra (default, native CDP) or vitest (Playwright browser mode)', 'spectra')
         .option('-w, --cwd <dir>', 'Custom workspace directory')
         .option('-s, --spec <path>', 'Spec file path (or substring filter) to execute')
         .option('--headless', 'Run in headless mode (default)')
         .option('--no-headless', 'Run in headed mode')
         .option('--headed', 'Run the browser in visible GUI mode (alias for --no-headless)')
-        .option('--step-delay <ms>', 'Delay after each action/assertion in milliseconds (slow motion, for observing DOM transitions in --headed mode)')
+        .option('-d, --step-delay <ms>', 'Delay after each action/assertion in milliseconds (slow motion, for observing DOM transitions in --headed mode)')
         .option('--delay <ms>', 'Alias for --step-delay')
-        .option('-c, --concurrency <number>', 'Run spec files sequentially (1) or in parallel (>1, default). Browser mode has no numeric N-worker sizing like `spectra run`.')
-        .option('-o, --output <path>', 'Write a Vitest JSON test report to this path')
+        .option('-c, --concurrency <number>', 'Run spec files sequentially (1) or in parallel (>1, default).')
+        .option('-o, --output <path>', 'Write a JSON test report to this path')
         .action(testCommand);
     return program;
 }
 export async function runCli(args = process.argv) {
     const program = createCliProgram();
     await program.parseAsync(args);
+    // Commands whose stdout must stay machine-readable or is purely diagnostic never emit the
+    // interactive "update available" banner.
+    const silentCommands = ['doctor', 'install', 'upgrade', 'update'];
+    if (silentCommands.includes(program.args[0]))
+        return;
+    const { checkUpdateInBackground, displayUpdateNotificationIfNeeded } = await import('./utils/update-notifier.js');
+    checkUpdateInBackground();
+    displayUpdateNotificationIfNeeded();
 }

package/dist/linter/__tests__/component-test-imports.test.js

@@ -14,20 +14,20 @@ const __dirname = path.dirname(__filename);
  */
 describe('Component Test (.tsx) Import Exception', () => {
     const tempDir = path.join(__dirname, '__temp_tsx_imports__');
-    const specFrontmatter = `---
-id: TC-0200
-title: Sample component test
-priority: High
-caseType: Positive
-status: automated
-coverage:
-  web: automated
----
-
-# Sample component test
-
-## Test Steps
-1. Mount the component and assert it is visible.
+    const specFrontmatter = `---
+id: TC-0200
+title: Sample component test
+priority: High
+caseType: Positive
+status: automated
+coverage:
+  web: automated
+---
+
+# Sample component test
+
+## Test Steps
+1. Mount the component and assert it is visible.
 `;
     beforeEach(() => {
         fs.mkdirSync(tempDir, { recursive: true });
@@ -39,23 +39,23 @@ coverage:
         }
     });
     it('does not flag no-manual-import for ordinary component/library imports in .test.tsx', () => {
-        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import { Button } from '../../src/components/Button/Button.js';
-import React from 'react';
-
-it('Sample component test', async () => {
-  await Spectra.mount(<Button label="Save" />);
-});
+        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import { Button } from '../../src/components/Button/Button.js';
+import React from 'react';
+
+it('Sample component test', async () => {
+  await Spectra.mount(<Button label="Save" />);
+});
 `);
         const { diagnostics } = SpecLinter.validateSpecFile(path.join(tempDir, 'spec.md'));
         const importErrors = diagnostics.filter((d) => d.code === 'testspectra/no-manual-import');
         expect(importErrors).toHaveLength(0);
     });
     it('still flags no-manual-import when a .test.tsx import resolves into page-objects/', () => {
-        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import ButtonComponent from '../../page-objects/ButtonComponent/web.js';
-
-it('Sample component test', async () => {
-  await ButtonComponent.root.shouldBeVisible();
-});
+        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import ButtonComponent from '../../page-objects/ButtonComponent/web.js';
+
+it('Sample component test', async () => {
+  await ButtonComponent.root.shouldBeVisible();
+});
 `);
         const { diagnostics } = SpecLinter.validateSpecFile(path.join(tempDir, 'spec.md'));
         const importErrors = diagnostics.filter((d) => d.code === 'testspectra/no-manual-import');
@@ -63,50 +63,50 @@ it('Sample component test', async () => {
         expect(importErrors[0].message).toContain('page-objects');
     });
     it('still flags no-manual-import when a .test.tsx import resolves into support/steps/', () => {
-        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import verifyButtonState from '../../support/steps/verifyButtonState/web.step.js';
-
-it('Sample component test', async () => {
-  await verifyButtonState('Save', true);
-});
+        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import verifyButtonState from '../../support/steps/verifyButtonState/web.step.js';
+
+it('Sample component test', async () => {
+  await verifyButtonState('Save', true);
+});
 `);
         const { diagnostics } = SpecLinter.validateSpecFile(path.join(tempDir, 'spec.md'));
         const importErrors = diagnostics.filter((d) => d.code === 'testspectra/no-manual-import');
         expect(importErrors).toHaveLength(1);
     });
     it('still flags no-manual-import when a .test.tsx import resolves into fixtures/', () => {
-        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import users from '../../fixtures/users.json';
-
-it('Sample component test', async () => {
-  expect(users).toBeDefined();
-});
+        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import users from '../../fixtures/users.json';
+
+it('Sample component test', async () => {
+  expect(users).toBeDefined();
+});
 `);
         const { diagnostics } = SpecLinter.validateSpecFile(path.join(tempDir, 'spec.md'));
         const importErrors = diagnostics.filter((d) => d.code === 'testspectra/no-manual-import');
         expect(importErrors).toHaveLength(1);
     });
     it('still enforces single-it-required and no-describe-block in .test.tsx files', () => {
-        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import { Button } from '../../src/components/Button/Button.js';
-
-describe('Button', () => {
-  it('Sample component test', async () => {
-    await Spectra.mount(<Button label="Save" />);
-  });
-
-  it('Another test', async () => {
-    await Spectra.mount(<Button label="Cancel" />);
-  });
-});
+        fs.writeFileSync(path.join(tempDir, 'web.test.tsx'), `import { Button } from '../../src/components/Button/Button.js';
+
+describe('Button', () => {
+  it('Sample component test', async () => {
+    await Spectra.mount(<Button label="Save" />);
+  });
+
+  it('Another test', async () => {
+    await Spectra.mount(<Button label="Cancel" />);
+  });
+});
 `);
         const { diagnostics } = SpecLinter.validateSpecFile(path.join(tempDir, 'spec.md'));
         expect(diagnostics.some((d) => d.code === 'testspectra/no-describe-block')).toBe(true);
         expect(diagnostics.some((d) => d.code === 'testspectra/single-it-required')).toBe(true);
     });
     it('still forbids all imports (unchanged behavior) in plain .test.ts E2E specs', () => {
-        fs.writeFileSync(path.join(tempDir, 'web.test.ts'), `import { LoginPage } from '../../page-objects/LoginPage/web.js';
-
-it('Sample component test', async () => {
-  await LoginPage.submitButton.click();
-});
+        fs.writeFileSync(path.join(tempDir, 'web.test.ts'), `import { LoginPage } from '../../page-objects/LoginPage/web.js';
+
+it('Sample component test', async () => {
+  await LoginPage.submitButton.click();
+});
 `);
         const { diagnostics } = SpecLinter.validateSpecFile(path.join(tempDir, 'spec.md'));
         const importErrors = diagnostics.filter((d) => d.code === 'testspectra/no-manual-import');