@continuum8032/playwright-ai-test-management 0.2.0-oidc-bootstrap.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Continuum8032 contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @continuum8032/playwright-ai-test-management
+
+Optional read-only adapters for importing manual test cases into the generic `ManualTestCase` shape used by `@continuum8032/playwright-ai-tools`.
+
+```bash
+ZEPHYR_SCALE_API_TOKEN=... npx -p @continuum8032/playwright-ai-test-management playwright-ai-tms pull --provider zephyr-scale --project PAY --out manual-cases.json
+QASE_API_TOKEN=... npx -p @continuum8032/playwright-ai-test-management playwright-ai-tms pull --provider qase --project PAY --out manual-cases.json
+TESTINY_API_KEY=... npx -p @continuum8032/playwright-ai-test-management playwright-ai-tms pull --provider testiny --project PAY --out manual-cases.json
+```
+
+The adapters do not publish results, statuses, or attachments back to the source system. Tokens are read from environment variables and redacted from CLI errors.

package/dist/index.cjs

@@ -0,0 +1,278 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createTestManagementProvider: () => createTestManagementProvider,
+  main: () => main
+});
+module.exports = __toCommonJS(index_exports);
+var import_promises = require("fs/promises");
+var import_node_path = __toESM(require("path"), 1);
+var DEFAULT_BASE_URLS = {
+  "zephyr-scale": "https://api.zephyrscale.smartbear.com/v2",
+  qase: "https://api.qase.io/v1",
+  testiny: "https://app.testiny.io/api/v1"
+};
+async function defaultTransport(url, init) {
+  return fetch(url, init);
+}
+function trimSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function stringValue(value) {
+  if (value === null || value === void 0) return void 0;
+  const text = String(value).trim();
+  return text || void 0;
+}
+function listValue(value) {
+  return Array.isArray(value) ? value : [];
+}
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function compact(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0 && item !== "" && item !== null));
+}
+function mapSteps(rawSteps, mapper) {
+  return rawSteps.map((step, index) => mapper(recordValue(step), index)).filter((step) => step.action || step.expected);
+}
+async function readJson(response, provider) {
+  if (!response.ok) {
+    const body = response.text ? await response.text().catch(() => "") : "";
+    throw new Error(`${provider} request failed with status ${response.status}${body ? `: ${body}` : ""}`);
+  }
+  return response.json();
+}
+function source(provider, project, url) {
+  return compact({ provider, project, url });
+}
+function labelsFrom(value) {
+  return listValue(value).map((item) => typeof item === "string" ? item : stringValue(recordValue(item).title || recordValue(item).name)).filter((item) => Boolean(item));
+}
+function qaseArtifacts(value) {
+  return listValue(value).map((item) => stringValue(item)).filter((item) => Boolean(item)).map((hash) => ({ type: "attachment", path: hash, metadata: { hash } }));
+}
+function testinyArtifacts(value) {
+  const artifacts = [];
+  for (const item of listValue(value)) {
+    const attachment = recordValue(item);
+    const id = stringValue(attachment.id);
+    if (!id) continue;
+    artifacts.push(
+      compact({
+        type: "attachment",
+        path: id,
+        contentType: stringValue(attachment.mimeType || attachment.contentType),
+        metadata: compact({ filename: stringValue(attachment.filename || attachment.name) })
+      })
+    );
+  }
+  return artifacts;
+}
+var ZephyrScaleProvider = class {
+  constructor(baseUrl, token, transport) {
+    this.baseUrl = baseUrl;
+    this.token = token;
+    this.transport = transport;
+  }
+  async listCases(input) {
+    const url = new URL(`${trimSlash(this.baseUrl)}/testcases`);
+    url.searchParams.set("projectKey", input.project);
+    url.searchParams.set("maxResults", String(input.limit ?? 50));
+    if (input.query) url.searchParams.set("query", input.query);
+    const payload = recordValue(await readJson(await this.transport(url.toString(), {
+      method: "GET",
+      headers: { authorization: `Bearer ${this.token}`, accept: "application/json" }
+    }), "zephyr-scale"));
+    return listValue(payload.values || payload.items || payload.data).map((item) => this.normalizeCase(recordValue(item), input.project));
+  }
+  normalizeCase(item, project) {
+    const script = recordValue(item.testScript);
+    const links = recordValue(item.links);
+    const webLink = recordValue(listValue(links.webLinks)[0]);
+    return {
+      id: stringValue(item.id) || stringValue(item.key) || "unknown",
+      key: stringValue(item.key),
+      title: stringValue(item.name || item.title) || "Untitled manual case",
+      description: stringValue(item.objective || item.description),
+      preconditions: stringValue(item.precondition || item.preconditions),
+      labels: labelsFrom(item.labels),
+      steps: mapSteps(listValue(script.steps || item.steps), (step, index) => ({
+        index: index + 1,
+        action: stringValue(step.description || step.action || step.name) || "",
+        expected: stringValue(step.expectedResult || step.expected || step.expected_result)
+      })),
+      source: source("zephyr-scale", project, stringValue(webLink.url)),
+      metadata: compact({ rawStatus: stringValue(recordValue(item.status).name || item.status) })
+    };
+  }
+};
+var QaseProvider = class {
+  constructor(baseUrl, token, transport) {
+    this.baseUrl = baseUrl;
+    this.token = token;
+    this.transport = transport;
+  }
+  async listCases(input) {
+    const url = new URL(`${trimSlash(this.baseUrl)}/case/${encodeURIComponent(input.project)}`);
+    url.searchParams.set("limit", String(input.limit ?? 50));
+    if (input.query) url.searchParams.set("search", input.query);
+    const payload = recordValue(await readJson(await this.transport(url.toString(), {
+      method: "GET",
+      headers: { Token: this.token, accept: "application/json" }
+    }), "qase"));
+    const result = recordValue(payload.result);
+    return listValue(result.entities || payload.entities || payload.data).map((item) => this.normalizeCase(recordValue(item), input.project));
+  }
+  normalizeCase(item, project) {
+    const caseNumber = stringValue(item.case_id || item.caseId || item.id);
+    return {
+      id: stringValue(item.id) || caseNumber || "unknown",
+      key: caseNumber ? `${project}-${caseNumber}` : void 0,
+      title: stringValue(item.title) || "Untitled manual case",
+      description: stringValue(item.description),
+      preconditions: stringValue(item.preconditions || item.precondition),
+      labels: labelsFrom(item.tags),
+      artifacts: qaseArtifacts(item.attachments),
+      steps: mapSteps(listValue(item.steps), (step, index) => ({
+        index: index + 1,
+        action: stringValue(step.action || step.description) || "",
+        expected: stringValue(step.expected_result || step.expectedResult || step.expected)
+      })),
+      source: source("qase", project),
+      metadata: compact({ priority: stringValue(item.priority), severity: stringValue(item.severity) })
+    };
+  }
+};
+var TestinyProvider = class {
+  constructor(baseUrl, token, transport) {
+    this.baseUrl = baseUrl;
+    this.token = token;
+    this.transport = transport;
+  }
+  async listCases(input) {
+    const url = new URL(`${trimSlash(this.baseUrl)}/testcases`);
+    url.searchParams.set("project", input.project);
+    url.searchParams.set("limit", String(input.limit ?? 50));
+    if (input.query) url.searchParams.set("search", input.query);
+    const payload = recordValue(await readJson(await this.transport(url.toString(), {
+      method: "GET",
+      headers: { "X-Api-Key": this.token, accept: "application/json" }
+    }), "testiny"));
+    return listValue(payload.data || payload.items || payload.values).map((item) => this.normalizeCase(recordValue(item), input.project));
+  }
+  normalizeCase(item, project) {
+    return {
+      id: stringValue(item.id) || stringValue(item.key) || "unknown",
+      key: stringValue(item.key),
+      title: stringValue(item.title || item.name) || "Untitled manual case",
+      description: stringValue(item.description),
+      preconditions: stringValue(item.precondition || item.preconditions),
+      artifacts: testinyArtifacts(item.attachments),
+      steps: mapSteps(listValue(item.steps), (step, index) => ({
+        index: index + 1,
+        action: stringValue(step.action || step.description || step.title) || "",
+        expected: stringValue(step.expected || step.expectedResult || step.expected_result)
+      })),
+      source: source("testiny", project),
+      metadata: compact({ status: stringValue(item.status) })
+    };
+  }
+};
+function createTestManagementProvider(options) {
+  const baseUrl = options.baseUrl || DEFAULT_BASE_URLS[options.provider];
+  const transport = options.transport || defaultTransport;
+  if (!options.token) throw new Error(`Missing API token for ${options.provider}`);
+  if (options.provider === "zephyr-scale") return new ZephyrScaleProvider(baseUrl, options.token, transport);
+  if (options.provider === "qase") return new QaseProvider(baseUrl, options.token, transport);
+  if (options.provider === "testiny") return new TestinyProvider(baseUrl, options.token, transport);
+  throw new Error(`Unsupported test-management provider: ${String(options.provider)}`);
+}
+function argValue(args, name) {
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] : void 0;
+}
+function providerToken(provider, env) {
+  const token = provider === "zephyr-scale" ? env.ZEPHYR_SCALE_API_TOKEN : provider === "qase" ? env.QASE_API_TOKEN : env.TESTINY_API_KEY;
+  if (!token) throw new Error(`Missing token environment variable for ${provider}`);
+  return token;
+}
+function providerBaseUrl(provider, env) {
+  return (provider === "zephyr-scale" ? env.ZEPHYR_SCALE_BASE_URL : provider === "qase" ? env.QASE_BASE_URL : env.TESTINY_BASE_URL) || DEFAULT_BASE_URLS[provider];
+}
+function redactSecrets(message, tokens) {
+  return tokens.filter(Boolean).reduce((value, token) => value.split(token).join("[REDACTED]"), message).replace(/\b(authorization\s*:\s*bearer)\s+[A-Za-z0-9._~+/-]+=*/gi, "$1 [REDACTED]").replace(/\b(Token|X-Api-Key)\s*:\s*[^\s,}]+/gi, "$1: [REDACTED]");
+}
+async function writeJson(output, payload) {
+  await (0, import_promises.mkdir)(import_node_path.default.dirname(output), { recursive: true });
+  await (0, import_promises.writeFile)(output, `${JSON.stringify(payload, null, 2)}
+`, "utf8");
+}
+async function main(argv = process.argv.slice(2), env = process.env, transport = defaultTransport) {
+  const [command, ...rest] = argv;
+  const secrets = [];
+  try {
+    if (command !== "pull") {
+      throw new Error("Usage: playwright-ai-tms pull --provider <zephyr-scale|qase|testiny> --project <id> --out <manual-cases.json>");
+    }
+    const provider = argValue(rest, "--provider");
+    const project = argValue(rest, "--project");
+    const out = argValue(rest, "--out");
+    if (!provider || !["zephyr-scale", "qase", "testiny"].includes(provider)) throw new Error("Missing --provider <zephyr-scale|qase|testiny>");
+    if (!project) throw new Error("Missing --project <id>");
+    if (!out) throw new Error("Missing --out <manual-cases.json>");
+    const token = providerToken(provider, env);
+    secrets.push(token);
+    const adapter = createTestManagementProvider({
+      provider,
+      token,
+      baseUrl: providerBaseUrl(provider, env),
+      transport
+    });
+    const cases = await adapter.listCases({ project });
+    await writeJson(out, cases);
+    console.log(`Wrote ${cases.length} manual case${cases.length === 1 ? "" : "s"} to ${out}`);
+  } catch (error) {
+    throw new Error(redactSecrets(error?.message || String(error), secrets));
+  }
+}
+if (process.argv[1] && /(?:playwright-ai-tms|index\.(?:cjs|js|ts))$/.test(import_node_path.default.basename(process.argv[1]))) {
+  main().catch((error) => {
+    console.error(error.message);
+    process.exit(1);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createTestManagementProvider,
+  main
+});

package/dist/index.d.cts

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+interface ManualTestArtifact {
+    type: string;
+    path?: string;
+    url?: string;
+    contentType?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ManualTestStep {
+    index?: number;
+    action: string;
+    expected?: string;
+    data?: Record<string, unknown>;
+    artifacts?: ManualTestArtifact[];
+}
+interface ManualTestCase {
+    id: string;
+    key?: string;
+    title: string;
+    description?: string;
+    preconditions?: string;
+    steps: ManualTestStep[];
+    artifacts?: ManualTestArtifact[];
+    labels?: string[];
+    source?: {
+        provider?: string;
+        project?: string;
+        url?: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+interface ManualTestCaseQuery {
+    project: string;
+    query?: string;
+    limit?: number;
+}
+interface ManualTestProvider {
+    listCases(input: ManualTestCaseQuery): Promise<ManualTestCase[]>;
+}
+
+type TmsProviderName = 'zephyr-scale' | 'qase' | 'testiny';
+interface TmsTransportResponse {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+    text?(): Promise<string>;
+}
+type TmsTransport = (url: string, init: {
+    method?: string;
+    headers: Record<string, string>;
+}) => Promise<TmsTransportResponse>;
+interface TestManagementAdapterOptions {
+    provider: TmsProviderName;
+    token: string;
+    baseUrl?: string;
+    transport?: TmsTransport;
+}
+declare function createTestManagementProvider(options: TestManagementAdapterOptions): ManualTestProvider;
+declare function main(argv?: string[], env?: Record<string, string | undefined>, transport?: TmsTransport): Promise<void>;
+
+export { type TestManagementAdapterOptions, type TmsProviderName, type TmsTransport, type TmsTransportResponse, createTestManagementProvider, main };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+interface ManualTestArtifact {
+    type: string;
+    path?: string;
+    url?: string;
+    contentType?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ManualTestStep {
+    index?: number;
+    action: string;
+    expected?: string;
+    data?: Record<string, unknown>;
+    artifacts?: ManualTestArtifact[];
+}
+interface ManualTestCase {
+    id: string;
+    key?: string;
+    title: string;
+    description?: string;
+    preconditions?: string;
+    steps: ManualTestStep[];
+    artifacts?: ManualTestArtifact[];
+    labels?: string[];
+    source?: {
+        provider?: string;
+        project?: string;
+        url?: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+interface ManualTestCaseQuery {
+    project: string;
+    query?: string;
+    limit?: number;
+}
+interface ManualTestProvider {
+    listCases(input: ManualTestCaseQuery): Promise<ManualTestCase[]>;
+}
+
+type TmsProviderName = 'zephyr-scale' | 'qase' | 'testiny';
+interface TmsTransportResponse {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+    text?(): Promise<string>;
+}
+type TmsTransport = (url: string, init: {
+    method?: string;
+    headers: Record<string, string>;
+}) => Promise<TmsTransportResponse>;
+interface TestManagementAdapterOptions {
+    provider: TmsProviderName;
+    token: string;
+    baseUrl?: string;
+    transport?: TmsTransport;
+}
+declare function createTestManagementProvider(options: TestManagementAdapterOptions): ManualTestProvider;
+declare function main(argv?: string[], env?: Record<string, string | undefined>, transport?: TmsTransport): Promise<void>;
+
+export { type TestManagementAdapterOptions, type TmsProviderName, type TmsTransport, type TmsTransportResponse, createTestManagementProvider, main };

package/dist/index.js

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { mkdir, writeFile } from "fs/promises";
+import path from "path";
+var DEFAULT_BASE_URLS = {
+  "zephyr-scale": "https://api.zephyrscale.smartbear.com/v2",
+  qase: "https://api.qase.io/v1",
+  testiny: "https://app.testiny.io/api/v1"
+};
+async function defaultTransport(url, init) {
+  return fetch(url, init);
+}
+function trimSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function stringValue(value) {
+  if (value === null || value === void 0) return void 0;
+  const text = String(value).trim();
+  return text || void 0;
+}
+function listValue(value) {
+  return Array.isArray(value) ? value : [];
+}
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function compact(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0 && item !== "" && item !== null));
+}
+function mapSteps(rawSteps, mapper) {
+  return rawSteps.map((step, index) => mapper(recordValue(step), index)).filter((step) => step.action || step.expected);
+}
+async function readJson(response, provider) {
+  if (!response.ok) {
+    const body = response.text ? await response.text().catch(() => "") : "";
+    throw new Error(`${provider} request failed with status ${response.status}${body ? `: ${body}` : ""}`);
+  }
+  return response.json();
+}
+function source(provider, project, url) {
+  return compact({ provider, project, url });
+}
+function labelsFrom(value) {
+  return listValue(value).map((item) => typeof item === "string" ? item : stringValue(recordValue(item).title || recordValue(item).name)).filter((item) => Boolean(item));
+}
+function qaseArtifacts(value) {
+  return listValue(value).map((item) => stringValue(item)).filter((item) => Boolean(item)).map((hash) => ({ type: "attachment", path: hash, metadata: { hash } }));
+}
+function testinyArtifacts(value) {
+  const artifacts = [];
+  for (const item of listValue(value)) {
+    const attachment = recordValue(item);
+    const id = stringValue(attachment.id);
+    if (!id) continue;
+    artifacts.push(
+      compact({
+        type: "attachment",
+        path: id,
+        contentType: stringValue(attachment.mimeType || attachment.contentType),
+        metadata: compact({ filename: stringValue(attachment.filename || attachment.name) })
+      })
+    );
+  }
+  return artifacts;
+}
+var ZephyrScaleProvider = class {
+  constructor(baseUrl, token, transport) {
+    this.baseUrl = baseUrl;
+    this.token = token;
+    this.transport = transport;
+  }
+  async listCases(input) {
+    const url = new URL(`${trimSlash(this.baseUrl)}/testcases`);
+    url.searchParams.set("projectKey", input.project);
+    url.searchParams.set("maxResults", String(input.limit ?? 50));
+    if (input.query) url.searchParams.set("query", input.query);
+    const payload = recordValue(await readJson(await this.transport(url.toString(), {
+      method: "GET",
+      headers: { authorization: `Bearer ${this.token}`, accept: "application/json" }
+    }), "zephyr-scale"));
+    return listValue(payload.values || payload.items || payload.data).map((item) => this.normalizeCase(recordValue(item), input.project));
+  }
+  normalizeCase(item, project) {
+    const script = recordValue(item.testScript);
+    const links = recordValue(item.links);
+    const webLink = recordValue(listValue(links.webLinks)[0]);
+    return {
+      id: stringValue(item.id) || stringValue(item.key) || "unknown",
+      key: stringValue(item.key),
+      title: stringValue(item.name || item.title) || "Untitled manual case",
+      description: stringValue(item.objective || item.description),
+      preconditions: stringValue(item.precondition || item.preconditions),
+      labels: labelsFrom(item.labels),
+      steps: mapSteps(listValue(script.steps || item.steps), (step, index) => ({
+        index: index + 1,
+        action: stringValue(step.description || step.action || step.name) || "",
+        expected: stringValue(step.expectedResult || step.expected || step.expected_result)
+      })),
+      source: source("zephyr-scale", project, stringValue(webLink.url)),
+      metadata: compact({ rawStatus: stringValue(recordValue(item.status).name || item.status) })
+    };
+  }
+};
+var QaseProvider = class {
+  constructor(baseUrl, token, transport) {
+    this.baseUrl = baseUrl;
+    this.token = token;
+    this.transport = transport;
+  }
+  async listCases(input) {
+    const url = new URL(`${trimSlash(this.baseUrl)}/case/${encodeURIComponent(input.project)}`);
+    url.searchParams.set("limit", String(input.limit ?? 50));
+    if (input.query) url.searchParams.set("search", input.query);
+    const payload = recordValue(await readJson(await this.transport(url.toString(), {
+      method: "GET",
+      headers: { Token: this.token, accept: "application/json" }
+    }), "qase"));
+    const result = recordValue(payload.result);
+    return listValue(result.entities || payload.entities || payload.data).map((item) => this.normalizeCase(recordValue(item), input.project));
+  }
+  normalizeCase(item, project) {
+    const caseNumber = stringValue(item.case_id || item.caseId || item.id);
+    return {
+      id: stringValue(item.id) || caseNumber || "unknown",
+      key: caseNumber ? `${project}-${caseNumber}` : void 0,
+      title: stringValue(item.title) || "Untitled manual case",
+      description: stringValue(item.description),
+      preconditions: stringValue(item.preconditions || item.precondition),
+      labels: labelsFrom(item.tags),
+      artifacts: qaseArtifacts(item.attachments),
+      steps: mapSteps(listValue(item.steps), (step, index) => ({
+        index: index + 1,
+        action: stringValue(step.action || step.description) || "",
+        expected: stringValue(step.expected_result || step.expectedResult || step.expected)
+      })),
+      source: source("qase", project),
+      metadata: compact({ priority: stringValue(item.priority), severity: stringValue(item.severity) })
+    };
+  }
+};
+var TestinyProvider = class {
+  constructor(baseUrl, token, transport) {
+    this.baseUrl = baseUrl;
+    this.token = token;
+    this.transport = transport;
+  }
+  async listCases(input) {
+    const url = new URL(`${trimSlash(this.baseUrl)}/testcases`);
+    url.searchParams.set("project", input.project);
+    url.searchParams.set("limit", String(input.limit ?? 50));
+    if (input.query) url.searchParams.set("search", input.query);
+    const payload = recordValue(await readJson(await this.transport(url.toString(), {
+      method: "GET",
+      headers: { "X-Api-Key": this.token, accept: "application/json" }
+    }), "testiny"));
+    return listValue(payload.data || payload.items || payload.values).map((item) => this.normalizeCase(recordValue(item), input.project));
+  }
+  normalizeCase(item, project) {
+    return {
+      id: stringValue(item.id) || stringValue(item.key) || "unknown",
+      key: stringValue(item.key),
+      title: stringValue(item.title || item.name) || "Untitled manual case",
+      description: stringValue(item.description),
+      preconditions: stringValue(item.precondition || item.preconditions),
+      artifacts: testinyArtifacts(item.attachments),
+      steps: mapSteps(listValue(item.steps), (step, index) => ({
+        index: index + 1,
+        action: stringValue(step.action || step.description || step.title) || "",
+        expected: stringValue(step.expected || step.expectedResult || step.expected_result)
+      })),
+      source: source("testiny", project),
+      metadata: compact({ status: stringValue(item.status) })
+    };
+  }
+};
+function createTestManagementProvider(options) {
+  const baseUrl = options.baseUrl || DEFAULT_BASE_URLS[options.provider];
+  const transport = options.transport || defaultTransport;
+  if (!options.token) throw new Error(`Missing API token for ${options.provider}`);
+  if (options.provider === "zephyr-scale") return new ZephyrScaleProvider(baseUrl, options.token, transport);
+  if (options.provider === "qase") return new QaseProvider(baseUrl, options.token, transport);
+  if (options.provider === "testiny") return new TestinyProvider(baseUrl, options.token, transport);
+  throw new Error(`Unsupported test-management provider: ${String(options.provider)}`);
+}
+function argValue(args, name) {
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] : void 0;
+}
+function providerToken(provider, env) {
+  const token = provider === "zephyr-scale" ? env.ZEPHYR_SCALE_API_TOKEN : provider === "qase" ? env.QASE_API_TOKEN : env.TESTINY_API_KEY;
+  if (!token) throw new Error(`Missing token environment variable for ${provider}`);
+  return token;
+}
+function providerBaseUrl(provider, env) {
+  return (provider === "zephyr-scale" ? env.ZEPHYR_SCALE_BASE_URL : provider === "qase" ? env.QASE_BASE_URL : env.TESTINY_BASE_URL) || DEFAULT_BASE_URLS[provider];
+}
+function redactSecrets(message, tokens) {
+  return tokens.filter(Boolean).reduce((value, token) => value.split(token).join("[REDACTED]"), message).replace(/\b(authorization\s*:\s*bearer)\s+[A-Za-z0-9._~+/-]+=*/gi, "$1 [REDACTED]").replace(/\b(Token|X-Api-Key)\s*:\s*[^\s,}]+/gi, "$1: [REDACTED]");
+}
+async function writeJson(output, payload) {
+  await mkdir(path.dirname(output), { recursive: true });
+  await writeFile(output, `${JSON.stringify(payload, null, 2)}
+`, "utf8");
+}
+async function main(argv = process.argv.slice(2), env = process.env, transport = defaultTransport) {
+  const [command, ...rest] = argv;
+  const secrets = [];
+  try {
+    if (command !== "pull") {
+      throw new Error("Usage: playwright-ai-tms pull --provider <zephyr-scale|qase|testiny> --project <id> --out <manual-cases.json>");
+    }
+    const provider = argValue(rest, "--provider");
+    const project = argValue(rest, "--project");
+    const out = argValue(rest, "--out");
+    if (!provider || !["zephyr-scale", "qase", "testiny"].includes(provider)) throw new Error("Missing --provider <zephyr-scale|qase|testiny>");
+    if (!project) throw new Error("Missing --project <id>");
+    if (!out) throw new Error("Missing --out <manual-cases.json>");
+    const token = providerToken(provider, env);
+    secrets.push(token);
+    const adapter = createTestManagementProvider({
+      provider,
+      token,
+      baseUrl: providerBaseUrl(provider, env),
+      transport
+    });
+    const cases = await adapter.listCases({ project });
+    await writeJson(out, cases);
+    console.log(`Wrote ${cases.length} manual case${cases.length === 1 ? "" : "s"} to ${out}`);
+  } catch (error) {
+    throw new Error(redactSecrets(error?.message || String(error), secrets));
+  }
+}
+if (process.argv[1] && /(?:playwright-ai-tms|index\.(?:cjs|js|ts))$/.test(path.basename(process.argv[1]))) {
+  main().catch((error) => {
+    console.error(error.message);
+    process.exit(1);
+  });
+}
+export {
+  createTestManagementProvider,
+  main
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@continuum8032/playwright-ai-test-management",
+  "version": "0.2.0-oidc-bootstrap.0",
+  "description": "Optional read-only test-management adapters for playwright-ai-tools.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Continuum8032/codex-playwright-tools.git",
+    "directory": "integrations/test-management"
+  },
+  "homepage": "https://github.com/Continuum8032/codex-playwright-tools#readme",
+  "bugs": {
+    "url": "https://github.com/Continuum8032/codex-playwright-tools/issues"
+  },
+  "keywords": [
+    "playwright",
+    "testing",
+    "test-management",
+    "qase",
+    "zephyr",
+    "testiny"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "playwright-ai-tms": "./dist/index.cjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean"
+  },
+  "peerDependencies": {
+    "@continuum8032/playwright-ai-tools": "0.2.0-oidc-bootstrap.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3"
+  }
+}