@ivorycanvas/qamap 0.3.0

package/dist/flows.js

@@ -0,0 +1,246 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { pathExists, toPosixPath } from "./fs.js";
+export const defaultFlowManifestPath = ".qamap/flows.yml";
+const flowManifestCandidates = [
+    ".qamap/flows.yml",
+    ".qamap/flows.yaml",
+    ".qamap/flows.json",
+];
+const priorityWeights = {
+    critical: 3,
+    recommended: 2,
+    optional: 1,
+};
+export async function loadCoreFlowManifest(rootInput) {
+    const root = path.resolve(rootInput);
+    const manifestPath = await findFlowManifestPath(root);
+    if (!manifestPath) {
+        return { flows: [] };
+    }
+    const raw = await fs.readFile(manifestPath, "utf8");
+    const parsed = parseFlowManifest(raw, manifestPath);
+    return {
+        path: toPosixPath(path.relative(root, manifestPath)),
+        flows: normalizeCoreFlows(parsed, manifestPath),
+    };
+}
+export function matchCoreFlows(manifest, changedFiles) {
+    if (manifest.flows.length === 0 || changedFiles.length === 0) {
+        return [];
+    }
+    const files = changedFiles.map((file) => file.path);
+    return manifest.flows
+        .map((flow) => matchCoreFlow(flow, files))
+        .filter((flow) => Boolean(flow))
+        .sort((left, right) => {
+        const priorityDiff = priorityWeights[right.priority] - priorityWeights[left.priority];
+        if (priorityDiff !== 0) {
+            return priorityDiff;
+        }
+        return right.matchedFiles.length + right.matchedSignals.length - (left.matchedFiles.length + left.matchedSignals.length);
+    })
+        .slice(0, 10);
+}
+export async function writeDefaultCoreFlowManifest(rootInput, fileName = defaultFlowManifestPath, 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, defaultCoreFlowManifestText(), "utf8");
+    return outputPath;
+}
+function matchCoreFlow(flow, changedFiles) {
+    const matchedFiles = new Set();
+    const matchedSignals = new Set();
+    for (const file of changedFiles) {
+        if (flow.files.some((pattern) => matchesPathPattern(file, pattern))) {
+            matchedFiles.add(file);
+            matchedSignals.add("file pattern");
+        }
+        const fileTokens = pathTokens(file);
+        for (const domain of flow.domains) {
+            const normalizedDomain = normalizeToken(domain);
+            if (normalizedDomain && fileTokens.includes(normalizedDomain)) {
+                matchedFiles.add(file);
+                matchedSignals.add(`domain:${domain}`);
+            }
+        }
+        for (const route of flow.routes) {
+            const routeSignal = normalizeRoute(route);
+            if (routeSignal && normalizePathForMatch(file).includes(routeSignal)) {
+                matchedFiles.add(file);
+                matchedSignals.add(`route:${route}`);
+            }
+        }
+        for (const tag of flow.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: flow.id,
+        name: flow.name,
+        priority: flow.priority,
+        reason: `Changed files match ${signals.slice(0, 4).join(", ")} for this declared core flow.`,
+        matchedFiles: [...matchedFiles].slice(0, 20),
+        matchedSignals: signals.slice(0, 12),
+        routes: flow.routes.slice(0, 10),
+        checks: flow.checks.slice(0, 10),
+    };
+}
+function parseFlowManifest(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 flow manifest at ${manifestPath}: ${message}`);
+    }
+}
+function normalizeCoreFlows(value, manifestPath) {
+    const record = asRecord(value, `QAMap flow manifest must be an object: ${manifestPath}`);
+    const rawFlows = record.flows;
+    if (!Array.isArray(rawFlows)) {
+        throw new Error(`QAMap flow manifest flows must be an array: ${manifestPath}`);
+    }
+    return rawFlows.map((flow, index) => normalizeCoreFlow(flow, manifestPath, index));
+}
+function normalizeCoreFlow(value, manifestPath, index) {
+    const record = asRecord(value, `QAMap flow manifest flow 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 priority = normalizePriority(readOptionalString(record, "priority") ?? "recommended", manifestPath, index);
+    const files = readStringArray(record, "files");
+    const domains = readStringArray(record, "domains");
+    const routes = readStringArray(record, "routes");
+    const tags = readStringArray(record, "tags");
+    const checks = readStringArray(record, "checks");
+    if (files.length + domains.length + routes.length + tags.length === 0) {
+        throw new Error(`QAMap flow manifest flow ${id} must include at least one of files, domains, routes, or tags: ${manifestPath}`);
+    }
+    return {
+        id,
+        name,
+        description: readOptionalString(record, "description"),
+        owner: readOptionalString(record, "owner"),
+        priority,
+        domains,
+        files,
+        routes,
+        tags,
+        checks,
+    };
+}
+async function findFlowManifestPath(root) {
+    for (const candidate of flowManifestCandidates) {
+        const absolutePath = path.join(root, candidate);
+        if (await pathExists(absolutePath)) {
+            return absolutePath;
+        }
+    }
+    return undefined;
+}
+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 flow manifest flow 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 normalizePriority(value, manifestPath, index) {
+    if (value === "critical" || value === "recommended" || value === "optional") {
+        return value;
+    }
+    throw new Error(`QAMap flow manifest flow at index ${index} has invalid priority ${value}; expected critical, recommended, or optional: ${manifestPath}`);
+}
+function defaultCoreFlowManifestText() {
+    return [
+        "# Commit this file when your team wants QAMap to know the flows humans care about.",
+        "flows:",
+        "  - id: primary-success-path",
+        "    name: Primary success path",
+        "    priority: critical",
+        "    domains: []",
+        "    files:",
+        "      - src/**",
+        "    routes: []",
+        "    tags: []",
+        "    checks:",
+        "      - Verify the happy path from entry point to completion.",
+        "      - Verify one realistic failure, empty, or blocked state.",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=flows.js.map

package/dist/flows.js.map

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

package/dist/fs.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectFile } from "./types.js";
+export declare function toPosixPath(value: string): string;
+export declare function pathExists(value: string): Promise<boolean>;
+export declare function collectProjectFiles(root: string, maxFiles: number): Promise<ProjectFile[]>;
+export declare function shouldReadTextFile(relativePath: string, size: number): boolean;
+export declare function getFile(files: ProjectFile[], relativePath: string): ProjectFile | undefined;
+export declare function getFilesUnder(files: ProjectFile[], directory: string): ProjectFile[];

package/dist/fs.js

@@ -0,0 +1,132 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const ignoredDirectories = new Set([
+    ".git",
+    ".hg",
+    ".svn",
+    "node_modules",
+    "dist",
+    "build",
+    "coverage",
+    ".next",
+    ".nuxt",
+    ".turbo",
+    ".cache",
+    "vendor",
+]);
+const textExtensions = new Set([
+    ".bash",
+    ".cjs",
+    ".conf",
+    ".cts",
+    ".env",
+    ".go",
+    ".java",
+    ".js",
+    ".json",
+    ".jsx",
+    ".kt",
+    ".md",
+    ".mdc",
+    ".mjs",
+    ".mts",
+    ".php",
+    ".ps1",
+    ".py",
+    ".rb",
+    ".rs",
+    ".sh",
+    ".swift",
+    ".toml",
+    ".ts",
+    ".tsx",
+    ".txt",
+    ".yaml",
+    ".yml",
+    ".zsh",
+]);
+const textBasenames = new Set([
+    "AGENTS.md",
+    "CLAUDE.md",
+    "GEMINI.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md",
+    "Dockerfile",
+    "Makefile",
+]);
+const maxReadableBytes = 256 * 1024;
+export function toPosixPath(value) {
+    return value.split(path.sep).join("/");
+}
+export async function pathExists(value) {
+    try {
+        await fs.access(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function collectProjectFiles(root, maxFiles) {
+    const files = [];
+    const normalizedRoot = path.resolve(root);
+    async function walk(directory) {
+        if (files.length >= maxFiles) {
+            return;
+        }
+        const entries = await fs.readdir(directory, { withFileTypes: true });
+        entries.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (files.length >= maxFiles) {
+                return;
+            }
+            if (entry.isDirectory() && ignoredDirectories.has(entry.name)) {
+                continue;
+            }
+            const absolutePath = path.join(directory, entry.name);
+            const relativePath = toPosixPath(path.relative(normalizedRoot, absolutePath));
+            if (entry.isDirectory()) {
+                await walk(absolutePath);
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            const stat = await fs.stat(absolutePath);
+            const file = {
+                path: relativePath,
+                absolutePath,
+                size: stat.size,
+            };
+            if (shouldReadTextFile(relativePath, stat.size)) {
+                file.text = await fs.readFile(absolutePath, "utf8");
+            }
+            files.push(file);
+        }
+    }
+    await walk(normalizedRoot);
+    return files;
+}
+export function shouldReadTextFile(relativePath, size) {
+    if (size > maxReadableBytes) {
+        return false;
+    }
+    const basename = path.basename(relativePath);
+    if (textBasenames.has(basename)) {
+        return true;
+    }
+    if (basename.startsWith(".env") && basename !== ".env.example") {
+        return false;
+    }
+    return textExtensions.has(path.extname(relativePath));
+}
+export function getFile(files, relativePath) {
+    return files.find((file) => file.path === relativePath);
+}
+export function getFilesUnder(files, directory) {
+    const prefix = directory.endsWith("/") ? directory : `${directory}/`;
+    return files.filter((file) => file.path.startsWith(prefix));
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

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

package/dist/github.d.ts

@@ -0,0 +1,34 @@
+import type { ScanOptions, Severity } from "./types.js";
+export type GitHubActionMode = "auto" | "scan" | "review";
+export interface GitHubActionOptions {
+    mode?: GitHubActionMode;
+    base?: string;
+    head?: string;
+    scanOptions?: ScanOptions;
+    failOn?: Severity;
+    reportFile?: string;
+    commentFile?: string;
+    annotations?: boolean;
+    stepSummary?: boolean;
+    stepSummaryPath?: string;
+    testPlan?: boolean;
+    testPlanFile?: string;
+    evaluation?: boolean;
+    evalFile?: string;
+    prBody?: string;
+    prBodyFile?: string;
+    includeWorkingTree?: boolean;
+    validationCommands?: string[];
+}
+export interface GitHubActionResult {
+    mode: Exclude<GitHubActionMode, "auto">;
+    reportFile: string;
+    commentFile: string;
+    testPlanFile?: string;
+    evalFile?: string;
+    findingCount: number;
+    failedFindingCount: number;
+    exitCode: number;
+}
+export declare function runGitHubAction(rootInput: string, options?: GitHubActionOptions): Promise<GitHubActionResult>;
+export declare function githubCommentMarker(): string;

package/dist/github.js

@@ -0,0 +1,183 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { evaluateChangeReadiness, formatMarkdownEvalReport } from "./eval.js";
+import { formatMarkdownReport } from "./report.js";
+import { formatMarkdownReviewReport, reviewProject } from "./review.js";
+import { scanProject } from "./scanner.js";
+import { isAtLeastSeverity } from "./severity.js";
+import { formatMarkdownTestPlan, generateTestPlan } from "./test-plan.js";
+const annotationLimit = 50;
+const commentMarker = "<!-- qamap-pr-comment -->";
+export async function runGitHubAction(rootInput, options = {}) {
+    const mode = resolveMode(options.mode);
+    const reportFile = path.resolve(options.reportFile ?? "qamap-report.md");
+    const commentFile = path.resolve(options.commentFile ?? "qamap-pr-comment.md");
+    const testPlanFile = options.testPlan ? path.resolve(options.testPlanFile ?? "qamap-test-plan.md") : undefined;
+    const evalFile = options.evaluation ? path.resolve(options.evalFile ?? "qamap-eval.md") : undefined;
+    const result = mode === "review"
+        ? await runReviewAction(rootInput, options)
+        : await runScanAction(rootInput, options);
+    const testPlanMarkdown = options.testPlan
+        ? formatMarkdownTestPlan(await generateTestPlan(rootInput, {
+            base: options.base,
+            head: options.head,
+            workspaceRoot: options.scanOptions?.workspaceRoot,
+            includeWorkingTree: options.includeWorkingTree,
+            validationCommands: options.validationCommands,
+        }))
+        : undefined;
+    const evalMarkdown = options.evaluation
+        ? formatMarkdownEvalReport(await evaluateChangeReadiness(rootInput, {
+            base: options.base,
+            head: options.head,
+            workspaceRoot: options.scanOptions?.workspaceRoot,
+            includeWorkingTree: options.includeWorkingTree,
+            prBody: options.prBody ?? (await readPullRequestBody()),
+            prBodyFile: options.prBodyFile,
+            validationCommands: options.validationCommands,
+        }))
+        : undefined;
+    const markdown = [result.markdown, testPlanMarkdown, evalMarkdown]
+        .filter((section) => Boolean(section))
+        .map((section) => section.trim())
+        .join("\n\n---\n\n")
+        .concat("\n");
+    await fs.writeFile(reportFile, markdown, "utf8");
+    await fs.writeFile(commentFile, buildCommentBody(markdown), "utf8");
+    if (testPlanFile && testPlanMarkdown) {
+        await fs.writeFile(testPlanFile, testPlanMarkdown, "utf8");
+    }
+    if (evalFile && evalMarkdown) {
+        await fs.writeFile(evalFile, evalMarkdown, "utf8");
+    }
+    if (options.stepSummary !== false) {
+        await appendStepSummary(markdown, options.stepSummaryPath ?? process.env.GITHUB_STEP_SUMMARY);
+    }
+    if (options.annotations !== false) {
+        writeAnnotations(result.annotations);
+    }
+    console.log(`QAMap ${mode} report: ${reportFile}`);
+    console.log(`QAMap PR comment body: ${commentFile}`);
+    if (testPlanFile) {
+        console.log(`QAMap test plan: ${testPlanFile}`);
+    }
+    if (evalFile) {
+        console.log(`QAMap eval: ${evalFile}`);
+    }
+    return {
+        mode,
+        reportFile,
+        commentFile,
+        testPlanFile,
+        evalFile,
+        findingCount: result.findings.length,
+        failedFindingCount: result.failedFindings.length,
+        exitCode: result.failedFindings.length > 0 ? 1 : 0,
+    };
+}
+async function runScanAction(rootInput, options) {
+    const result = await scanProject(rootInput, options.scanOptions);
+    const failedFindings = options.failOn
+        ? result.findings.filter((finding) => isAtLeastSeverity(finding.severity, options.failOn))
+        : [];
+    return {
+        markdown: formatMarkdownReport(result),
+        findings: result.findings,
+        failedFindings,
+        annotations: result.findings.map((finding) => ({
+            finding,
+            failed: failedFindings.includes(finding),
+        })),
+    };
+}
+async function runReviewAction(rootInput, options) {
+    const result = await reviewProject(rootInput, {
+        base: options.base,
+        head: options.head,
+        scanOptions: options.scanOptions,
+    });
+    const findings = [...result.newFindings, ...result.changedRiskyFindings];
+    const failedFindings = options.failOn
+        ? findings.filter((finding) => isAtLeastSeverity(finding.severity, options.failOn))
+        : [];
+    return {
+        markdown: formatMarkdownReviewReport(result),
+        findings,
+        failedFindings,
+        annotations: [
+            ...result.newFindings.map((finding) => ({
+                finding,
+                failed: failedFindings.includes(finding),
+            })),
+            ...result.changedRiskyFindings.map((finding) => ({
+                finding,
+                failed: failedFindings.includes(finding),
+                prefix: "Changed risky file: ",
+            })),
+        ],
+    };
+}
+function resolveMode(mode) {
+    if (mode === "scan" || mode === "review") {
+        return mode;
+    }
+    return process.env.GITHUB_BASE_REF || process.env.GITHUB_HEAD_REF ? "review" : "scan";
+}
+function buildCommentBody(markdown) {
+    return [
+        commentMarker,
+        "## QAMap",
+        "",
+        markdown.trim(),
+        "",
+        "_Generated by QAMap._",
+        "",
+    ].join("\n");
+}
+async function appendStepSummary(markdown, stepSummaryPath) {
+    if (!stepSummaryPath) {
+        return;
+    }
+    await fs.appendFile(stepSummaryPath, `${markdown.trim()}\n`, "utf8");
+}
+function writeAnnotations(annotations) {
+    for (const annotation of annotations.slice(0, annotationLimit)) {
+        console.log(formatAnnotation(annotation));
+    }
+    if (annotations.length > annotationLimit) {
+        console.log(`::notice title=QAMap::${annotations.length - annotationLimit} additional QAMap findings were omitted from annotations.`);
+    }
+}
+function formatAnnotation(annotation) {
+    const finding = annotation.finding;
+    const level = annotation.failed ? "error" : finding.severity === "info" ? "notice" : "warning";
+    const properties = [`title=${escapeAnnotationProperty(`${finding.id} ${finding.title}`)}`];
+    if (finding.file) {
+        properties.push(`file=${escapeAnnotationProperty(finding.file)}`);
+    }
+    const message = `${annotation.prefix ?? ""}${finding.message} Fix: ${finding.recommendation}`;
+    return `::${level} ${properties.join(",")}::${escapeAnnotationMessage(message)}`;
+}
+function escapeAnnotationMessage(value) {
+    return value.replaceAll("%", "%25").replaceAll("\r", "%0D").replaceAll("\n", "%0A");
+}
+function escapeAnnotationProperty(value) {
+    return escapeAnnotationMessage(value).replaceAll(":", "%3A").replaceAll(",", "%2C");
+}
+async function readPullRequestBody() {
+    const eventPath = process.env.GITHUB_EVENT_PATH;
+    if (!eventPath) {
+        return undefined;
+    }
+    try {
+        const event = JSON.parse(await fs.readFile(eventPath, "utf8"));
+        return event.pull_request?.body ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function githubCommentMarker() {
+    return commentMarker;
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

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