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

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,8 @@
 import fs from 'fs';
 import path from 'path';
 /**
- * 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 +23,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 +39,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 +67,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;

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

@@ -36,8 +36,8 @@ export declare const SpecFrontmatterSchema: z.ZodObject<{
     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?: {
@@ -47,8 +47,8 @@ export declare const SpecFrontmatterSchema: z.ZodObject<{
     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?: {

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.js

@@ -1,15 +1,60 @@
 import { spawn } from 'child_process';
 import fs from 'fs';
 import path from 'path';
+import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const require = createRequire(import.meta.url);
+// Maps process.platform/process.arch to the optionalDependency package that carries the
+// prebuilt native binary for that platform (see cli/npm/*). Keep in sync with the
+// optionalDependencies list in cli/package.json and the packages built by
+// scripts/release-cli-local.sh.
+function platformPackageName() {
+    const { platform, arch } = process;
+    if (platform === 'darwin' && arch === 'arm64')
+        return '@testspectra/cli-darwin-arm64';
+    if (platform === 'linux' && arch === 'x64')
+        return '@testspectra/cli-linux-x64';
+    if (platform === 'win32' && arch === 'arm64')
+        return '@testspectra/cli-win32-arm64';
+    if (platform === 'win32' && arch === 'x64')
+        return '@testspectra/cli-win32-x64';
+    return null;
+}
 export class RustCoreBridge {
     static resolveBinaryPath() {
-        // 1. Look for precompiled release/debug binary in workspace target
-        const workspaceRoot = path.resolve(__dirname, '../../..');
         const isWindows = process.platform === 'win32';
         const binaryName = isWindows ? 'testspectra-runner.exe' : 'testspectra-runner';
+        // 1. Production install: resolve the prebuilt binary from the platform-specific
+        // optionalDependency package (e.g. @testspectra/cli-darwin-arm64). This is how the
+        // published npm package ships native binaries for every supported platform without
+        // bundling all of them into @testspectra/cli itself.
+        const pkgName = platformPackageName();
+        if (pkgName) {
+            try {
+                const pkgJsonPath = require.resolve(`${pkgName}/package.json`);
+                const pkgBinPath = path.join(path.dirname(pkgJsonPath), 'bin', binaryName);
+                if (fs.existsSync(pkgBinPath)) {
+                    if (process.platform !== 'win32') {
+                        try {
+                            const stat = fs.statSync(pkgBinPath);
+                            if ((stat.mode & 0o111) === 0) {
+                                fs.chmodSync(pkgBinPath, 0o755);
+                            }
+                        }
+                        catch { }
+                    }
+                    return pkgBinPath;
+                }
+            }
+            catch {
+                // Optional dependency not installed — fall through to the workspace dev paths below.
+            }
+        }
+        // 2. Monorepo dev fallback: look for a precompiled release/debug binary in the workspace
+        // target, as produced by scripts/ensure-runner-binary.js during local development.
+        const workspaceRoot = path.resolve(__dirname, '../../..');
         const candidatePaths = [
             path.join(workspaceRoot, 'core/target/release', binaryName),
             path.join(workspaceRoot, 'target/release', binaryName),
@@ -29,8 +74,11 @@ export class RustCoreBridge {
                 return `${p}.exe`;
             }
         }
-        throw new Error("[TestSpectra] Native core runner binary 'testspectra-runner' not found.\n" +
-            "Please build the project first using 'pnpm run build' or 'pnpm run build:core'.");
+        throw new Error(pkgName
+            ? `[TestSpectra] Native core runner binary not found for ${process.platform}/${process.arch}.\n` +
+                `Expected the optional dependency '${pkgName}' to provide it. Try reinstalling ` +
+                "('npm install' / 'pnpm install') without --no-optional, or build locally with 'pnpm run build:core'."
+            : `[TestSpectra] ${process.platform}/${process.arch} is not currently supported by @testspectra/cli.`);
     }
     static async run(options, reporter) {
         const binPath = this.resolveBinaryPath();
@@ -66,6 +114,7 @@ export class RustCoreBridge {
         return new Promise((resolve, reject) => {
             const child = spawn(binPath, [payload], {
                 env: runnerEnv,
+                windowsHide: true,
             });
             let runStatus = 'failed';
             let runDuration = '0s';