@testspectra/cli 1.1.8-rc.8 → 1.1.10

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')
+        .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-driver  Install Spectra Android Native Driver & WDIO Service
-  $ spectra install wdio            Install WebDriverIO core packages and matchers`)
+  $ 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,20 +87,31 @@ 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
@@ -147,11 +160,19 @@ 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')
         .option('-s, --spec <path>', 'Spec file path to execute')
         .option('-t, --target <target>', 'Target platform: web, android, ios, common', 'web')
+        .option('--host <name>', 'Target specific named host defined in spectra.config.ts (webConfig.hosts)')
+        .option('--base-url <url>', 'Override webConfig.baseUrl')
         .option('-d, --device <device>', 'Target device name or UDID')
         .option('--all-devices', 'Distribute test execution across all connected devices')
         .option('--multi-device', 'Distribute test execution across all connected devices (alias for --all-devices)')
@@ -170,20 +191,42 @@ 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 isJson = args.includes('--json');
+    const silentCommands = [
+        'doctor',
+        'install',
+        'upgrade',
+        'update',
+        'license',
+        'devices',
+        'lint',
+        'sync-types',
+        'refactor',
+        'watch',
+    ];
+    const isSilent = isJson || silentCommands.includes(program.args[0]);
+    const { checkUpdateInBackground, displayUpdateNotificationIfNeeded } = await import('./utils/update-notifier.js');
+    checkUpdateInBackground();
+    if (!isSilent) {
+        displayUpdateNotificationIfNeeded();
+    }
 }

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

package/dist/linter/discovery.d.ts

@@ -4,14 +4,14 @@ export interface WorkspaceAssets {
     fixtures: Set<string>;
 }
 /**
- * Scans a workspace directory for all `project.json` files that have both
- * "scope:shared" and "type:shared" tags, and returns their parent folder paths.
+ * Scans a workspace directory for all `project.json` files that have the
+ * "testspectra:shared" tag, and returns their parent folder paths.
  */
 export declare function findSharedLibraryRoots(workspaceDir: string): string[];
 /**
  * Resolves the root directory of a shared testing library if the file path is inside one.
  * Determines shared library status based on `project.json` containing
- * both "scope:shared" and "type:shared" tags in ancestor directories,
+ * the "testspectra:shared" tag in ancestor directories,
  * taking the parent folder of that `project.json` as the shared library root.
  */
 export declare function getSharedLibraryRoot(filePath: string, workspaceDir?: string): string | null;

package/dist/linter/discovery.js

@@ -1,8 +1,9 @@
 import fs from 'fs';
 import path from 'path';
+import { ConfigLoader } from '../config/loader.js';
 /**
- * Scans a workspace directory for all `project.json` files that have both
- * "scope:shared" and "type:shared" tags, and returns their parent folder paths.
+ * Scans a workspace directory for all `project.json` files that have the
+ * "testspectra:shared" tag, and returns their parent folder paths.
  */
 export function findSharedLibraryRoots(workspaceDir) {
     const sharedRoots = [];
@@ -23,7 +24,7 @@ export function findSharedLibraryRoots(workspaceDir) {
                         const raw = fs.readFileSync(path.join(dir, entry.name), 'utf-8');
                         const parsed = JSON.parse(raw);
                         const tags = Array.isArray(parsed.tags) ? parsed.tags : [];
-                        if (tags.includes('scope:shared') && tags.includes('type:shared')) {
+                        if (tags.includes('testspectra:shared')) {
                             sharedRoots.push(dir);
                         }
                     }
@@ -39,7 +40,7 @@ export function findSharedLibraryRoots(workspaceDir) {
 /**
  * Resolves the root directory of a shared testing library if the file path is inside one.
  * Determines shared library status based on `project.json` containing
- * both "scope:shared" and "type:shared" tags in ancestor directories,
+ * the "testspectra:shared" tag in ancestor directories,
  * taking the parent folder of that `project.json` as the shared library root.
  */
 export function getSharedLibraryRoot(filePath, workspaceDir) {
@@ -67,7 +68,7 @@ export function getSharedLibraryRoot(filePath, workspaceDir) {
                 const raw = fs.readFileSync(projectJsonPath, 'utf-8');
                 const projectConfig = JSON.parse(raw);
                 const tags = Array.isArray(projectConfig.tags) ? projectConfig.tags : [];
-                if (tags.includes('scope:shared') && tags.includes('type:shared')) {
+                if (tags.includes('testspectra:shared')) {
                     return current;
                 }
                 return null;
@@ -96,8 +97,7 @@ export function isInsideSharedLibrary(filePath, workspaceDir) {
 export function findProjectRoot(startDir) {
     let current = path.resolve(startDir);
     while (true) {
-        if (fs.existsSync(path.join(current, 'spectra.config.ts')) ||
-            fs.existsSync(path.join(current, 'spectra.config.js'))) {
+        if (ConfigLoader.CONFIG_FILE_NAMES.some((name) => fs.existsSync(path.join(current, name)))) {
             return current;
         }
         const parent = path.dirname(current);

package/dist/linter/schemas/spec.schema.d.ts

@@ -11,11 +11,11 @@ export declare const CoverageSchema: z.ZodObject<{
     web: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
     mobile: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
 }, "strip", z.ZodTypeAny, {
-    web?: "automated" | "manual" | "unsupported" | undefined;
     mobile?: "automated" | "manual" | "unsupported" | undefined;
-}, {
     web?: "automated" | "manual" | "unsupported" | undefined;
+}, {
     mobile?: "automated" | "manual" | "unsupported" | undefined;
+    web?: "automated" | "manual" | "unsupported" | undefined;
 }>;
 export declare const SpecFrontmatterSchema: z.ZodObject<{
     id: z.ZodString;
@@ -27,11 +27,11 @@ export declare const SpecFrontmatterSchema: z.ZodObject<{
         web: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
         mobile: z.ZodOptional<z.ZodEnum<["automated", "manual", "unsupported"]>>;
     }, "strip", z.ZodTypeAny, {
-        web?: "automated" | "manual" | "unsupported" | undefined;
         mobile?: "automated" | "manual" | "unsupported" | undefined;
-    }, {
         web?: "automated" | "manual" | "unsupported" | undefined;
+    }, {
         mobile?: "automated" | "manual" | "unsupported" | undefined;
+        web?: "automated" | "manual" | "unsupported" | undefined;
     }>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
@@ -41,8 +41,8 @@ export declare const SpecFrontmatterSchema: z.ZodObject<{
     priority: "Critical" | "High" | "Medium" | "Low";
     caseType: "Positive" | "Negative" | "Edge";
     coverage?: {
-        web?: "automated" | "manual" | "unsupported" | undefined;
         mobile?: "automated" | "manual" | "unsupported" | undefined;
+        web?: "automated" | "manual" | "unsupported" | undefined;
     } | undefined;
     tags?: string[] | undefined;
 }, {
@@ -52,8 +52,8 @@ export declare const SpecFrontmatterSchema: z.ZodObject<{
     priority: "Critical" | "High" | "Medium" | "Low";
     caseType: "Positive" | "Negative" | "Edge";
     coverage?: {
-        web?: "automated" | "manual" | "unsupported" | undefined;
         mobile?: "automated" | "manual" | "unsupported" | undefined;
+        web?: "automated" | "manual" | "unsupported" | undefined;
     } | undefined;
     tags?: string[] | undefined;
 }>;

package/dist/runner/bridge.d.ts

@@ -3,7 +3,7 @@ import { Reporter, TestRunResult } from './reporter.js';
 export interface RunOptions {
     baseDir: string;
     appDataPath: string;
-    platform: 'web' | 'android' | 'ios' | 'common' | 'mobile';
+    platform: 'web' | 'android' | 'ios' | 'common' | 'mobile' | 'component';
     suite?: string;
     testCases?: Array<{
         id: string;