prose-qa 0.1.0

package/dist/scenarios/parser.js

@@ -0,0 +1,278 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+const SECTION_HEADERS = ["goal", "steps", "then"];
+function stripInlineYamlComment(line) {
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (ch === "'" && !inDouble)
+            inSingle = !inSingle;
+        else if (ch === '"' && !inSingle)
+            inDouble = !inDouble;
+        else if (ch === "#" &&
+            !inSingle &&
+            !inDouble &&
+            (i === 0 || /\s/.test(line[i - 1]))) {
+            return line.slice(0, i).trimEnd();
+        }
+    }
+    return line;
+}
+function stripYamlComments(yaml) {
+    return yaml
+        .split("\n")
+        .map((line) => {
+        if (/^\s*#/.test(line))
+            return "";
+        return stripInlineYamlComment(line);
+    })
+        .join("\n");
+}
+function stripBodyComments(body) {
+    return body.replace(/<!--[\s\S]*?-->/g, "");
+}
+export function stripScenarioComments(raw) {
+    const fmMatch = /^---\r?\n([\s\S]*?)\r?\n---/.exec(raw);
+    if (!fmMatch) {
+        return stripBodyComments(raw);
+    }
+    const frontmatter = stripYamlComments(fmMatch[1]);
+    const body = stripBodyComments(raw.slice(fmMatch[0].length));
+    return `---\n${frontmatter}\n---${body}`;
+}
+export function parseCheckpoints(lines) {
+    return lines.map((raw) => {
+        const trimmed = raw.replace(/^-\s*/, "").trim();
+        const urlMatch = /^url contains ["'](.+?)["']$/i.exec(trimmed);
+        if (urlMatch) {
+            return { raw: trimmed, kind: "url_contains", value: urlMatch[1] };
+        }
+        const pageMatch = /^page shows ["'](.+?)["']$/i.exec(trimmed);
+        if (pageMatch) {
+            return { raw: trimmed, kind: "page_shows", value: pageMatch[1] };
+        }
+        const equalsMatch = /^(.+?) equals ["'](.+?)["']$/i.exec(trimmed);
+        if (equalsMatch) {
+            return {
+                raw: trimmed,
+                kind: "semantic",
+                value: `${equalsMatch[1]} = ${equalsMatch[2]}`,
+            };
+        }
+        return { raw: trimmed, kind: "unknown" };
+    });
+}
+const MARKDOWN_LINK_RE = /\[([^\]]*)\]\(([^)\s]+)(?:\s+["'][^"']*["'])?\)/g;
+function isScenarioMarkdownLink(target) {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(target))
+        return false;
+    return /\.md$/i.test(target);
+}
+function resolveScenarioLinkPath(fromFilePath, target) {
+    return path.isAbsolute(target)
+        ? path.normalize(target)
+        : path.resolve(path.dirname(fromFilePath), target);
+}
+function normalizeSkillNames(value) {
+    if (!value)
+        return [];
+    if (Array.isArray(value)) {
+        return value.map(String).filter(Boolean);
+    }
+    if (typeof value === "string")
+        return [value];
+    return [];
+}
+function appendSkillNames(collected, names) {
+    const seen = new Set(collected);
+    for (const name of names) {
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        collected.push(name);
+    }
+}
+function readLinkedScenarioBody(targetPath, visiting, collectedSkills) {
+    const resolved = path.resolve(targetPath);
+    if (visiting.has(resolved)) {
+        const chain = [...visiting, resolved].join(" -> ");
+        throw new Error(`Circular scenario include: ${chain}`);
+    }
+    if (!existsSync(resolved)) {
+        throw new Error(`Scenario link target not found: ${targetPath}`);
+    }
+    visiting.add(resolved);
+    try {
+        const raw = stripScenarioComments(readFileSync(resolved, "utf-8"));
+        const { data, content } = matter(raw);
+        const linkedFrontmatter = data;
+        appendSkillNames(collectedSkills, normalizeSkillNames(linkedFrontmatter.skills));
+        return expandScenarioLinks(content, resolved, visiting, collectedSkills);
+    }
+    finally {
+        visiting.delete(resolved);
+    }
+}
+export function expandScenarioLinks(body, fromFilePath, visiting = new Set(), collectedSkills = []) {
+    const resolvedFrom = path.resolve(fromFilePath);
+    if (!visiting.has(resolvedFrom)) {
+        visiting.add(resolvedFrom);
+    }
+    return body.replace(MARKDOWN_LINK_RE, (match, _label, target) => {
+        if (!isScenarioMarkdownLink(target))
+            return match;
+        const linkedPath = resolveScenarioLinkPath(fromFilePath, target);
+        return readLinkedScenarioBody(linkedPath, visiting, collectedSkills);
+    });
+}
+export function parseScenarioFrontmatter(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    const raw = stripScenarioComments(readFileSync(resolvedPath, "utf-8"));
+    const { data } = matter(raw);
+    const frontmatter = data;
+    if (!frontmatter.name) {
+        throw new Error(`Scenario ${resolvedPath} missing 'name' in frontmatter`);
+    }
+    return { filePath: resolvedPath, frontmatter };
+}
+export function tryParseScenarioFrontmatter(filePath) {
+    try {
+        return parseScenarioFrontmatter(filePath);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function findScenarioSummariesByNames(filePaths, names) {
+    if (names.size === 0)
+        return [];
+    const found = new Map();
+    for (const filePath of filePaths) {
+        if (found.size === names.size)
+            break;
+        const summary = tryParseScenarioFrontmatter(filePath);
+        if (summary && names.has(summary.frontmatter.name)) {
+            found.set(summary.frontmatter.name, summary);
+        }
+    }
+    return [...found.values()];
+}
+export function isRunnableScenario(scenario) {
+    return !scenario.frontmatter.partial;
+}
+function extractSections(body) {
+    const sections = {
+        goal: "",
+        steps: "",
+        then: "",
+    };
+    let current = null;
+    const lines = body.split("\n");
+    for (const line of lines) {
+        const header = /^#\s+(\w+)\s*$/i.exec(line.trim());
+        if (header) {
+            const name = header[1].toLowerCase();
+            if (SECTION_HEADERS.includes(name)) {
+                current = name;
+                continue;
+            }
+        }
+        if (current) {
+            sections[current] += `${line}\n`;
+        }
+    }
+    return sections;
+}
+export function parseScenarioContent(raw, filePath) {
+    const resolvedPath = path.resolve(filePath);
+    const stripped = stripScenarioComments(raw);
+    const { data, content } = matter(stripped);
+    const frontmatter = data;
+    if (!frontmatter.name) {
+        throw new Error(`Scenario ${resolvedPath} missing 'name' in frontmatter`);
+    }
+    const collectedSkills = [];
+    appendSkillNames(collectedSkills, normalizeSkillNames(frontmatter.skills));
+    const expandedBody = expandScenarioLinks(content, resolvedPath, new Set(), collectedSkills);
+    const sections = extractSections(expandedBody);
+    const thenLines = sections.then
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("-"));
+    const checkpoints = parseCheckpoints(thenLines);
+    return {
+        filePath: resolvedPath,
+        frontmatter,
+        skills: collectedSkills,
+        goal: sections.goal.trim(),
+        steps: sections.steps.trim(),
+        then: checkpoints.map((c) => c.raw),
+        rawCheckpoints: thenLines,
+        checkpoints,
+    };
+}
+export function parseScenarioFile(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    const raw = readFileSync(resolvedPath, "utf-8");
+    return parseScenarioContent(raw, resolvedPath);
+}
+export function formatScenarioForPrompt(scenario) {
+    const thenBlock = scenario.then.length > 0
+        ? scenario.then.map((t) => `- ${t}`).join("\n")
+        : "(none)";
+    const urlLine = scenario.frontmatter.url
+        ? `\nStart URL: ${scenario.frontmatter.url}`
+        : "";
+    return `# Scenario: ${scenario.frontmatter.name}${urlLine}
+
+## Goal
+${scenario.goal || "(none)"}
+
+## Steps
+${scenario.steps || "(none)"}
+
+## Then (verify each)
+${thenBlock}`;
+}
+function matchesTagTerm(scenarioTags, term) {
+    const negated = term.startsWith("!");
+    const tag = negated ? term.slice(1) : term;
+    if (!tag)
+        return false;
+    const hasTag = scenarioTags.has(tag);
+    return negated ? !hasTag : hasTag;
+}
+export function matchesTags(scenario, filters) {
+    if (!filters || filters.length === 0)
+        return true;
+    const filterGroups = typeof filters[0] === "string"
+        ? filters.filter(Boolean).map((tag) => [tag])
+        : filters
+            .map((group) => group.filter(Boolean))
+            .filter((group) => group.length > 0);
+    if (filterGroups.length === 0)
+        return true;
+    const scenarioTags = new Set(scenario.frontmatter.tags ?? []);
+    return filterGroups.some((group) => group.every((term) => matchesTagTerm(scenarioTags, term)));
+}
+export function selectRunnableScenarioSummaries(summaries, filters, authScenarioNames) {
+    return summaries
+        .filter((s) => isRunnableScenario(s))
+        .filter((s) => matchesTags(s, filters))
+        .filter((s) => !authScenarioNames.has(s.frontmatter.name));
+}
+export function scenarioSummaryToStub(summary) {
+    return {
+        filePath: summary.filePath,
+        frontmatter: summary.frontmatter,
+        skills: [],
+        goal: "",
+        steps: "",
+        then: [],
+        rawCheckpoints: [],
+        checkpoints: [],
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/scenarios/parser.js.map

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

package/dist/scenarios/parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/scenarios/parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.d.ts","sourceRoot":"","sources":["../../src/scenarios/parser.test.ts"],"names":[],"mappings":""}

package/dist/scenarios/parser.test.js

@@ -0,0 +1,373 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { describe, it } from "node:test";
+import { isRunnableScenario, matchesTags, parseScenarioFile, parseScenarioContent, parseScenarioFrontmatter, findScenarioSummariesByNames, selectRunnableScenarioSummaries, tryParseScenarioFrontmatter, stripScenarioComments, } from "./parser.js";
+function scenarioWithTags(tags) {
+    return {
+        filePath: "/tmp/x.md",
+        frontmatter: { name: "x", tags },
+        skills: [],
+        goal: "",
+        steps: "",
+        then: [],
+        rawCheckpoints: [],
+        checkpoints: [],
+    };
+}
+describe("stripScenarioComments", () => {
+    it("removes YAML full-line and inline comments from frontmatter", () => {
+        const raw = `---
+name: example-validation-error
+# auth: admin
+tags: [smoke] # filter tag
+url: https://localhost:3000/new
+---
+
+# Goal
+
+test goal
+`;
+        const stripped = stripScenarioComments(raw);
+        assert.match(stripped, /name: example-validation-error/);
+        assert.doesNotMatch(stripped, /auth: admin/);
+        assert.match(stripped, /tags: \[smoke\]/);
+        assert.doesNotMatch(stripped, /filter tag/);
+    });
+    it("removes HTML comments from the body but keeps hash lines", () => {
+        const raw = `---
+name: example
+---
+
+# Goal
+
+verify something
+
+# Steps
+
+1. Do the thing
+<!-- author note: skip login when debugging -->
+# this step is optional for now
+2. Confirm result with option #2
+
+# Then
+
+- url contains "/done"
+`;
+        const stripped = stripScenarioComments(raw);
+        assert.doesNotMatch(stripped, /author note/);
+        assert.match(stripped, /optional for now/);
+        assert.match(stripped, /option #2/);
+        assert.match(stripped, /# Goal/);
+        assert.match(stripped, /# Steps/);
+        assert.match(stripped, /# Then/);
+    });
+    it("preserves hash characters mid-line in frontmatter values", () => {
+        const raw = `---
+name: example
+url: "https://example.com#section" # trailing note
+---
+
+# Goal
+
+(none)
+`;
+        const stripped = stripScenarioComments(raw);
+        assert.match(stripped, /https:\/\/example\.com#section/);
+        assert.doesNotMatch(stripped, /trailing note/);
+    });
+});
+describe("parseScenarioFrontmatter", () => {
+    it("reads frontmatter without expanding scenario links", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const mainPath = path.join(dir, "main.md");
+        writeFileSync(mainPath, `---
+name: main-scenario
+tags: [smoke, lapresse]
+partial: false
+---
+
+# Steps
+
+1. [broken link](./missing.md)
+`);
+        const summary = parseScenarioFrontmatter(mainPath);
+        assert.equal(summary.frontmatter.name, "main-scenario");
+        assert.deepEqual(summary.frontmatter.tags, ["smoke", "lapresse"]);
+    });
+});
+describe("parseScenarioContent", () => {
+    it("parses inline markdown the same as a file", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const filePath = path.join(dir, "inline.md");
+        const raw = `---
+name: inline-smoke
+tags: [smoke]
+---
+
+# Goal
+
+Smoke test.
+
+# Steps
+
+1. Open home.
+
+# Then
+
+- url contains "/"
+`;
+        writeFileSync(filePath, raw);
+        const fromFile = parseScenarioFile(filePath);
+        const fromContent = parseScenarioContent(raw, filePath);
+        assert.equal(fromContent.frontmatter.name, fromFile.frontmatter.name);
+        assert.equal(fromContent.goal, fromFile.goal);
+        assert.deepEqual(fromContent.checkpoints, fromFile.checkpoints);
+    });
+});
+describe("tryParseScenarioFrontmatter", () => {
+    it("returns undefined for partial files without frontmatter", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const partialPath = path.join(dir, "partial.md");
+        writeFileSync(partialPath, "shared steps only\n");
+        assert.equal(tryParseScenarioFrontmatter(partialPath), undefined);
+    });
+});
+describe("findScenarioSummariesByNames", () => {
+    it("finds scenarios by name without parsing unrelated files", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const targetPath = path.join(dir, "target.md");
+        const brokenPath = path.join(dir, "broken-partial.md");
+        writeFileSync(targetPath, `---
+name: target-scenario
+tags: [lapresse, test2]
+---
+
+# Steps
+
+1. Do thing
+`);
+        writeFileSync(brokenPath, "[link](./missing.md)\n");
+        const found = findScenarioSummariesByNames([brokenPath, targetPath], new Set(["target-scenario"]));
+        assert.deepEqual(found.map((s) => s.frontmatter.name), ["target-scenario"]);
+    });
+});
+describe("selectRunnableScenarioSummaries", () => {
+    it("filters by tags, partial, and auth scenario names", () => {
+        const summaries = [
+            {
+                filePath: "/tmp/run.md",
+                frontmatter: { name: "run", tags: ["lapresse", "test2"] },
+            },
+            {
+                filePath: "/tmp/skip-tags.md",
+                frontmatter: { name: "skip-tags", tags: ["lapresse", "test3"] },
+            },
+            {
+                filePath: "/tmp/partial.md",
+                frontmatter: { name: "partial", partial: true, tags: ["lapresse", "test2"] },
+            },
+            {
+                filePath: "/tmp/auth.md",
+                frontmatter: { name: "login-admin", tags: ["auth"] },
+            },
+        ];
+        const authScenarioNames = new Set(["login-admin"]);
+        const selected = selectRunnableScenarioSummaries(summaries, [["lapresse", "test2"]], authScenarioNames);
+        assert.deepEqual(selected.map((s) => s.frontmatter.name), ["run"]);
+    });
+});
+describe("expandScenarioLinks", () => {
+    it("inlines body of a linked scenario file", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const partialPath = path.join(dir, "partial.md");
+        const mainPath = path.join(dir, "main.md");
+        writeFileSync(partialPath, `---
+name: partial-block
+partial: true
+---
+
+Fill the client field with **Acme Corp**.
+`);
+        writeFileSync(mainPath, `---
+name: main-scenario
+---
+
+# Steps
+
+1. Open the form
+2. [client step](./partial.md)
+3. Save
+`);
+        const scenario = parseScenarioFile(mainPath);
+        assert.match(scenario.steps, /Fill the client field with \*\*Acme Corp\*\*/);
+        assert.doesNotMatch(scenario.steps, /\[client step\]/);
+        assert.match(scenario.steps, /3\. Save/);
+    });
+    it("expands nested scenario links", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const leafPath = path.join(dir, "leaf.md");
+        const midPath = path.join(dir, "mid.md");
+        const mainPath = path.join(dir, "main.md");
+        writeFileSync(leafPath, `---
+name: leaf
+partial: true
+---
+
+leaf content
+`);
+        writeFileSync(midPath, `---
+name: mid
+partial: true
+---
+
+before [leaf](./leaf.md) after
+`);
+        writeFileSync(mainPath, `---
+name: main
+---
+
+# Goal
+
+see [mid](./mid.md)
+`);
+        const scenario = parseScenarioFile(mainPath);
+        assert.match(scenario.goal, /see/);
+        assert.match(scenario.goal, /before/);
+        assert.match(scenario.goal, /leaf content/);
+        assert.match(scenario.goal, /after/);
+        assert.doesNotMatch(scenario.goal, /\.md\)/);
+    });
+    it("leaves non-scenario markdown links unchanged", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const mainPath = path.join(dir, "main.md");
+        writeFileSync(mainPath, `---
+name: main
+---
+
+# Steps
+
+Visit [docs](https://example.com/docs) then continue.
+`);
+        const scenario = parseScenarioFile(mainPath);
+        assert.match(scenario.steps, /\[docs\]\(https:\/\/example\.com\/docs\)/);
+    });
+    it("throws on circular scenario includes", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const aPath = path.join(dir, "a.md");
+        const bPath = path.join(dir, "b.md");
+        writeFileSync(aPath, `---
+name: a
+partial: true
+---
+
+[a](./b.md)
+`);
+        writeFileSync(bPath, `---
+name: b
+partial: true
+---
+
+[b](./a.md)
+`);
+        assert.throws(() => parseScenarioFile(aPath), /Circular scenario include/);
+    });
+    it("collects skills from linked scenario frontmatter", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const partialPath = path.join(dir, "partial.md");
+        const mainPath = path.join(dir, "main.md");
+        writeFileSync(partialPath, `---
+name: partial-block
+partial: true
+skills: [domain-app]
+---
+
+Fill the client field.
+`);
+        writeFileSync(mainPath, `---
+name: main-scenario
+skills: [core]
+---
+
+# Steps
+
+1. [client step](./partial.md)
+`);
+        const scenario = parseScenarioFile(mainPath);
+        assert.deepEqual(scenario.skills, ["core", "domain-app"]);
+    });
+    it("deduplicates skills declared in multiple linked scenarios", () => {
+        const dir = mkdtempSync(path.join(tmpdir(), "pqa-parser-"));
+        const sharedPath = path.join(dir, "shared.md");
+        const mainPath = path.join(dir, "main.md");
+        writeFileSync(sharedPath, `---
+name: shared
+partial: true
+skills: [core, extra]
+---
+
+shared steps
+`);
+        writeFileSync(mainPath, `---
+name: main
+skills: [core, main-only]
+---
+
+# Steps
+
+1. [shared](./shared.md)
+`);
+        const scenario = parseScenarioFile(mainPath);
+        assert.deepEqual(scenario.skills, ["core", "main-only", "extra"]);
+    });
+});
+describe("isRunnableScenario", () => {
+    it("excludes partial scenarios from batch runs", () => {
+        assert.equal(isRunnableScenario({
+            frontmatter: { name: "x", partial: true },
+        }), false);
+        assert.equal(isRunnableScenario({
+            frontmatter: { name: "y" },
+        }), true);
+    });
+});
+describe("matchesTags", () => {
+    it("matches everything when no tag filters are provided", () => {
+        assert.equal(matchesTags(scenarioWithTags(["smoke"]), undefined), true);
+        assert.equal(matchesTags(scenarioWithTags(["smoke"]), []), true);
+    });
+    it("requires every tag in a --tags group", () => {
+        const scenario = scenarioWithTags(["smoke", "checkout", "critical"]);
+        assert.equal(matchesTags(scenario, [["smoke", "checkout"]]), true);
+        assert.equal(matchesTags(scenario, [["smoke", "billing"]]), false);
+    });
+    it("matches any group across repeated --tag filters", () => {
+        const scenario = scenarioWithTags(["smoke", "checkout"]);
+        assert.equal(matchesTags(scenario, [["billing"], ["checkout"]]), true);
+        assert.equal(matchesTags(scenario, [["billing"], ["auth"]]), false);
+    });
+    it("combines --tags groups and --tag filters with OR semantics", () => {
+        const scenario = scenarioWithTags(["smoke", "checkout"]);
+        assert.equal(matchesTags(scenario, [["smoke", "admin"], ["checkout"]]), true);
+        assert.equal(matchesTags(scenario, [["smoke", "admin"], ["billing"]]), false);
+    });
+    it("supports negated tags inside --tags AND groups", () => {
+        assert.equal(matchesTags(scenarioWithTags(["p0"]), [["p0", "!smoke"]]), true);
+        assert.equal(matchesTags(scenarioWithTags(["p0", "smoke"]), [["p0", "!smoke"]]), false);
+        assert.equal(matchesTags(scenarioWithTags(["smoke"]), [["p0", "!smoke"]]), false);
+    });
+    it("supports negated tags across --tag OR groups", () => {
+        const filters = [["!p0"], ["smoke"]];
+        assert.equal(matchesTags(scenarioWithTags(["smoke"]), filters), true);
+        assert.equal(matchesTags(scenarioWithTags(["p0", "smoke"]), filters), true);
+        assert.equal(matchesTags(scenarioWithTags(["p0"]), filters), false);
+    });
+    it("keeps legacy flat tag lists as OR filters", () => {
+        const scenario = scenarioWithTags(["smoke"]);
+        assert.equal(matchesTags(scenario, ["auth", "smoke"]), true);
+        assert.equal(matchesTags(scenario, ["auth", "billing"]), false);
+        assert.equal(matchesTags(scenario, ["!p0"]), true);
+    });
+});
+//# sourceMappingURL=parser.test.js.map