@xera-ai/web 0.1.7 → 0.2.1

package/dist/{web/src/executor → executor}/index.d.ts

@@ -6,6 +6,7 @@ export interface RunPlaywrightInput {
     specPath: string;
     configPath: string;
     outputDir: string;
+    grep?: string;
     env?: NodeJS.ProcessEnv;
     spawn?: SpawnFn;
 }

package/dist/{web/src/executor → executor}/playwright-args.d.ts

@@ -2,5 +2,6 @@ export interface PlaywrightArgsInput {
     specPath: string;
     outputDir: string;
     configPath: string;
+    grep?: string;
 }
 export declare function buildPlaywrightArgs(input: PlaywrightArgsInput): string[];

package/dist/index.js

@@ -9,7 +9,7 @@ import { join } from "path";
 
 // src/executor/playwright-args.ts
 function buildPlaywrightArgs(input) {
-  return [
+  const args = [
     "test",
     input.specPath,
     `--config=${input.configPath}`,
@@ -17,6 +17,10 @@ function buildPlaywrightArgs(input) {
     `--output=${input.outputDir}`,
     "--trace=on"
   ];
+  if (input.grep) {
+    args.push("--grep", input.grep);
+  }
+  return args;
 }
 
 // src/executor/index.ts
@@ -29,7 +33,8 @@ async function runPlaywright(input) {
   const args = buildPlaywrightArgs({
     specPath: input.specPath,
     configPath: input.configPath,
-    outputDir: input.outputDir
+    outputDir: input.outputDir,
+    ...input.grep && { grep: input.grep }
   });
   const spawn = input.spawn ?? defaultSpawn;
   const { exitCode } = await spawn("npx", ["playwright", ...args], {
@@ -304,6 +309,20 @@ var WebAdapter = {
 function defineAuthSetup(fn) {
   return fn;
 }
+// src/auth-setup/playwright-state.ts
+import { mkdirSync, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+import { readAuthState } from "@xera-ai/core";
+function stagePlaywrightState(authDir, role) {
+  const entry = readAuthState(authDir, role);
+  if (!entry)
+    throw new Error(`No auth state for role "${role}" in ${authDir}`);
+  const cacheDir = join4(authDir, ".cache");
+  mkdirSync(cacheDir, { recursive: true });
+  const stagedPath = join4(cacheDir, `${role}.json`);
+  writeFileSync2(stagedPath, JSON.stringify(entry.payload));
+  return stagedPath;
+}
 // src/auth-setup/runner.ts
 import { pathToFileURL } from "url";
 import { writeAuthState } from "@xera-ai/core";
@@ -331,20 +350,6 @@ async function runAuthSetup(input) {
     await context.close();
   }
 }
-// src/auth-setup/playwright-state.ts
-import { mkdirSync, writeFileSync as writeFileSync2 } from "fs";
-import { join as join4 } from "path";
-import { readAuthState } from "@xera-ai/core";
-function stagePlaywrightState(authDir, role) {
-  const entry = readAuthState(authDir, role);
-  if (!entry)
-    throw new Error(`No auth state for role "${role}" in ${authDir}`);
-  const cacheDir = join4(authDir, ".cache");
-  mkdirSync(cacheDir, { recursive: true });
-  const stagedPath = join4(cacheDir, `${role}.json`);
-  writeFileSync2(stagedPath, JSON.stringify(entry.payload));
-  return stagedPath;
-}
 // src/generator/gherkin-validate.ts
 import { AstBuilder, GherkinClassicTokenMatcher, Parser } from "@cucumber/gherkin";
 import { IdGenerator } from "@cucumber/messages";
@@ -368,47 +373,9 @@ function validateGherkin(content) {
     return { ok: false, errors };
   }
 }
-// src/generator/typecheck.ts
-import { spawnSync } from "child_process";
-import { existsSync as existsSync2 } from "fs";
-import { dirname, join as join5 } from "path";
-function findNearestTsconfig(start) {
-  let dir = start;
-  while (true) {
-    const candidate = join5(dir, "tsconfig.json");
-    if (existsSync2(candidate))
-      return candidate;
-    const parent = dirname(dir);
-    if (parent === dir)
-      return null;
-    dir = parent;
-  }
-}
-async function typecheckTicket(ticketDir) {
-  const tsconfig = findNearestTsconfig(ticketDir);
-  if (!tsconfig) {
-    return {
-      ok: false,
-      errors: [
-        `No tsconfig.json found walking up from ${ticketDir}. Run \`xera init\` to scaffold one at the project root.`
-      ]
-    };
-  }
-  const proc = spawnSync("npx", ["tsc", "--noEmit", "-p", tsconfig], { encoding: "utf8" });
-  if (proc.status === 0)
-    return { ok: true, errors: [] };
-  const out = `${proc.stdout ?? ""}${proc.stderr ?? ""}`;
-  const allErrors = out.split(`
-`).filter((line) => /error TS\d+/.test(line));
-  const ticketErrors = allErrors.filter((line) => line.includes(ticketDir));
-  return {
-    ok: false,
-    errors: ticketErrors.length > 0 ? ticketErrors : allErrors
-  };
-}
 // src/generator/lint.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "fs";
+import { join as join5 } from "path";
 
 // src/generator/selector-rules.ts
 var AUTO_CLASS_RE = /\.(?:Mui|css|ant|chakra|MuiButton)[A-Za-z]*-[A-Za-z0-9_]*-[A-Za-z0-9_]{3,}/;
@@ -456,11 +423,11 @@ function lintSelectors(source) {
 
 // src/generator/lint.ts
 function listTsFiles(dir) {
-  if (!existsSync3(dir))
+  if (!existsSync2(dir))
     return [];
   const out = [];
   for (const name of readdirSync(dir, { withFileTypes: true })) {
-    const full = join6(dir, name.name);
+    const full = join5(dir, name.name);
     if (name.isDirectory())
       out.push(...listTsFiles(full));
     else if (name.name.endsWith(".ts"))
@@ -480,18 +447,18 @@ async function lintTicket(ticketDir) {
   return { ok: warnings.length === 0, warnings };
 }
 // src/generator/pom-scan.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, readdirSync as readdirSync2 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync4 } from "fs";
+import { join as join6 } from "path";
 var CLASS_RE = /export\s+class\s+([A-Z][A-Za-z0-9_]*)/g;
 function scanSharedPoms(repoRoot) {
-  const dir = join7(repoRoot, "shared", "page-objects");
-  if (!existsSync4(dir))
+  const dir = join6(repoRoot, "shared", "page-objects");
+  if (!existsSync3(dir))
     return [];
   const found = [];
   for (const entry of readdirSync2(dir, { withFileTypes: true })) {
     if (!entry.isFile() || !entry.name.endsWith(".ts"))
       continue;
-    const path = join7(dir, entry.name);
+    const path = join6(dir, entry.name);
     const src = readFileSync4(path, "utf8");
     for (const m of src.matchAll(CLASS_RE)) {
       found.push({ className: m[1], absolutePath: path });
@@ -500,28 +467,66 @@ function scanSharedPoms(repoRoot) {
   return found;
 }
 // src/generator/promote.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5, renameSync, writeFileSync as writeFileSync3 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync5, renameSync, writeFileSync as writeFileSync3 } from "fs";
+import { join as join7 } from "path";
 async function promotePom(input) {
-  const fromDir = join8(input.repoRoot, ".xera", input.ticket, "page-objects");
-  const toDir = join8(input.repoRoot, "shared", "page-objects");
+  const fromDir = join7(input.repoRoot, ".xera", input.ticket, "page-objects");
+  const toDir = join7(input.repoRoot, "shared", "page-objects");
   const file = `${input.className}.ts`;
-  const fromPath = join8(fromDir, file);
-  const toPath = join8(toDir, file);
-  if (!existsSync5(fromPath)) {
+  const fromPath = join7(fromDir, file);
+  const toPath = join7(toDir, file);
+  if (!existsSync4(fromPath)) {
     throw new Error(`POM ${file} not found at ${fromPath}`);
   }
-  if (existsSync5(toPath)) {
+  if (existsSync4(toPath)) {
     throw new Error(`POM ${file} already exists at ${toPath}. Reconcile manually before promoting.`);
   }
   renameSync(fromPath, toPath);
-  const specPath = join8(input.repoRoot, ".xera", input.ticket, "spec.ts");
-  if (existsSync5(specPath)) {
+  const specPath = join7(input.repoRoot, ".xera", input.ticket, "spec.ts");
+  if (existsSync4(specPath)) {
     const src = readFileSync5(specPath, "utf8");
     const updated = src.replace(new RegExp(`from\\s+['"]\\./page-objects/${input.className}['"]`, "g"), `from '../../shared/page-objects/${input.className}'`);
     writeFileSync3(specPath, updated);
   }
 }
+// src/generator/typecheck.ts
+import { spawnSync } from "child_process";
+import { existsSync as existsSync5 } from "fs";
+import { dirname, join as join8 } from "path";
+function findNearestTsconfig(start) {
+  let dir = start;
+  while (true) {
+    const candidate = join8(dir, "tsconfig.json");
+    if (existsSync5(candidate))
+      return candidate;
+    const parent = dirname(dir);
+    if (parent === dir)
+      return null;
+    dir = parent;
+  }
+}
+async function typecheckTicket(ticketDir) {
+  const tsconfig = findNearestTsconfig(ticketDir);
+  if (!tsconfig) {
+    return {
+      ok: false,
+      errors: [
+        `No tsconfig.json found walking up from ${ticketDir}. Run \`xera init\` to scaffold one at the project root.`
+      ]
+    };
+  }
+  const proc = spawnSync("npx", ["tsc", "--noEmit", "-p", tsconfig], { encoding: "utf8" });
+  if (proc.status === 0)
+    return { ok: true, errors: [] };
+  const out = `${proc.stdout ?? ""}${proc.stderr ?? ""}`;
+  const allErrors = out.split(`
+`).filter((line) => /error TS\d+/.test(line));
+  const ticketErrors = allErrors.filter((line) => line.includes(ticketDir));
+  return {
+    ok: false,
+    errors: ticketErrors.length > 0 ? ticketErrors : allErrors
+  };
+}
 export {
   validateGherkin,
   unzipTrace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xera-ai/web",
-  "version": "0.1.7",
+  "version": "0.2.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,16 +11,19 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist", "src"],
+  "files": [
+    "dist",
+    "src"
+  ],
   "scripts": {
     "build": "bun build ./src/index.ts --outdir ./dist --target bun --external @playwright/test --external @xera-ai/core --external @cucumber/gherkin --external @cucumber/messages --external fflate",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@cucumber/gherkin": "30.0.4",
-    "@cucumber/messages": "27.0.2",
-    "@playwright/test": "1.48.0",
-    "@xera-ai/core": "^0.1.5",
-    "fflate": "0.8.2"
+    "@cucumber/gherkin": "39.1.0",
+    "@cucumber/messages": "32.3.1",
+    "@playwright/test": "1.60.0",
+    "@xera-ai/core": "^0.4.0",
+    "fflate": "0.8.3"
   }
 }

package/src/executor/index.ts

@@ -10,6 +10,7 @@ export interface RunPlaywrightInput {
   specPath: string;
   configPath: string;
   outputDir: string;
+  grep?: string;
   env?: NodeJS.ProcessEnv;
   spawn?: SpawnFn;
 }
@@ -31,6 +32,7 @@ export async function runPlaywright(input: RunPlaywrightInput): Promise<RunPlayw
     specPath: input.specPath,
     configPath: input.configPath,
     outputDir: input.outputDir,
+    ...(input.grep && { grep: input.grep }),
   });
   const spawn = input.spawn ?? defaultSpawn;
   const { exitCode } = await spawn('npx', ['playwright', ...args], {

package/src/executor/playwright-args.ts

@@ -2,10 +2,11 @@ export interface PlaywrightArgsInput {
   specPath: string;
   outputDir: string;
   configPath: string;
+  grep?: string;
 }
 
 export function buildPlaywrightArgs(input: PlaywrightArgsInput): string[] {
-  return [
+  const args = [
     'test',
     input.specPath,
     `--config=${input.configPath}`,
@@ -13,4 +14,8 @@ export function buildPlaywrightArgs(input: PlaywrightArgsInput): string[] {
     `--output=${input.outputDir}`,
     '--trace=on',
   ];
+  if (input.grep) {
+    args.push('--grep', input.grep);
+  }
+  return args;
 }

package/src/generator/lint.ts

@@ -1,6 +1,6 @@
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { type SelectorWarning, lintSelectors } from './selector-rules';
+import { lintSelectors, type SelectorWarning } from './selector-rules';
 
 export interface LintResult {
   ok: boolean;

package/src/generator/pom-scan.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 
 const CLASS_RE = /export\s+class\s+([A-Z][A-Za-z0-9_]*)/g;

package/src/index.ts

@@ -1,17 +1,17 @@
 export * from './adapter';
 export * from './auth-setup/define';
-export * from './auth-setup/runner';
 export * from './auth-setup/playwright-state';
+export * from './auth-setup/runner';
 export * from './executor';
 export * from './executor/playwright-args';
+export * from './generator/gherkin-validate';
+export * from './generator/lint';
+export * from './generator/pom-scan';
+export * from './generator/promote';
+export * from './generator/selector-rules';
+export * from './generator/typecheck';
 export * from './trace-normalizer/normalize';
 export * from './trace-normalizer/parse';
 export * from './trace-normalizer/scrub';
 export * from './trace-normalizer/scrub-rules';
 export * from './trace-normalizer/unzip';
-export * from './generator/gherkin-validate';
-export * from './generator/typecheck';
-export * from './generator/lint';
-export * from './generator/selector-rules';
-export * from './generator/pom-scan';
-export * from './generator/promote';

package/dist/core/src/adapter/types.d.ts

@@ -1,69 +0,0 @@
-import type { Classification } from '../artifact/status';
-import type { XeraConfig } from '../config/schema';
-export interface GenerateInput {
-    ticketDir: string;
-    feature: string;
-    story: string;
-    config: XeraConfig;
-}
-export interface GenerateResult {
-    artifacts: string[];
-    warnings: string[];
-}
-export interface ExecuteInput {
-    ticketDir: string;
-    config: XeraConfig;
-    runId: string;
-    env: string;
-}
-export interface ScenarioResult {
-    name: string;
-    outcome: 'PASS' | 'FAIL' | 'SKIPPED';
-    failure?: {
-        step?: string;
-        errorMessage?: string;
-        domSnapshotAtFailure?: string;
-        networkAtFailure?: Array<{
-            method: string;
-            url: string;
-            status: number;
-        }>;
-        consoleAtFailure?: string[];
-        screenshotPath?: string;
-    };
-}
-export interface RunResult {
-    runId: string;
-    outcome: 'PASS' | 'FAIL';
-    scenarios: ScenarioResult[];
-    artifactsDir: string;
-    rawReportPath: string;
-    normalizedReportPath: string;
-}
-export interface ClassifyContext {
-    history: Array<{
-        ts: string;
-        result: 'PASS' | 'FAIL';
-        class: Classification;
-    }>;
-    storyHashChanged: boolean;
-    specHashChanged: boolean;
-}
-export interface DoctorReport {
-    ok: boolean;
-    checks: Array<{
-        name: string;
-        ok: boolean;
-        message?: string;
-    }>;
-}
-export interface TestAdapter {
-    readonly id: string;
-    generate(input: GenerateInput): Promise<GenerateResult>;
-    execute(input: ExecuteInput): Promise<RunResult>;
-    classify?(run: RunResult, ctx: ClassifyContext): Partial<{
-        class: Classification;
-        rationale: string;
-    }>;
-    doctor(): Promise<DoctorReport>;
-}

package/dist/core/src/artifact/hash.d.ts

@@ -1,3 +0,0 @@
-export declare function hashString(s: string): string;
-export declare function hashFile(path: string): string;
-export declare function hashFileIfExists(path: string): string | null;

package/dist/core/src/artifact/meta.d.ts

@@ -1,45 +0,0 @@
-import { z } from 'zod';
-export declare const MetaJsonSchema: z.ZodObject<{
-    ticket: z.ZodString;
-    adapter: z.ZodString;
-    xera_version: z.ZodString;
-    prompts_version: z.ZodString;
-    fetched_at: z.ZodOptional<z.ZodString>;
-    story_hash: z.ZodOptional<z.ZodString>;
-    feature_generated_at: z.ZodOptional<z.ZodString>;
-    feature_generated_from_story_hash: z.ZodOptional<z.ZodString>;
-    feature_hash: z.ZodOptional<z.ZodString>;
-    script_generated_at: z.ZodOptional<z.ZodString>;
-    script_generated_from_feature_hash: z.ZodOptional<z.ZodString>;
-    script_warnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    ticket: string;
-    adapter: string;
-    xera_version: string;
-    prompts_version: string;
-    fetched_at?: string | undefined;
-    story_hash?: string | undefined;
-    feature_generated_at?: string | undefined;
-    feature_generated_from_story_hash?: string | undefined;
-    feature_hash?: string | undefined;
-    script_generated_at?: string | undefined;
-    script_generated_from_feature_hash?: string | undefined;
-    script_warnings?: string[] | undefined;
-}, {
-    ticket: string;
-    adapter: string;
-    xera_version: string;
-    prompts_version: string;
-    fetched_at?: string | undefined;
-    story_hash?: string | undefined;
-    feature_generated_at?: string | undefined;
-    feature_generated_from_story_hash?: string | undefined;
-    feature_hash?: string | undefined;
-    script_generated_at?: string | undefined;
-    script_generated_from_feature_hash?: string | undefined;
-    script_warnings?: string[] | undefined;
-}>;
-export type MetaJson = z.infer<typeof MetaJsonSchema>;
-export declare function readMeta(path: string): MetaJson | null;
-export declare function writeMeta(path: string, meta: MetaJson): void;
-export declare function updateMeta(path: string, patch: Partial<MetaJson>): MetaJson;

package/dist/core/src/artifact/paths.d.ts

@@ -1,24 +0,0 @@
-export interface RunPaths {
-    runDir: string;
-    reportJsonPath: string;
-    tracePath: string;
-    normalizedPath: string;
-    screenshotsDir: string;
-    videoDir: string;
-}
-export interface ArtifactPaths {
-    ticketDir: string;
-    storyPath: string;
-    featurePath: string;
-    specPath: string;
-    pageObjectsDir: string;
-    runsDir: string;
-    metaPath: string;
-    statusPath: string;
-    logPath: string;
-    lockPath: string;
-    authDir: string;
-    runPath: (runId: string) => RunPaths;
-}
-export declare function resolveArtifactPaths(repoRoot: string, ticket: string): ArtifactPaths;
-export declare function generateRunId(now?: Date): string;

package/dist/core/src/artifact/status.d.ts

@@ -1,95 +0,0 @@
-import { z } from 'zod';
-declare const ClassificationEnum: z.ZodEnum<["PASS", "REAL_BUG", "SELECTOR_DRIFT", "FLAKY", "TEST_BUG"]>;
-export declare const HistoryEntrySchema: z.ZodObject<{
-    ts: z.ZodString;
-    result: z.ZodEnum<["PASS", "FAIL"]>;
-    class: z.ZodEnum<["PASS", "REAL_BUG", "SELECTOR_DRIFT", "FLAKY", "TEST_BUG"]>;
-}, "strip", z.ZodTypeAny, {
-    ts: string;
-    result: "PASS" | "FAIL";
-    class: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-}, {
-    ts: string;
-    result: "PASS" | "FAIL";
-    class: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-}>;
-export declare const StatusJsonSchema: z.ZodObject<{
-    ticket: z.ZodString;
-    lastRun: z.ZodString;
-    result: z.ZodEnum<["PASS", "FAIL"]>;
-    classification: z.ZodEnum<["PASS", "REAL_BUG", "SELECTOR_DRIFT", "FLAKY", "TEST_BUG"]>;
-    confidence: z.ZodEnum<["low", "medium", "high"]>;
-    scenarios: z.ZodObject<{
-        total: z.ZodNumber;
-        passed: z.ZodNumber;
-        failed: z.ZodNumber;
-        skipped: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        total: number;
-        passed: number;
-        failed: number;
-        skipped: number;
-    }, {
-        total: number;
-        passed: number;
-        failed: number;
-        skipped: number;
-    }>;
-    history: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        ts: z.ZodString;
-        result: z.ZodEnum<["PASS", "FAIL"]>;
-        class: z.ZodEnum<["PASS", "REAL_BUG", "SELECTOR_DRIFT", "FLAKY", "TEST_BUG"]>;
-    }, "strip", z.ZodTypeAny, {
-        ts: string;
-        result: "PASS" | "FAIL";
-        class: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-    }, {
-        ts: string;
-        result: "PASS" | "FAIL";
-        class: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-    }>, "many">>;
-    last_jira_comment_id: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    result: "PASS" | "FAIL";
-    ticket: string;
-    lastRun: string;
-    classification: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-    confidence: "low" | "medium" | "high";
-    scenarios: {
-        total: number;
-        passed: number;
-        failed: number;
-        skipped: number;
-    };
-    history: {
-        ts: string;
-        result: "PASS" | "FAIL";
-        class: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-    }[];
-    last_jira_comment_id?: string | undefined;
-}, {
-    result: "PASS" | "FAIL";
-    ticket: string;
-    lastRun: string;
-    classification: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-    confidence: "low" | "medium" | "high";
-    scenarios: {
-        total: number;
-        passed: number;
-        failed: number;
-        skipped: number;
-    };
-    history?: {
-        ts: string;
-        result: "PASS" | "FAIL";
-        class: "PASS" | "REAL_BUG" | "SELECTOR_DRIFT" | "FLAKY" | "TEST_BUG";
-    }[] | undefined;
-    last_jira_comment_id?: string | undefined;
-}>;
-export type StatusJson = z.infer<typeof StatusJsonSchema>;
-export type HistoryEntry = z.infer<typeof HistoryEntrySchema>;
-export type Classification = z.infer<typeof ClassificationEnum>;
-export declare function readStatus(path: string): StatusJson | null;
-export declare function writeStatus(path: string, status: StatusJson): void;
-export declare function appendHistory(path: string, entry: HistoryEntry): StatusJson;
-export {};

package/dist/core/src/auth/encrypt.d.ts

@@ -1,3 +0,0 @@
-export declare function generateKey(): string;
-export declare function encrypt(plaintext: string, keyHex: string): string;
-export declare function decrypt(ciphertext: string, keyHex: string): string;

package/dist/core/src/auth/key.d.ts

@@ -1,2 +0,0 @@
-export declare const AUTH_KEY_ENV = "XERA_AUTH_KEY";
-export declare function resolveAuthKey(): string;

package/dist/core/src/auth/refresh.d.ts

@@ -1,8 +0,0 @@
-import type { AuthStateEntry } from './state';
-export type { AuthStateEntry } from './state';
-export declare function parseDuration(d: string): number;
-export interface RefreshPolicy {
-    ttl: string;
-    refreshBuffer: string;
-}
-export declare function needsRefresh(entry: AuthStateEntry | null, policy: RefreshPolicy, now?: Date): boolean;

package/dist/core/src/auth/state.d.ts

@@ -1,23 +0,0 @@
-import { z } from 'zod';
-export declare const AuthStateEntrySchema: z.ZodObject<{
-    role: z.ZodString;
-    strategy: z.ZodEnum<["storageState", "apiToken"]>;
-    created_at: z.ZodString;
-    expires_at: z.ZodString;
-    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, "strip", z.ZodTypeAny, {
-    strategy: "storageState" | "apiToken";
-    role: string;
-    created_at: string;
-    expires_at: string;
-    payload: Record<string, unknown>;
-}, {
-    strategy: "storageState" | "apiToken";
-    role: string;
-    created_at: string;
-    expires_at: string;
-    payload: Record<string, unknown>;
-}>;
-export type AuthStateEntry = z.infer<typeof AuthStateEntrySchema>;
-export declare function writeAuthState(authDir: string, entry: AuthStateEntry): void;
-export declare function readAuthState(authDir: string, role: string): AuthStateEntry | null;

package/dist/core/src/config/define.d.ts

@@ -1,2 +0,0 @@
-import type { XeraConfig } from './schema';
-export declare function defineConfig(config: XeraConfig): XeraConfig;

package/dist/core/src/config/load.d.ts

@@ -1,2 +0,0 @@
-import { type XeraConfig } from './schema';
-export declare function loadConfig(cwd: string): Promise<XeraConfig>;

package/dist/core/src/config/schema.d.ts

@@ -1,325 +0,0 @@
-import { z } from 'zod';
-export declare const XeraConfigSchema: z.ZodObject<{
-    jira: z.ZodObject<{
-        baseUrl: z.ZodString;
-        projectKeys: z.ZodArray<z.ZodString, "many">;
-        fields: z.ZodObject<{
-            story: z.ZodString;
-            acceptanceCriteria: z.ZodOptional<z.ZodString>;
-            attachments: z.ZodDefault<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            story: string;
-            attachments: string;
-            acceptanceCriteria?: string | undefined;
-        }, {
-            story: string;
-            acceptanceCriteria?: string | undefined;
-            attachments?: string | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        baseUrl: string;
-        projectKeys: string[];
-        fields: {
-            story: string;
-            attachments: string;
-            acceptanceCriteria?: string | undefined;
-        };
-    }, {
-        baseUrl: string;
-        projectKeys: string[];
-        fields: {
-            story: string;
-            acceptanceCriteria?: string | undefined;
-            attachments?: string | undefined;
-        };
-    }>;
-    web: z.ZodEffects<z.ZodObject<{
-        baseUrl: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
-        defaultEnv: z.ZodString;
-        auth: z.ZodDefault<z.ZodObject<{
-            strategy: z.ZodDefault<z.ZodEnum<["storageState", "apiToken", "none"]>>;
-            ttl: z.ZodDefault<z.ZodString>;
-            refreshBuffer: z.ZodDefault<z.ZodString>;
-            setupScript: z.ZodOptional<z.ZodString>;
-            roles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-                envEmail: z.ZodString;
-                envPassword: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                envEmail: string;
-                envPassword: string;
-            }, {
-                envEmail: string;
-                envPassword: string;
-            }>>>;
-        }, "strip", z.ZodTypeAny, {
-            strategy: "storageState" | "apiToken" | "none";
-            ttl: string;
-            refreshBuffer: string;
-            roles: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }>;
-            setupScript?: string | undefined;
-        }, {
-            strategy?: "storageState" | "apiToken" | "none" | undefined;
-            ttl?: string | undefined;
-            refreshBuffer?: string | undefined;
-            setupScript?: string | undefined;
-            roles?: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }> | undefined;
-        }>>;
-        testData: z.ZodDefault<z.ZodObject<{
-            users: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-                fromAuth: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                fromAuth: string;
-            }, {
-                fromAuth: string;
-            }>>>;
-        }, "strip", z.ZodTypeAny, {
-            users: Record<string, {
-                fromAuth: string;
-            }>;
-        }, {
-            users?: Record<string, {
-                fromAuth: string;
-            }> | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        baseUrl: Record<string, string>;
-        defaultEnv: string;
-        auth: {
-            strategy: "storageState" | "apiToken" | "none";
-            ttl: string;
-            refreshBuffer: string;
-            roles: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }>;
-            setupScript?: string | undefined;
-        };
-        testData: {
-            users: Record<string, {
-                fromAuth: string;
-            }>;
-        };
-    }, {
-        baseUrl: Record<string, string>;
-        defaultEnv: string;
-        auth?: {
-            strategy?: "storageState" | "apiToken" | "none" | undefined;
-            ttl?: string | undefined;
-            refreshBuffer?: string | undefined;
-            setupScript?: string | undefined;
-            roles?: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }> | undefined;
-        } | undefined;
-        testData?: {
-            users?: Record<string, {
-                fromAuth: string;
-            }> | undefined;
-        } | undefined;
-    }>, {
-        baseUrl: Record<string, string>;
-        defaultEnv: string;
-        auth: {
-            strategy: "storageState" | "apiToken" | "none";
-            ttl: string;
-            refreshBuffer: string;
-            roles: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }>;
-            setupScript?: string | undefined;
-        };
-        testData: {
-            users: Record<string, {
-                fromAuth: string;
-            }>;
-        };
-    }, {
-        baseUrl: Record<string, string>;
-        defaultEnv: string;
-        auth?: {
-            strategy?: "storageState" | "apiToken" | "none" | undefined;
-            ttl?: string | undefined;
-            refreshBuffer?: string | undefined;
-            setupScript?: string | undefined;
-            roles?: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }> | undefined;
-        } | undefined;
-        testData?: {
-            users?: Record<string, {
-                fromAuth: string;
-            }> | undefined;
-        } | undefined;
-    }>;
-    ai: z.ZodDefault<z.ZodObject<{
-        livePageSnapshot: z.ZodDefault<z.ZodBoolean>;
-        confidenceThreshold: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
-        maxRetries: z.ZodDefault<z.ZodObject<{
-            typecheck: z.ZodDefault<z.ZodNumber>;
-            lint: z.ZodDefault<z.ZodNumber>;
-            validateFeature: z.ZodDefault<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            typecheck: number;
-            lint: number;
-            validateFeature: number;
-        }, {
-            typecheck?: number | undefined;
-            lint?: number | undefined;
-            validateFeature?: number | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        livePageSnapshot: boolean;
-        confidenceThreshold: "low" | "medium" | "high";
-        maxRetries: {
-            typecheck: number;
-            lint: number;
-            validateFeature: number;
-        };
-    }, {
-        livePageSnapshot?: boolean | undefined;
-        confidenceThreshold?: "low" | "medium" | "high" | undefined;
-        maxRetries?: {
-            typecheck?: number | undefined;
-            lint?: number | undefined;
-            validateFeature?: number | undefined;
-        } | undefined;
-    }>>;
-    reporting: z.ZodDefault<z.ZodObject<{
-        language: z.ZodDefault<z.ZodEnum<["en", "vi"]>>;
-        postToJira: z.ZodDefault<z.ZodBoolean>;
-        transition: z.ZodDefault<z.ZodObject<{
-            onPass: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-            onFail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            onPass: string | null;
-            onFail: string | null;
-        }, {
-            onPass?: string | null | undefined;
-            onFail?: string | null | undefined;
-        }>>;
-        artifactLinks: z.ZodDefault<z.ZodEnum<["git", "local"]>>;
-    }, "strip", z.ZodTypeAny, {
-        language: "en" | "vi";
-        postToJira: boolean;
-        transition: {
-            onPass: string | null;
-            onFail: string | null;
-        };
-        artifactLinks: "git" | "local";
-    }, {
-        language?: "en" | "vi" | undefined;
-        postToJira?: boolean | undefined;
-        transition?: {
-            onPass?: string | null | undefined;
-            onFail?: string | null | undefined;
-        } | undefined;
-        artifactLinks?: "git" | "local" | undefined;
-    }>>;
-    adapters: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    jira: {
-        baseUrl: string;
-        projectKeys: string[];
-        fields: {
-            story: string;
-            attachments: string;
-            acceptanceCriteria?: string | undefined;
-        };
-    };
-    web: {
-        baseUrl: Record<string, string>;
-        defaultEnv: string;
-        auth: {
-            strategy: "storageState" | "apiToken" | "none";
-            ttl: string;
-            refreshBuffer: string;
-            roles: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }>;
-            setupScript?: string | undefined;
-        };
-        testData: {
-            users: Record<string, {
-                fromAuth: string;
-            }>;
-        };
-    };
-    ai: {
-        livePageSnapshot: boolean;
-        confidenceThreshold: "low" | "medium" | "high";
-        maxRetries: {
-            typecheck: number;
-            lint: number;
-            validateFeature: number;
-        };
-    };
-    reporting: {
-        language: "en" | "vi";
-        postToJira: boolean;
-        transition: {
-            onPass: string | null;
-            onFail: string | null;
-        };
-        artifactLinks: "git" | "local";
-    };
-    adapters: string[];
-}, {
-    jira: {
-        baseUrl: string;
-        projectKeys: string[];
-        fields: {
-            story: string;
-            acceptanceCriteria?: string | undefined;
-            attachments?: string | undefined;
-        };
-    };
-    web: {
-        baseUrl: Record<string, string>;
-        defaultEnv: string;
-        auth?: {
-            strategy?: "storageState" | "apiToken" | "none" | undefined;
-            ttl?: string | undefined;
-            refreshBuffer?: string | undefined;
-            setupScript?: string | undefined;
-            roles?: Record<string, {
-                envEmail: string;
-                envPassword: string;
-            }> | undefined;
-        } | undefined;
-        testData?: {
-            users?: Record<string, {
-                fromAuth: string;
-            }> | undefined;
-        } | undefined;
-    };
-    ai?: {
-        livePageSnapshot?: boolean | undefined;
-        confidenceThreshold?: "low" | "medium" | "high" | undefined;
-        maxRetries?: {
-            typecheck?: number | undefined;
-            lint?: number | undefined;
-            validateFeature?: number | undefined;
-        } | undefined;
-    } | undefined;
-    reporting?: {
-        language?: "en" | "vi" | undefined;
-        postToJira?: boolean | undefined;
-        transition?: {
-            onPass?: string | null | undefined;
-            onFail?: string | null | undefined;
-        } | undefined;
-        artifactLinks?: "git" | "local" | undefined;
-    } | undefined;
-    adapters?: string[] | undefined;
-}>;
-export type XeraConfig = z.infer<typeof XeraConfigSchema>;

package/dist/core/src/index.d.ts

@@ -1,19 +0,0 @@
-export declare const VERSION = "0.1.0";
-export type * from './adapter/types';
-export * from './config/schema';
-export * from './config/define';
-export * from './config/load';
-export * from './artifact/paths';
-export * from './artifact/hash';
-export * from './artifact/meta';
-export * from './artifact/status';
-export * from './logging/ndjson-logger';
-export * from './lock/file-lock';
-export * from './jira/types';
-export * from './jira/client';
-export * from './jira/fields';
-export * from './jira/retry';
-export * from './auth/encrypt';
-export * from './auth/key';
-export * from './auth/state';
-export * from './auth/refresh';

package/dist/core/src/jira/client.d.ts

@@ -1,10 +0,0 @@
-import type { JiraClient } from './types';
-export interface CreateJiraClientOptions {
-    baseUrl: string;
-    preferMcp?: boolean;
-    rest?: {
-        email: string;
-        apiToken: string;
-    };
-}
-export declare function createJiraClient(opts: CreateJiraClientOptions): Promise<JiraClient>;

package/dist/core/src/jira/fields.d.ts

@@ -1,6 +0,0 @@
-export interface JiraFieldInfo {
-    id: string;
-    name: string;
-    hasContent: boolean;
-}
-export declare function rankStoryCandidates(fields: JiraFieldInfo[]): JiraFieldInfo[];

package/dist/core/src/jira/mcp-backend.d.ts

@@ -1,2 +0,0 @@
-import type { JiraClient } from './types';
-export declare function createMcpBackend(_baseUrl: string): Promise<JiraClient | null>;

package/dist/core/src/jira/rest-backend.d.ts

@@ -1,7 +0,0 @@
-import type { JiraClient } from './types';
-interface RestCreds {
-    email: string;
-    apiToken: string;
-}
-export declare function createRestBackend(baseUrl: string, creds: RestCreds): JiraClient;
-export {};

package/dist/core/src/jira/retry.d.ts

@@ -1,7 +0,0 @@
-export interface RetryOptions {
-    maxAttempts: number;
-    baseMs: number;
-    factor: number;
-    shouldRetry?: (err: unknown) => boolean;
-}
-export declare function withRetry<T>(fn: () => Promise<T>, opts: RetryOptions): Promise<T>;

package/dist/core/src/jira/types.d.ts

@@ -1,28 +0,0 @@
-export interface JiraTicket {
-    key: string;
-    summary: string;
-    story: string;
-    acceptanceCriteria?: string;
-    attachments: Array<{
-        filename: string;
-        url: string;
-    }>;
-    raw: Record<string, unknown>;
-}
-export interface JiraFieldMap {
-    story: string;
-    acceptanceCriteria?: string;
-}
-export interface JiraClient {
-    readonly backend: 'mcp' | 'rest';
-    fetchTicket(key: string, fields: JiraFieldMap): Promise<JiraTicket>;
-    postComment(key: string, body: string): Promise<{
-        id: string;
-    }>;
-    transitionStatus(key: string, statusName: string): Promise<void>;
-    listFields(sampleKey: string): Promise<Array<{
-        id: string;
-        name: string;
-        hasContent: boolean;
-    }>>;
-}

package/dist/core/src/lock/file-lock.d.ts

@@ -1,11 +0,0 @@
-export interface LockData {
-    pid: number;
-    hostname: string;
-    started_at: string;
-    run_id: string;
-}
-export declare function acquireLock(path: string, runId: string): boolean;
-export declare function releaseLock(path: string): void;
-export declare function readLock(path: string): LockData | null;
-export declare function isLockStale(path: string): boolean;
-export declare function forceUnlock(path: string): void;

package/dist/core/src/logging/ndjson-logger.d.ts

@@ -1,10 +0,0 @@
-export interface LogEntry {
-    ts: string;
-    [key: string]: unknown;
-}
-export declare class NdjsonLogger {
-    private readonly path;
-    constructor(path: string);
-    log(payload: Record<string, unknown>): void;
-    static readAll(path: string): LogEntry[];
-}

package/dist/{web/src/index.d.ts → index.d.ts}

@@ -1,17 +1,17 @@
 export * from './adapter';
 export * from './auth-setup/define';
-export * from './auth-setup/runner';
 export * from './auth-setup/playwright-state';
+export * from './auth-setup/runner';
 export * from './executor';
 export * from './executor/playwright-args';
+export * from './generator/gherkin-validate';
+export * from './generator/lint';
+export * from './generator/pom-scan';
+export * from './generator/promote';
+export * from './generator/selector-rules';
+export * from './generator/typecheck';
 export * from './trace-normalizer/normalize';
 export * from './trace-normalizer/parse';
 export * from './trace-normalizer/scrub';
 export * from './trace-normalizer/scrub-rules';
 export * from './trace-normalizer/unzip';
-export * from './generator/gherkin-validate';
-export * from './generator/typecheck';
-export * from './generator/lint';
-export * from './generator/selector-rules';
-export * from './generator/pom-scan';
-export * from './generator/promote';