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

package/dist/linter/__tests__/spec-schema.test.js

@@ -19,23 +19,23 @@ describe('Spec Schema Linter (Stage 1 & Stage 2)', () => {
     describe('Spec File Validation (spec.md)', () => {
         it('passes validation for a well-formed spec.md with frontmatter, H1 title, and Test Steps', () => {
             const specPath = path.join(tempDir, 'spec.md');
-            fs.writeFileSync(specPath, `---
-id: TC-0001-valid
-title: Verify user authentication
-priority: High
-caseType: Positive
-status: ready-for-automation
-coverage:
-  web: automated
-  mobile: automated
-tags:
-  - auth
----
-
-# Verify user authentication
-
-## Test Steps
-1. Open login page and submit credentials
+            fs.writeFileSync(specPath, `---
+id: TC-0001-valid
+title: Verify user authentication
+priority: High
+caseType: Positive
+status: ready-for-automation
+coverage:
+  web: automated
+  mobile: automated
+tags:
+  - auth
+---
+
+# Verify user authentication
+
+## Test Steps
+1. Open login page and submit credentials
 `);
             const result = SpecLinter.validateSpecFile(specPath);
             expect(result.diagnostics).toHaveLength(0);
@@ -43,16 +43,16 @@ tags:
         });
         it('reports testspectra/missing-frontmatter when required frontmatter attributes are missing', () => {
             const specPath = path.join(tempDir, 'spec.md');
-            fs.writeFileSync(specPath, `---
-id: TC-0002-missing-attrs
-title: Missing priority and caseType
-status: draft
----
-
-# Missing priority and caseType
-
-## Test Steps
-1. Step one
+            fs.writeFileSync(specPath, `---
+id: TC-0002-missing-attrs
+title: Missing priority and caseType
+status: draft
+---
+
+# Missing priority and caseType
+
+## Test Steps
+1. Step one
 `);
             const result = SpecLinter.validateSpecFile(specPath);
             const codes = result.diagnostics.map((d) => d.code);
@@ -69,17 +69,17 @@ status: draft
         it('differentiates missing status (testspectra/missing-frontmatter) from invalid status value (testspectra/invalid-frontmatter-enum)', () => {
             // 1. Missing status -> testspectra/missing-frontmatter
             const missingSpecPath = path.join(tempDir, 'missing-status.spec.md');
-            fs.writeFileSync(missingSpecPath, `---
-id: TC-0002-missing-status
-title: Missing Status Spec
-priority: High
-caseType: Positive
----
-
-# Missing Status Spec
-
-## Test Steps
-1. Step one
+            fs.writeFileSync(missingSpecPath, `---
+id: TC-0002-missing-status
+title: Missing Status Spec
+priority: High
+caseType: Positive
+---
+
+# Missing Status Spec
+
+## Test Steps
+1. Step one
 `);
             const missingResult = SpecLinter.validateSpecFile(missingSpecPath);
             const missingStatusDiag = missingResult.diagnostics.find((d) => d.code === 'testspectra/missing-frontmatter' &&
@@ -89,18 +89,18 @@ caseType: Positive
             expect(missingResult.diagnostics.some((d) => d.code === 'testspectra/invalid-frontmatter-enum')).toBe(false);
             // 2. Invalid status -> testspectra/invalid-frontmatter-enum
             const invalidSpecPath = path.join(tempDir, 'invalid-status.spec.md');
-            fs.writeFileSync(invalidSpecPath, `---
-id: TC-0002-invalid-status
-title: Invalid Status Spec
-priority: High
-caseType: Positive
-status: not-a-valid-status
----
-
-# Invalid Status Spec
-
-## Test Steps
-1. Step one
+            fs.writeFileSync(invalidSpecPath, `---
+id: TC-0002-invalid-status
+title: Invalid Status Spec
+priority: High
+caseType: Positive
+status: not-a-valid-status
+---
+
+# Invalid Status Spec
+
+## Test Steps
+1. Step one
 `);
             const invalidResult = SpecLinter.validateSpecFile(invalidSpecPath);
             const invalidStatusDiag = invalidResult.diagnostics.find((d) => d.code === 'testspectra/invalid-frontmatter-enum' &&
@@ -111,18 +111,18 @@ status: not-a-valid-status
         });
         it('reports testspectra/invalid-frontmatter-enum when enum attributes have invalid values', () => {
             const specPath = path.join(tempDir, 'spec.md');
-            fs.writeFileSync(specPath, `---
-id: TC-0003-invalid-enum
-title: Invalid priority value
-priority: SuperHigh
-caseType: MaybePositive
-status: unknown-status
----
-
-# Invalid priority value
-
-## Test Steps
-1. Step one
+            fs.writeFileSync(specPath, `---
+id: TC-0003-invalid-enum
+title: Invalid priority value
+priority: SuperHigh
+caseType: MaybePositive
+status: unknown-status
+---
+
+# Invalid priority value
+
+## Test Steps
+1. Step one
 `);
             const result = SpecLinter.validateSpecFile(specPath);
             const enumErrors = result.diagnostics.filter((d) => d.code === 'testspectra/invalid-frontmatter-enum');
@@ -133,16 +133,16 @@ status: unknown-status
         });
         it('reports testspectra/missing-frontmatter when required H1 title section is missing in spec.md body', () => {
             const specPath = path.join(tempDir, 'spec.md');
-            fs.writeFileSync(specPath, `---
-id: TC-0004-no-h1
-title: No Heading Section
-priority: High
-caseType: Positive
-status: draft
----
-
-## Test Steps
-1. Step without H1
+            fs.writeFileSync(specPath, `---
+id: TC-0004-no-h1
+title: No Heading Section
+priority: High
+caseType: Positive
+status: draft
+---
+
+## Test Steps
+1. Step without H1
 `);
             const result = SpecLinter.validateSpecFile(specPath);
             const missingHeading = result.diagnostics.find((d) => d.code === 'testspectra/missing-frontmatter' && d.message.includes('expected top-level test title'));
@@ -151,17 +151,17 @@ status: draft
         });
         it('reports testspectra/missing-frontmatter when required ## Test Steps section is missing in spec.md body', () => {
             const specPath = path.join(tempDir, 'spec.md');
-            fs.writeFileSync(specPath, `---
-id: TC-0005-no-steps
-title: No Steps Heading
-priority: High
-caseType: Positive
-status: draft
----
-
-# No Steps Heading
-
-Some narrative without Test Steps section.
+            fs.writeFileSync(specPath, `---
+id: TC-0005-no-steps
+title: No Steps Heading
+priority: High
+caseType: Positive
+status: draft
+---
+
+# No Steps Heading
+
+Some narrative without Test Steps section.
 `);
             const result = SpecLinter.validateSpecFile(specPath);
             const missingSteps = result.diagnostics.find((d) => d.code === 'testspectra/missing-frontmatter' && d.message.includes('expected "## Test Steps"'));
@@ -170,20 +170,20 @@ Some narrative without Test Steps section.
         });
         it('warns when multiple H1 headings are declared in spec.md body', () => {
             const specPath = path.join(tempDir, 'spec.md');
-            fs.writeFileSync(specPath, `---
-id: TC-0006-multiple-h1
-title: Multiple Headings
-priority: High
-caseType: Positive
-status: draft
----
-
-# First Title
-
-# Second Title
-
-## Test Steps
-1. Step
+            fs.writeFileSync(specPath, `---
+id: TC-0006-multiple-h1
+title: Multiple Headings
+priority: High
+caseType: Positive
+status: draft
+---
+
+# First Title
+
+# Second Title
+
+## Test Steps
+1. Step
 `);
             const result = SpecLinter.validateSpecFile(specPath);
             const multipleH1 = result.diagnostics.find((d) => d.severity === 'warning' && d.message.includes('Multiple top-level H1 headings'));
@@ -191,10 +191,10 @@ status: draft
         });
         it('reports testspectra/parse-error on malformed YAML syntax', () => {
             const specPath = path.join(tempDir, 'spec.md');
-            fs.writeFileSync(specPath, `---
-id: [broken yaml
-title: Test
----
+            fs.writeFileSync(specPath, `---
+id: [broken yaml
+title: Test
+---
 `);
             const result = SpecLinter.validateSpecFile(specPath);
             expect(result.diagnostics.some((d) => d.code === 'testspectra/parse-error')).toBe(true);
@@ -203,16 +203,16 @@ title: Test
     describe('Suite File Validation (suite.md)', () => {
         it('passes validation for a well-formed suite.md with H1 suite heading', () => {
             const suitePath = path.join(tempDir, 'suite.md');
-            fs.writeFileSync(suitePath, `---
-id: suite-auth
-name: Authentication
-description: User authentication flows
-executionOrder: 1.0
-parallel: true
-status: active
----
-
-# Suite: Authentication
+            fs.writeFileSync(suitePath, `---
+id: suite-auth
+name: Authentication
+description: User authentication flows
+executionOrder: 1.0
+parallel: true
+status: active
+---
+
+# Suite: Authentication
 `);
             const result = SpecLinter.validateSuiteFile(suitePath);
             expect(result.diagnostics).toHaveLength(0);
@@ -220,24 +220,24 @@ status: active
         });
         it('reports testspectra/missing-frontmatter when suite id or title/name is missing', () => {
             const suitePath = path.join(tempDir, 'suite.md');
-            fs.writeFileSync(suitePath, `---
-description: No id and no name
----
-
-# Suite: Incomplete
+            fs.writeFileSync(suitePath, `---
+description: No id and no name
+---
+
+# Suite: Incomplete
 `);
             const result = SpecLinter.validateSuiteFile(suitePath);
             expect(result.diagnostics.some((d) => d.code === 'testspectra/missing-frontmatter')).toBe(true);
         });
         it('reports testspectra/invalid-frontmatter-enum when suite status has invalid enum value', () => {
             const suitePath = path.join(tempDir, 'suite.md');
-            fs.writeFileSync(suitePath, `---
-id: suite-invalid-status
-name: Invalid Status Suite
-status: unknown-status
----
-
-# Suite: Invalid Status Suite
+            fs.writeFileSync(suitePath, `---
+id: suite-invalid-status
+name: Invalid Status Suite
+status: unknown-status
+---
+
+# Suite: Invalid Status Suite
 `);
             const result = SpecLinter.validateSuiteFile(suitePath);
             const enumErr = result.diagnostics.find((d) => d.code === 'testspectra/invalid-frontmatter-enum');
@@ -246,13 +246,13 @@ status: unknown-status
         });
         it('supports in-memory content override for suite.md without writing to disk', () => {
             const suitePath = path.join(tempDir, 'non-existent-suite.md');
-            const inMemoryContent = `---
-id: suite-in-memory
-title: In Memory Suite
-status: active
----
-
-# Suite: In Memory Suite
+            const inMemoryContent = `---
+id: suite-in-memory
+title: In Memory Suite
+status: active
+---
+
+# Suite: In Memory Suite
 `;
             const result = SpecLinter.validateSuiteFile(suitePath, inMemoryContent);
             expect(result.diagnostics).toHaveLength(0);
@@ -260,12 +260,12 @@ status: active
         });
         it('reports testspectra/missing-frontmatter when suite H1 title heading is missing', () => {
             const suitePath = path.join(tempDir, 'suite.md');
-            fs.writeFileSync(suitePath, `---
-id: suite-no-heading
-name: No Heading
----
-
-Body without H1 suite heading.
+            fs.writeFileSync(suitePath, `---
+id: suite-no-heading
+name: No Heading
+---
+
+Body without H1 suite heading.
 `);
             const result = SpecLinter.validateSuiteFile(suitePath);
             const headingErr = result.diagnostics.find((d) => d.code === 'testspectra/missing-frontmatter' && d.message.includes('expected top-level suite title'));
@@ -278,18 +278,18 @@ Body without H1 suite heading.
             const tc2Dir = path.join(tempDir, 'TC-2');
             fs.mkdirSync(tc1Dir, { recursive: true });
             fs.mkdirSync(tc2Dir, { recursive: true });
-            const specContent = `---
-id: TC-DUPLICATE-001
-title: Duplicate test case
-priority: High
-caseType: Positive
-status: automated
----
-
-# Duplicate test case
-
-## Test Steps
-1. Duplicate step
+            const specContent = `---
+id: TC-DUPLICATE-001
+title: Duplicate test case
+priority: High
+caseType: Positive
+status: automated
+---
+
+# Duplicate test case
+
+## Test Steps
+1. Duplicate step
 `;
             fs.writeFileSync(path.join(tc1Dir, 'spec.md'), specContent);
             fs.writeFileSync(path.join(tc2Dir, 'spec.md'), specContent);
@@ -303,26 +303,26 @@ status: automated
             const validSuiteDir = path.join(tempDir, 'ValidSuite');
             const validTcDir = path.join(validSuiteDir, 'TC-001');
             fs.mkdirSync(validTcDir, { recursive: true });
-            fs.writeFileSync(path.join(validSuiteDir, 'suite.md'), `---
-id: suite-valid
-name: Valid Suite
-status: active
----
-
-# Suite: Valid Suite
+            fs.writeFileSync(path.join(validSuiteDir, 'suite.md'), `---
+id: suite-valid
+name: Valid Suite
+status: active
+---
+
+# Suite: Valid Suite
 `);
-            fs.writeFileSync(path.join(validTcDir, 'spec.md'), `---
-id: TC-VALID-001
-title: Valid Test Case
-priority: High
-caseType: Positive
-status: automated
----
-
-# Valid Test Case
-
-## Test Steps
-1. Open page
+            fs.writeFileSync(path.join(validTcDir, 'spec.md'), `---
+id: TC-VALID-001
+title: Valid Test Case
+priority: High
+caseType: Positive
+status: automated
+---
+
+# Valid Test Case
+
+## Test Steps
+1. Open page
 `);
             fs.writeFileSync(path.join(validTcDir, 'web.test.ts'), `it('Valid Test Case', async () => {});\n`);
             const result = SpecLinter.validateWorkspace(tempDir);

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,33 +27,33 @@ 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, {
     id: string;
-    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
     title: string;
+    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
     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;
 }, {
     id: string;
-    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
     title: string;
+    status: "draft" | "ready-for-automation" | "automated" | "deprecated";
     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/linter/schemas/suite.schema.d.ts

@@ -15,8 +15,8 @@ export declare const SuiteFrontmatterSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     name?: string | undefined;
-    status?: "active" | "draft" | "deprecated" | undefined;
     title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | undefined;
@@ -24,8 +24,8 @@ export declare const SuiteFrontmatterSchema: z.ZodEffects<z.ZodObject<{
 }, {
     id: string;
     name?: string | undefined;
-    status?: "active" | "draft" | "deprecated" | undefined;
     title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | undefined;
@@ -33,8 +33,8 @@ export declare const SuiteFrontmatterSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     id: string;
     name?: string | undefined;
-    status?: "active" | "draft" | "deprecated" | undefined;
     title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | undefined;
@@ -42,8 +42,8 @@ export declare const SuiteFrontmatterSchema: z.ZodEffects<z.ZodObject<{
 }, {
     id: string;
     name?: string | undefined;
-    status?: "active" | "draft" | "deprecated" | undefined;
     title?: string | undefined;
+    status?: "draft" | "deprecated" | "active" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     executionOrder?: number | 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;