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

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/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,82 @@
+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

@@ -13,6 +13,7 @@ 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';
@@ -41,13 +42,13 @@ export function createCliProgram() {
         .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
+        .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`)
         .action(installCommand);
     program
@@ -105,10 +106,10 @@ Examples:
         .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 +148,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')

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');

package/dist/linter/__tests__/shared-lib-boundary.test.js

@@ -17,16 +17,16 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
         }
     });
     describe('findSharedLibraryRoots()', () => {
-        it('discovers parent folders of project.json files containing both scope:shared and type:shared', () => {
+        it('discovers parent folders of project.json files containing testspectra:shared', () => {
             const sharedDir1 = path.join(tempDir, 'shared', 'testing');
             const sharedDir2 = path.join(tempDir, 'libs', 'common-helpers');
             const nonSharedDir = path.join(tempDir, 'packages', 'playground', 'e2e');
             fs.mkdirSync(sharedDir1, { recursive: true });
             fs.mkdirSync(sharedDir2, { recursive: true });
             fs.mkdirSync(nonSharedDir, { recursive: true });
-            fs.writeFileSync(path.join(sharedDir1, 'project.json'), JSON.stringify({ name: 'shared-testing', tags: ['scope:shared', 'type:shared'] }));
-            fs.writeFileSync(path.join(sharedDir2, 'project.json'), JSON.stringify({ name: 'common-helpers', tags: ['scope:shared', 'type:shared'] }));
-            fs.writeFileSync(path.join(nonSharedDir, 'project.json'), JSON.stringify({ name: 'playground-e2e', tags: ['scope:playground', 'type:e2e'] }));
+            fs.writeFileSync(path.join(sharedDir1, 'project.json'), JSON.stringify({ name: 'shared-testing', tags: ['testspectra:shared'] }));
+            fs.writeFileSync(path.join(sharedDir2, 'project.json'), JSON.stringify({ name: 'common-helpers', tags: ['testspectra:shared'] }));
+            fs.writeFileSync(path.join(nonSharedDir, 'project.json'), JSON.stringify({ name: 'playground-e2e', tags: ['testspectra:e2e', 'testspectra:scope:playground'] }));
             const roots = findSharedLibraryRoots(tempDir);
             expect(roots).toHaveLength(2);
             expect(roots).toContain(sharedDir1);
@@ -35,12 +35,12 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
         });
     });
     describe('isInsideSharedLibrary()', () => {
-        it('returns true for files inside a project tagged with scope:shared or type:shared in project.json', () => {
+        it('returns true for files inside a project tagged with testspectra:shared in project.json', () => {
             const sharedDir = path.join(tempDir, 'shared', 'testing');
             fs.mkdirSync(sharedDir, { recursive: true });
             fs.writeFileSync(path.join(sharedDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const stepFile = path.join(sharedDir, 'support', 'steps', 'web.step.ts');
             const specFile = path.join(sharedDir, 'specs', 'TC-001', 'spec.md');
@@ -55,7 +55,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(customLibDir, { recursive: true });
             fs.writeFileSync(path.join(customLibDir, 'project.json'), JSON.stringify({
                 name: 'custom-common-lib',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const actionFile = path.join(customLibDir, 'support', 'actions', 'click.action.ts');
             expect(isInsideSharedLibrary(actionFile)).toBe(true);
@@ -65,7 +65,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(sharedAppDir, { recursive: true });
             fs.writeFileSync(path.join(sharedAppDir, 'project.json'), JSON.stringify({
                 name: 'shared-app',
-                tags: ['scope:shared-app', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:shared-app'],
             }));
             const specFile = path.join(sharedAppDir, 'specs', 'TC-001', 'spec.md');
             expect(isInsideSharedLibrary(specFile)).toBe(false);
@@ -75,7 +75,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(featureDir, { recursive: true });
             fs.writeFileSync(path.join(featureDir, 'project.json'), JSON.stringify({
                 name: 'playground-e2e',
-                tags: ['scope:playground', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:playground'],
             }));
             const specFile = path.join(featureDir, 'specs', 'TC-001', 'spec.md');
             expect(isInsideSharedLibrary(specFile)).toBe(false);
@@ -91,7 +91,7 @@ describe('Shared Library Boundary (testspectra/no-specs-in-shared-lib)', () => {
             fs.mkdirSync(sharedLibDir, { recursive: true });
             fs.writeFileSync(path.join(sharedLibDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const sharedSpecDir = path.join(sharedLibDir, 'specs', 'TC-error');
             fs.mkdirSync(sharedSpecDir, { recursive: true });
@@ -119,7 +119,7 @@ status: draft
             fs.mkdirSync(sharedLibDir, { recursive: true });
             fs.writeFileSync(path.join(sharedLibDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const sharedSuiteDir = path.join(sharedLibDir, 'support');
             fs.mkdirSync(sharedSuiteDir, { recursive: true });
@@ -141,7 +141,7 @@ status: active
             fs.mkdirSync(customLibDir, { recursive: true });
             fs.writeFileSync(path.join(customLibDir, 'project.json'), JSON.stringify({
                 name: 'my-testing-utils',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const specDir = path.join(customLibDir, 'specs', 'TC-custom');
             fs.mkdirSync(specDir, { recursive: true });
@@ -169,7 +169,7 @@ status: draft
             fs.mkdirSync(featureDir, { recursive: true });
             fs.writeFileSync(path.join(featureDir, 'project.json'), JSON.stringify({
                 name: 'playground-e2e',
-                tags: ['scope:playground', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:playground'],
             }));
             const featureSpecDir = path.join(featureDir, 'specs', 'TC-001');
             fs.mkdirSync(featureSpecDir, { recursive: true });
@@ -195,7 +195,7 @@ status: draft
             fs.mkdirSync(sharedE2eDir, { recursive: true });
             fs.writeFileSync(path.join(sharedE2eDir, 'project.json'), JSON.stringify({
                 name: 'shared-feature-e2e',
-                tags: ['scope:shared-feature', 'type:e2e'],
+                tags: ['testspectra:e2e', 'testspectra:scope:shared-feature'],
             }));
             const specDir = path.join(sharedE2eDir, 'specs', 'TC-001');
             fs.mkdirSync(specDir, { recursive: true });
@@ -241,7 +241,7 @@ status: draft
             fs.mkdirSync(sharedLibDir, { recursive: true });
             fs.writeFileSync(path.join(sharedLibDir, 'project.json'), JSON.stringify({
                 name: 'shared-testing',
-                tags: ['scope:shared', 'type:shared'],
+                tags: ['testspectra:shared'],
             }));
             const sharedDir1 = path.join(sharedLibDir, 'specs', 'TC-001');
             const sharedDir2 = path.join(sharedLibDir, 'specs', 'TC-002');