@ivorycanvas/qamap 0.3.0

package/dist/domains.d.ts

@@ -0,0 +1,33 @@
+import type { TestPlanChangedFile } from "./test-plan.js";
+export declare const defaultDomainManifestPath = ".qamap/domains.yml";
+export interface DomainScenarioDefinition {
+    title: string;
+    checks: string[];
+}
+export interface DomainDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    aliases: string[];
+    files: string[];
+    routes: string[];
+    tags: string[];
+    scenarios: DomainScenarioDefinition[];
+}
+export interface DomainManifest {
+    path?: string;
+    domains: DomainDefinition[];
+}
+export interface MatchedDomain {
+    id: string;
+    name: string;
+    reason: string;
+    matchedFiles: string[];
+    matchedSignals: string[];
+    aliases: string[];
+    routes: string[];
+    scenarios: DomainScenarioDefinition[];
+}
+export declare function loadDomainManifest(rootInput: string): Promise<DomainManifest>;
+export declare function matchDomains(manifest: DomainManifest, changedFiles: TestPlanChangedFile[]): MatchedDomain[];
+export declare function writeDefaultDomainManifest(rootInput: string, fileName?: string, force?: boolean): Promise<string>;

package/dist/domains.js

@@ -0,0 +1,258 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { pathExists, toPosixPath } from "./fs.js";
+export const defaultDomainManifestPath = ".qamap/domains.yml";
+const domainManifestCandidates = [
+    ".qamap/domains.yml",
+    ".qamap/domains.yaml",
+    ".qamap/domains.json",
+];
+export async function loadDomainManifest(rootInput) {
+    const root = path.resolve(rootInput);
+    const manifestPath = await findDomainManifestPath(root);
+    if (!manifestPath) {
+        return { domains: [] };
+    }
+    const raw = await fs.readFile(manifestPath, "utf8");
+    const parsed = parseDomainManifest(raw, manifestPath);
+    return {
+        path: toPosixPath(path.relative(root, manifestPath)),
+        domains: normalizeDomains(parsed, manifestPath),
+    };
+}
+export function matchDomains(manifest, changedFiles) {
+    if (manifest.domains.length === 0 || changedFiles.length === 0) {
+        return [];
+    }
+    const files = changedFiles.map((file) => file.path);
+    return manifest.domains
+        .map((domain) => matchDomain(domain, files))
+        .filter((domain) => Boolean(domain))
+        .sort((left, right) => right.matchedFiles.length + right.matchedSignals.length - (left.matchedFiles.length + left.matchedSignals.length))
+        .slice(0, 12);
+}
+export async function writeDefaultDomainManifest(rootInput, fileName = defaultDomainManifestPath, force = false) {
+    const root = path.resolve(rootInput);
+    const outputPath = path.resolve(root, fileName);
+    if (!force && (await pathExists(outputPath))) {
+        throw new Error(`Refusing to overwrite ${outputPath}. Pass --force to replace it.`);
+    }
+    await fs.mkdir(path.dirname(outputPath), { recursive: true });
+    await fs.writeFile(outputPath, defaultDomainManifestText(), "utf8");
+    return outputPath;
+}
+function matchDomain(domain, changedFiles) {
+    const matchedFiles = new Set();
+    const matchedSignals = new Set();
+    const domainTokens = [domain.id, domain.name, ...domain.aliases].map(normalizeToken).filter(Boolean);
+    for (const file of changedFiles) {
+        if (domain.files.some((pattern) => matchesPathPattern(file, pattern))) {
+            matchedFiles.add(file);
+            matchedSignals.add("file pattern");
+        }
+        const fileTokens = pathTokens(file);
+        for (const token of domainTokens) {
+            if (fileTokens.includes(token)) {
+                matchedFiles.add(file);
+                matchedSignals.add(`domain:${token}`);
+            }
+        }
+        for (const route of domain.routes) {
+            const routeSignal = normalizeRoute(route);
+            if (routeSignal && normalizePathForMatch(file).includes(routeSignal)) {
+                matchedFiles.add(file);
+                matchedSignals.add(`route:${route}`);
+            }
+        }
+        for (const tag of domain.tags) {
+            const normalizedTag = normalizeToken(tag);
+            if (normalizedTag && fileTokens.includes(normalizedTag)) {
+                matchedFiles.add(file);
+                matchedSignals.add(`tag:${tag}`);
+            }
+        }
+    }
+    if (matchedFiles.size === 0) {
+        return undefined;
+    }
+    const signals = [...matchedSignals];
+    return {
+        id: domain.id,
+        name: domain.name,
+        reason: `Changed files match ${signals.slice(0, 4).join(", ")} for this declared domain.`,
+        matchedFiles: [...matchedFiles].slice(0, 20),
+        matchedSignals: signals.slice(0, 12),
+        aliases: domain.aliases.slice(0, 10),
+        routes: domain.routes.slice(0, 10),
+        scenarios: domain.scenarios.slice(0, 6),
+    };
+}
+function parseDomainManifest(raw, manifestPath) {
+    try {
+        if (/\.json$/i.test(manifestPath)) {
+            return JSON.parse(raw);
+        }
+        return YAML.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not parse QAMap domain manifest at ${manifestPath}: ${message}`);
+    }
+}
+function normalizeDomains(value, manifestPath) {
+    const record = asRecord(value, `QAMap domain manifest must be an object: ${manifestPath}`);
+    const rawDomains = record.domains;
+    if (!Array.isArray(rawDomains)) {
+        throw new Error(`QAMap domain manifest domains must be an array: ${manifestPath}`);
+    }
+    return rawDomains.map((domain, index) => normalizeDomain(domain, manifestPath, index));
+}
+function normalizeDomain(value, manifestPath, index) {
+    const record = asRecord(value, `QAMap domain manifest domain at index ${index} must be an object: ${manifestPath}`);
+    const id = readRequiredString(record, "id", manifestPath, index);
+    const name = readOptionalString(record, "name") ?? readOptionalString(record, "title") ?? id;
+    const aliases = readStringArray(record, "aliases");
+    const files = readStringArray(record, "files");
+    const routes = readStringArray(record, "routes");
+    const tags = readStringArray(record, "tags");
+    const scenarios = readScenarioArray(record, "scenarios", manifestPath, index);
+    if (files.length + aliases.length + routes.length + tags.length === 0) {
+        throw new Error(`QAMap domain manifest domain ${id} must include at least one of aliases, files, routes, or tags: ${manifestPath}`);
+    }
+    return {
+        id,
+        name,
+        description: readOptionalString(record, "description"),
+        aliases,
+        files,
+        routes,
+        tags,
+        scenarios,
+    };
+}
+async function findDomainManifestPath(root) {
+    for (const candidate of domainManifestCandidates) {
+        const absolutePath = path.join(root, candidate);
+        if (await pathExists(absolutePath)) {
+            return absolutePath;
+        }
+    }
+    return undefined;
+}
+function readScenarioArray(record, key, manifestPath, domainIndex) {
+    const value = record[key];
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((item, index) => normalizeScenario(item, manifestPath, domainIndex, index))
+        .filter((item) => Boolean(item));
+}
+function normalizeScenario(value, manifestPath, domainIndex, scenarioIndex) {
+    if (typeof value === "string") {
+        const title = value.trim();
+        return title ? { title, checks: [] } : undefined;
+    }
+    const record = asRecord(value, `QAMap domain manifest scenario at domain ${domainIndex}, index ${scenarioIndex} must be a string or object: ${manifestPath}`);
+    const title = readOptionalString(record, "title") ?? readOptionalString(record, "name");
+    if (!title) {
+        throw new Error(`QAMap domain manifest scenario at domain ${domainIndex}, index ${scenarioIndex} is missing title: ${manifestPath}`);
+    }
+    return {
+        title,
+        checks: readStringArray(record, "checks"),
+    };
+}
+function matchesPathPattern(file, pattern) {
+    const normalizedFile = normalizePathForMatch(file);
+    const normalizedPattern = normalizePathForMatch(pattern);
+    if (!normalizedPattern) {
+        return false;
+    }
+    if (!normalizedPattern.includes("*")) {
+        return normalizedFile === normalizedPattern || normalizedFile.startsWith(`${normalizedPattern}/`);
+    }
+    const regex = new RegExp(`^${normalizedPattern
+        .split("**")
+        .map((part) => part.split("*").map(escapeRegex).join("[^/]*"))
+        .join(".*")}$`);
+    return regex.test(normalizedFile);
+}
+function pathTokens(file) {
+    return file
+        .replace(/\.[^.\/]+$/g, "")
+        .split("/")
+        .flatMap((part) => part.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^a-zA-Z0-9]+/))
+        .map(normalizeToken)
+        .filter(Boolean);
+}
+function normalizeRoute(route) {
+    return normalizePathForMatch(route).replace(/^\//, "");
+}
+function normalizePathForMatch(value) {
+    return toPosixPath(value).replace(/^\.\/+/, "").replace(/\/+$/g, "").toLowerCase();
+}
+function normalizeToken(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function asRecord(value, message) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(message);
+    }
+    return value;
+}
+function readRequiredString(record, key, manifestPath, index) {
+    const value = readOptionalString(record, key);
+    if (!value) {
+        throw new Error(`QAMap domain manifest domain at index ${index} is missing ${key}: ${manifestPath}`);
+    }
+    return value;
+}
+function readOptionalString(record, key) {
+    const value = record[key];
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function readStringArray(record, key) {
+    const value = record[key];
+    if (value === undefined) {
+        return [];
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        return [value.trim()];
+    }
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return [...new Set(value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean))];
+}
+function defaultDomainManifestText() {
+    return [
+        "# Commit this file when your team wants QAMap to know product/domain language.",
+        "domains:",
+        "  - id: billing",
+        "    name: Billing",
+        "    aliases:",
+        "      - checkout",
+        "      - subscription",
+        "    files:",
+        "      - src/features/billing/**",
+        "    routes:",
+        "      - /billing",
+        "    tags: []",
+        "    scenarios:",
+        "      - title: Billing primary journey",
+        "        checks:",
+        "          - Start from the normal billing entry point.",
+        "          - Complete the primary billing action with realistic data.",
+        "          - Confirm the visible result or saved state.",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=domains.js.map

package/dist/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":"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"}

package/dist/e2e.d.ts

@@ -0,0 +1,326 @@
+import type { TestPlanChangedFile, TestPlanOptions } from "./test-plan.js";
+import type { DomainLanguageSummary } from "./domain-language.js";
+import type { MatchedDomain } from "./domains.js";
+import type { MatchedCoreFlow } from "./flows.js";
+import type { VerificationManifestMatch } from "./manifest.js";
+import type { LocalHistoryReference } from "./history.js";
+import type { CoverageEvidence, TestSuiteSummary } from "./test-evidence.js";
+export type E2eProjectType = "expo-react-native" | "react-native" | "web" | "api-service" | "design-tokens" | "data-catalog" | "cli" | "unknown";
+export type E2eRunnerName = "maestro" | "playwright" | "manual";
+export type E2eEntrypointKind = "route" | "screen" | "command";
+export type E2eEntrypointConfidence = "high" | "medium" | "low";
+export type E2eSetupHintKind = "auth" | "network" | "fixture" | "environment" | "payment" | "state";
+export type E2eSetupHintConfidence = "high" | "medium" | "low";
+export type E2eExecutionProfileConfidence = "high" | "medium" | "low";
+export type E2eFixtureReadinessStatus = "ready" | "partial" | "missing" | "not-needed";
+export type E2eValidationMatrixStatus = "ready" | "partial" | "missing";
+export type E2eValidationMatrixCategory = "core-flow" | "coverage" | "fixture" | "testability" | "setup";
+export type E2eBootstrapStepStatus = "required" | "recommended" | "ready";
+export type E2eBootstrapStepCategory = "runner" | "draft" | "workspace" | "domain-language" | "core-flow" | "fixture" | "testability" | "validation" | "history";
+export type E2eSelectorKind = "test-id" | "input-test-id" | "accessibility-label" | "input-accessibility-label" | "visible-text" | "web-test-id" | "input-web-test-id" | "aria-label" | "input-aria-label" | "placeholder" | "role-button" | "role-link";
+export interface E2ePlanOptions extends TestPlanOptions {
+    runner?: E2eRunnerName;
+    manifestPath?: string;
+}
+export interface E2eDraftOptions extends E2ePlanOptions {
+    output?: string;
+    force?: boolean;
+    maxDrafts?: number;
+    dryRun?: boolean;
+}
+export interface E2eProjectProfile {
+    type: E2eProjectType;
+    evidence: string[];
+}
+export interface E2eRunnerRecommendation {
+    name: E2eRunnerName;
+    reason: string;
+}
+export interface E2eExecutionProfile {
+    runner: E2eRunnerName;
+    confidence: E2eExecutionProfileConfidence;
+    startCommand?: string;
+    testCommand?: string;
+    baseUrl?: string;
+    appId?: string;
+    configFiles: string[];
+    envFiles: string[];
+    evidence: string[];
+    blockers: string[];
+}
+export interface E2eWorkspaceTarget {
+    path: string;
+    packageName?: string;
+    project: E2eProjectProfile;
+    recommendedRunner: E2eRunnerRecommendation;
+    changedFiles: string[];
+    reason: string;
+    suggestedCommand: string;
+}
+export type E2eCoveragePriority = "critical" | "recommended" | "optional";
+export interface E2eCoverageTarget {
+    title: string;
+    priority: E2eCoveragePriority;
+    reason: string;
+    checks: string[];
+}
+export interface E2eFlowLanguageBrief {
+    actor: string;
+    trigger: string;
+    goal: string;
+    successSignal: string;
+    reviewQuestion: string;
+    edgeCases: string[];
+}
+export interface E2eFlow {
+    title: string;
+    reason: string;
+    files: string[];
+    steps: string[];
+    languageBrief: E2eFlowLanguageBrief;
+    coverage: E2eCoverageTarget[];
+    coverageEvidence: CoverageEvidence[];
+    entrypoints: E2eEntrypoint[];
+    setupHints: E2eSetupHint[];
+    fixtureReadiness: E2eFixtureReadiness;
+    selectors: E2eSelector[];
+    missingTestability: string[];
+}
+export interface E2eEntrypoint {
+    kind: E2eEntrypointKind;
+    value: string;
+    file: string;
+    confidence: E2eEntrypointConfidence;
+}
+export interface E2eSetupHint {
+    kind: E2eSetupHintKind;
+    title: string;
+    detail: string;
+    files: string[];
+    confidence: E2eSetupHintConfidence;
+}
+export interface E2eSelector {
+    kind: E2eSelectorKind;
+    value: string;
+    file: string;
+}
+export interface E2eFixtureReadiness {
+    status: E2eFixtureReadinessStatus;
+    reason: string;
+    apiSignals: string[];
+    apiEndpoints: string[];
+    backendSignals: string[];
+    mockSignals: string[];
+    nextActions: string[];
+}
+export interface E2eValidationMatrixRow {
+    area: string;
+    category: E2eValidationMatrixCategory;
+    requiredEvidence: string;
+    currentEvidence: string;
+    status: E2eValidationMatrixStatus;
+    nextAction: string;
+    flowTitle?: string;
+    files: string[];
+}
+export interface E2eValidationMatrix {
+    rows: E2eValidationMatrixRow[];
+    summary: {
+        ready: number;
+        partial: number;
+        missing: number;
+    };
+}
+export interface E2eBootstrapStep {
+    category: E2eBootstrapStepCategory;
+    status: E2eBootstrapStepStatus;
+    title: string;
+    reason: string;
+    action: string;
+    commands: string[];
+    files: string[];
+}
+export interface E2eBootstrapPlan {
+    summary: string;
+    steps: E2eBootstrapStep[];
+    counts: {
+        required: number;
+        recommended: number;
+        ready: number;
+    };
+}
+export interface E2ePlanResult {
+    tool: {
+        name: string;
+        version: string;
+    };
+    root: string;
+    workspaceRoot?: string;
+    generatedAt: string;
+    base: string;
+    head: string;
+    includeWorkingTree: boolean;
+    project: E2eProjectProfile;
+    recommendedRunner: E2eRunnerRecommendation;
+    executionProfile: E2eExecutionProfile;
+    runnerSetup: E2eRunnerSetupProposal;
+    testSuite: TestSuiteSummary;
+    coreFlowManifestPath?: string;
+    coreFlows: MatchedCoreFlow[];
+    domainManifestPath?: string;
+    domains: MatchedDomain[];
+    verificationManifestPath?: string;
+    verificationManifestMatches: VerificationManifestMatch[];
+    domainLanguage: DomainLanguageSummary;
+    changedFiles: TestPlanChangedFile[];
+    suggestedCommands: string[];
+    localHistory?: LocalHistoryReference;
+    workspaceTargets: E2eWorkspaceTarget[];
+    flows: E2eFlow[];
+    validationMatrix: E2eValidationMatrix;
+    bootstrap: E2eBootstrapPlan;
+    missingTestability: string[];
+    setupNotes: string[];
+}
+export type E2eRunnerSetupStatus = "ready" | "proposed" | "not-applicable";
+export interface E2eRunnerSetupProposal {
+    runner: E2eRunnerName;
+    status: E2eRunnerSetupStatus;
+    title: string;
+    reason: string;
+    setupCommand?: string;
+    installCommands: string[];
+    filesToCreate: string[];
+    filesToUpdate: string[];
+    nextCommands: string[];
+    notes: string[];
+}
+export interface E2eDraftFile {
+    path: string;
+    flowTitle: string;
+    runner: E2eRunnerName;
+    status: "created" | "skipped" | "preview";
+    source?: "verification-manifest" | "domain-language" | "core-flow" | "heuristic";
+    changedFiles?: string[];
+    draftSteps?: string[];
+    entrypointHints?: string[];
+    selectorHints?: string[];
+    setupHints?: string[];
+    coverageTargets?: string[];
+    manifestUpdatePath?: string;
+    languageBrief?: E2eFlowLanguageBrief;
+    actionItems?: E2eDraftActionItem[];
+    promotionStatus?: E2eDraftPromotionStatus;
+    promotionReason?: string;
+    promotionAction?: string;
+    stability?: "ready" | "needs-selector" | "needs-setup" | "needs-selector-and-setup";
+    runnableStatus?: "runnable-candidate" | "near-runnable" | "review-only";
+    executionBlockers?: string[];
+    selfCheck?: E2eDraftSelfCheck;
+    todoCount?: number;
+    entrypointCount?: number;
+    primaryEntrypoint?: string;
+    setupHintCount?: number;
+    fixtureReadinessStatus?: E2eFixtureReadinessStatus;
+    inferredSelectorCount?: number;
+    coverageTargetCount?: number;
+    validationStatus?: E2eValidationMatrixStatus;
+    validationGapCount?: number;
+    blockingValidationGapCount?: number;
+    reason?: string;
+}
+export type E2eDraftActionKind = "assertion" | "fixture" | "manifest" | "runner" | "selector" | "setup" | "validation";
+export type E2eDraftActionPriority = "required" | "recommended";
+export type E2eDraftSelfCheckStatus = "pass" | "warning" | "fail";
+export interface E2eDraftSelfCheckItem {
+    name: string;
+    status: E2eDraftSelfCheckStatus;
+    detail: string;
+}
+export interface E2eDraftSelfCheck {
+    status: E2eDraftSelfCheckStatus;
+    summary: string;
+    command?: string;
+    checks: E2eDraftSelfCheckItem[];
+    blockers: string[];
+}
+export interface E2eDraftActionItem {
+    kind: E2eDraftActionKind;
+    priority: E2eDraftActionPriority;
+    title: string;
+    detail: string;
+}
+export interface E2eDraftActionKindSummary {
+    kind: E2eDraftActionKind;
+    required: number;
+    recommended: number;
+    total: number;
+}
+export interface E2eDraftActionSummary {
+    required: number;
+    recommended: number;
+    readyFiles: number;
+    filesWithRequiredActions: number;
+    filesWithRecommendedActions: number;
+    byKind: E2eDraftActionKindSummary[];
+}
+export type E2eDraftPromotionStatus = "commit-candidate" | "needs-review" | "low-signal";
+export type E2eDraftReadinessLevel = "ready" | "near-runnable" | "needs-work" | "blocked";
+export interface E2eDraftReadinessSummary {
+    score: number;
+    level: E2eDraftReadinessLevel;
+    recommendation: string;
+    runnableCandidates: number;
+    nearRunnable: number;
+    reviewOnly: number;
+    selfCheckPass: number;
+    selfCheckWarning: number;
+    selfCheckFail: number;
+    filesWithTodos: number;
+    totalTodos: number;
+    filesWithExecutionBlockers: number;
+    totalExecutionBlockers: number;
+    topBlockers: string[];
+}
+export interface E2eDraftResult {
+    tool: {
+        name: string;
+        version: string;
+    };
+    root: string;
+    generatedAt: string;
+    runner: E2eRunnerName;
+    outputDirectory: string;
+    dryRun: boolean;
+    plan: E2ePlanResult;
+    files: E2eDraftFile[];
+    actionSummary: E2eDraftActionSummary;
+    readinessSummary: E2eDraftReadinessSummary;
+    nextSteps: string[];
+}
+export interface E2eSetupOptions extends E2ePlanOptions {
+    force?: boolean;
+}
+export interface E2eSetupResult {
+    tool: {
+        name: string;
+        version: string;
+    };
+    root: string;
+    runner: E2eRunnerName;
+    proposal: E2eRunnerSetupProposal;
+    createdFiles: string[];
+    updatedFiles: string[];
+    skippedFiles: string[];
+    installCommands: string[];
+    nextCommands: string[];
+    draftOutputDirectory?: string;
+    draftFiles: E2eDraftFile[];
+    draftReadinessSummary?: E2eDraftReadinessSummary;
+}
+export declare function generateE2ePlan(rootInput: string, options?: E2ePlanOptions): Promise<E2ePlanResult>;
+export declare function generateE2eDraft(rootInput: string, options?: E2eDraftOptions): Promise<E2eDraftResult>;
+export declare function formatMarkdownE2ePlan(result: E2ePlanResult): string;
+export declare function formatMarkdownE2eDraft(result: E2eDraftResult): string;
+export declare function formatMarkdownE2eSetup(result: E2eSetupResult): string;
+export declare function setupE2eRunner(rootInput: string, options?: E2eSetupOptions): Promise<E2eSetupResult>;