@popoverai/dotrequirements 0.23.0 → 0.24.1

package/dist/schema/conversions.js

@@ -25,7 +25,7 @@ export function parseKey(key) {
  */
 export function convexToRequirements(convexReqs) {
     // Separate roots from children
-    const roots = convexReqs.filter(r => !r.rootId);
+    const roots = convexReqs.filter((r) => !r.rootId);
     // Build a map of all requirements by their position path for each root
     const reqsByRoot = new Map();
     for (const req of convexReqs) {
@@ -35,11 +35,11 @@ export function convexToRequirements(convexReqs) {
                 rootMap = new Map();
                 reqsByRoot.set(req.rootId, rootMap);
             }
-            rootMap.set(req.position || '', req);
+            rootMap.set(req.position || "", req);
         }
     }
     // Build trees for each root
-    return roots.map(root => buildTreeFromPositions(root, reqsByRoot.get(root._id)));
+    return roots.map((root) => buildTreeFromPositions(root, reqsByRoot.get(root._id)));
 }
 /**
  * Recursively build a RequirementNode tree from position-based flat structure.
@@ -70,9 +70,9 @@ function buildTreeFromPositions(convexReq, positionMap) {
     // Find direct children based on position paths
     // If this is a root (no position), find children at positions like ".0", ".1"
     // If this has position ".0", find children at positions like ".0.0", ".0.1"
-    const currentPosition = convexReq.position || '';
+    const currentPosition = convexReq.position || "";
     const childPositionPattern = currentPosition
-        ? new RegExp(`^${currentPosition.replace(/\./g, '\\.')}\\.\\d+$`)
+        ? new RegExp(`^${currentPosition.replace(/\./g, "\\.")}\\.\\d+$`)
         : /^\.\d+$/;
     const children = [];
     for (const [pos, req] of positionMap.entries()) {
@@ -82,10 +82,10 @@ function buildTreeFromPositions(convexReq, positionMap) {
     }
     // Sort children by position
     const sortedChildren = children.sort((a, b) => {
-        return comparePositions(a.position || '', b.position || '');
+        return comparePositions(a.position || "", b.position || "");
     });
     // Recursively build child nodes
-    node.children = sortedChildren.map(child => buildTreeFromPositions(child, positionMap));
+    node.children = sortedChildren.map((child) => buildTreeFromPositions(child, positionMap));
     return node;
 }
 /**
@@ -93,8 +93,8 @@ function buildTreeFromPositions(convexReq, positionMap) {
  * Positions are like ".0", ".1", ".0.0", ".0.1"
  */
 function comparePositions(a, b) {
-    const aParts = a.split('.').filter(Boolean).map(Number);
-    const bParts = b.split('.').filter(Boolean).map(Number);
+    const aParts = a.split(".").filter(Boolean).map(Number);
+    const bParts = b.split(".").filter(Boolean).map(Number);
     for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
         const aVal = aParts[i] ?? -1;
         const bVal = bParts[i] ?? -1;
@@ -125,7 +125,7 @@ function flattenNode(node, projectId, rootId, position, result, documentId) {
     // Get prefix/index from metadata (if from round-trip) or parse from node.id
     let prefix;
     let index;
-    if (node.metadata?.prefix && typeof node.metadata?.index === 'number') {
+    if (node.metadata?.prefix && typeof node.metadata?.index === "number") {
         // Round-trip case: use stored prefix/index
         prefix = node.metadata.prefix;
         index = node.metadata.index;
@@ -181,7 +181,7 @@ export function buildMetadata(version = 1, document) {
  * Useful for detecting duplicates or tracking which requirements exist.
  */
 export function extractRequirementKeys(convexReqs) {
-    return new Set(convexReqs.map(r => constructKey(r.prefix, r.index)));
+    return new Set(convexReqs.map((r) => constructKey(r.prefix, r.index)));
 }
 /**
  * Group Convex requirements by their root.

package/dist/schema/index.d.ts

@@ -4,13 +4,13 @@
  * This module provides types, validation, parsing, and building utilities
  * for the Markdown requirements format.
  */
-export { MetadataSchema, RequirementNodeSchema, RequirementsFileSchema, ParsedCriterionSchema, RequirementPrefixSchema, RequirementKeySchema, REQUIREMENT_PREFIX_PATTERN, REQUIREMENT_KEY_PATTERN, ValidationError, validateMetadata, validateRequirementNode, validateRequirementsFile, validatePrefix, validateKey, validateForPush, CONVEX_ID_PATTERN, normalizePrefix, parseRequirementKey, buildRequirementKey, } from './schemas.js';
-export type { Metadata, RequirementNode, RequirementsFile, ParsedCriterion, RequirementPrefix, RequirementKey, PushValidationResult, } from './schemas.js';
-export { parseCriterionLine, parseRequirementBlock, parseRequirementsFile, parseRequirementsFromFile, flattenRequirementTree, findRequirementById, getAllRequirements, } from './parser.js';
-export { buildRequirementsMarkdown, buildRequirementMarkdown, buildRequirementsFile, } from './builder.js';
-export { parseRequirementPath, parsePathSegment, findChildrenByLabel, resolvePathSegment, resolveRequirementPath, resolveToNumericPath, getAllLabelPaths, checkPathAmbiguity, } from './resolver.js';
-export type { ConvexRequirement, } from './conversions.js';
-export { convexToRequirements, requirementsToConvex, buildMetadata, extractRequirementKeys, groupByRoot, constructKey, parseKey, } from './conversions.js';
-export { buildScenarioFromRequirements, requirementTreeToScenario, } from './scenario.js';
-export type { Scenario, ScenarioStep, ScenarioAssertionSource, BuildScenarioOptions, } from './scenario.js';
+export { buildRequirementMarkdown, buildRequirementsFile, buildRequirementsMarkdown, } from "./builder.js";
+export type { ConvexRequirement } from "./conversions.js";
+export { buildMetadata, constructKey, convexToRequirements, extractRequirementKeys, groupByRoot, parseKey, requirementsToConvex, } from "./conversions.js";
+export { findRequirementById, flattenRequirementTree, getAllRequirements, parseCriterionLine, parseRequirementBlock, parseRequirementsFile, parseRequirementsFromFile, } from "./parser.js";
+export { checkPathAmbiguity, findChildrenByLabel, getAllLabelPaths, parsePathSegment, parseRequirementPath, resolvePathSegment, resolveRequirementPath, resolveToNumericPath, } from "./resolver.js";
+export type { BuildScenarioOptions, Scenario, ScenarioAssertionSource, ScenarioStep, } from "./scenario.js";
+export { buildScenarioFromRequirements, requirementTreeToScenario, } from "./scenario.js";
+export type { Metadata, ParsedCriterion, PushValidationResult, RequirementKey, RequirementNode, RequirementPrefix, RequirementsFile, } from "./schemas.js";
+export { buildRequirementKey, CONVEX_ID_PATTERN, MetadataSchema, normalizePrefix, ParsedCriterionSchema, parseRequirementKey, REQUIREMENT_KEY_PATTERN, REQUIREMENT_PREFIX_PATTERN, RequirementKeySchema, RequirementNodeSchema, RequirementPrefixSchema, RequirementsFileSchema, ValidationError, validateForPush, validateKey, validateMetadata, validatePrefix, validateRequirementNode, validateRequirementsFile, } from "./schemas.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/schema/index.js

@@ -4,23 +4,23 @@
  * This module provides types, validation, parsing, and building utilities
  * for the Markdown requirements format.
  */
+// Building
+export { buildRequirementMarkdown, buildRequirementsFile, buildRequirementsMarkdown, } from "./builder.js";
+export { buildMetadata, constructKey, convexToRequirements, extractRequirementKeys, groupByRoot, parseKey, requirementsToConvex, } from "./conversions.js";
+// Parsing
+export { findRequirementById, flattenRequirementTree, getAllRequirements, parseCriterionLine, parseRequirementBlock, parseRequirementsFile, parseRequirementsFromFile, } from "./parser.js";
+// Path resolution
+export { checkPathAmbiguity, findChildrenByLabel, getAllLabelPaths, parsePathSegment, parseRequirementPath, resolvePathSegment, resolveRequirementPath, resolveToNumericPath, } from "./resolver.js";
+// Scenario building (for browser-automation / runScenario)
+export { buildScenarioFromRequirements, requirementTreeToScenario, } from "./scenario.js";
 // Schemas and types
-export { 
+export { buildRequirementKey, CONVEX_ID_PATTERN, 
 // Zod schemas
-MetadataSchema, RequirementNodeSchema, RequirementsFileSchema, ParsedCriterionSchema, RequirementPrefixSchema, RequirementKeySchema, 
+MetadataSchema, 
+// Prefix/key utilities
+normalizePrefix, ParsedCriterionSchema, parseRequirementKey, REQUIREMENT_KEY_PATTERN, 
 // Patterns (for external validation)
-REQUIREMENT_PREFIX_PATTERN, REQUIREMENT_KEY_PATTERN, 
+REQUIREMENT_PREFIX_PATTERN, RequirementKeySchema, RequirementNodeSchema, RequirementPrefixSchema, RequirementsFileSchema, 
 // Validation
-ValidationError, validateMetadata, validateRequirementNode, validateRequirementsFile, validatePrefix, validateKey, validateForPush, CONVEX_ID_PATTERN, 
-// Prefix/key utilities
-normalizePrefix, parseRequirementKey, buildRequirementKey, } from './schemas.js';
-// Parsing
-export { parseCriterionLine, parseRequirementBlock, parseRequirementsFile, parseRequirementsFromFile, flattenRequirementTree, findRequirementById, getAllRequirements, } from './parser.js';
-// Building
-export { buildRequirementsMarkdown, buildRequirementMarkdown, buildRequirementsFile, } from './builder.js';
-// Path resolution
-export { parseRequirementPath, parsePathSegment, findChildrenByLabel, resolvePathSegment, resolveRequirementPath, resolveToNumericPath, getAllLabelPaths, checkPathAmbiguity, } from './resolver.js';
-export { convexToRequirements, requirementsToConvex, buildMetadata, extractRequirementKeys, groupByRoot, constructKey, parseKey, } from './conversions.js';
-// Scenario building (for browser-automation / runScenario)
-export { buildScenarioFromRequirements, requirementTreeToScenario, } from './scenario.js';
+ValidationError, validateForPush, validateKey, validateMetadata, validatePrefix, validateRequirementNode, validateRequirementsFile, } from "./schemas.js";
 //# sourceMappingURL=index.js.map

package/dist/schema/parser-core.d.ts

@@ -4,7 +4,7 @@
  * This module contains pure parsing functions with no Node.js dependencies,
  * making it safe to import in Convex runtime or browser environments.
  */
-import { RequirementNode, ParsedCriterion } from './schemas.js';
+import { type ParsedCriterion, type RequirementNode } from "./schemas.js";
 /**
  * Default delimiter for requirements.
  * Can be overridden for organization-specific preferences.

package/dist/schema/parser-core.js

@@ -4,13 +4,13 @@
  * This module contains pure parsing functions with no Node.js dependencies,
  * making it safe to import in Convex runtime or browser environments.
  */
-import { ValidationError, } from './schemas.js';
+import { ValidationError, } from "./schemas.js";
 /**
  * Default delimiter for requirements.
  * Can be overridden for organization-specific preferences.
  */
-export const DEFAULT_DELIMITER = '→';
-export const DELIMITER_PATTERN = '(?:→|->)'; // Non-capturing group for both Unicode and ASCII
+export const DEFAULT_DELIMITER = "→";
+export const DELIMITER_PATTERN = "(?:→|->)"; // Non-capturing group for both Unicode and ASCII
 /**
  * Parse a criterion line in "position. Label → content" format.
  * Example: "0. Given → user has valid credentials"
@@ -27,7 +27,7 @@ export function parseCriterionLine(line, delimiter = DELIMITER_PATTERN) {
     }
     return {
         position: match[1],
-        label: match[2] ? match[2].trim() : '', // Preserve original case, empty if no label
+        label: match[2] ? match[2].trim() : "", // Preserve original case, empty if no label
         content: match[3].trim(),
     };
 }
@@ -43,7 +43,7 @@ export function parseRootLine(line, delimiter = DELIMITER_PATTERN) {
     if (keyMatch) {
         return {
             key: keyMatch[1],
-            label: '', // Keys use empty string for unlabeled requirements
+            label: "", // Keys use empty string for unlabeled requirements
             content: keyMatch[2].trim(),
         };
     }
@@ -53,12 +53,12 @@ export function parseRootLine(line, delimiter = DELIMITER_PATTERN) {
     if (!match) {
         // If no delimiter found, treat entire line as content with empty label
         return {
-            label: '',
+            label: "",
             content: trimmed,
         };
     }
     return {
-        label: match[1] ? match[1].trim() : '',
+        label: match[1] ? match[1].trim() : "",
         content: match[2].trim(),
     };
 }
@@ -68,20 +68,20 @@ export function parseRootLine(line, delimiter = DELIMITER_PATTERN) {
  * Subsequent lines are criteria with position paths.
  */
 export function parseRequirementBlock(key, blockContent) {
-    const lines = blockContent.trim().split('\n');
+    const lines = blockContent.trim().split("\n");
     if (lines.length === 0) {
-        throw new ValidationError('Empty requirement block', key);
+        throw new ValidationError("Empty requirement block", key);
     }
     // First line is the requirement content
     const rootParsed = parseRootLine(lines[0]);
     if (!rootParsed.content) {
-        throw new ValidationError('Requirement content (first line) cannot be empty', key);
+        throw new ValidationError("Requirement content (first line) cannot be empty", key);
     }
     const root = {
         id: key,
         // Root requirements always use "requirementHeader" label for indexing/querying
         // The markdown format doesn't preserve root labels, but we standardize on this value
-        label: 'requirementHeader',
+        label: "requirementHeader",
         content: rootParsed.content,
         children: [],
     };
@@ -90,7 +90,7 @@ export function parseRequirementBlock(key, blockContent) {
     for (let i = 1; i < lines.length; i++) {
         const line = lines[i];
         // Skip empty lines and comments
-        if (!line.trim() || line.trim().startsWith('#')) {
+        if (!line.trim() || line.trim().startsWith("#")) {
             continue;
         }
         const criterion = parseCriterionLine(line);
@@ -98,7 +98,7 @@ export function parseRequirementBlock(key, blockContent) {
             // Check if this looks like another requirement key (KEY: content format)
             const trimmedLine = line.trim();
             if (/^[\w-]+:\s*.+/.test(trimmedLine)) {
-                throw new ValidationError(`Multiple requirements in single block. Found "${trimmedLine.split(':')[0]}" at line ${i + 1}, but each requirement must have its own \`\`\`dotrequirements code block.`, key);
+                throw new ValidationError(`Multiple requirements in single block. Found "${trimmedLine.split(":")[0]}" at line ${i + 1}, but each requirement must have its own \`\`\`dotrequirements code block.`, key);
             }
             throw new ValidationError(`Invalid criterion format at line ${i + 1}: "${trimmedLine}". Expected format: "N. Label → content" (e.g., "0. Given → user is logged in")`, key);
         }
@@ -115,8 +115,8 @@ export function parseRequirementBlock(key, blockContent) {
 function buildTreeFromPositions(root, rootKey, criteriaByPosition) {
     // Get all top-level children (single digit positions: "0", "1", "2")
     const topLevelPositions = Array.from(criteriaByPosition.keys())
-        .filter(pos => !pos.includes('.'))
-        .sort((a, b) => parseInt(a) - parseInt(b));
+        .filter((pos) => !pos.includes("."))
+        .sort((a, b) => parseInt(a, 10) - parseInt(b, 10));
     for (const position of topLevelPositions) {
         const criterion = criteriaByPosition.get(position);
         const childNode = {
@@ -136,9 +136,9 @@ function buildTreeFromPositions(root, rootKey, criteriaByPosition) {
 function buildChildrenFromPositions(parent, parentPosition, rootKey, criteriaByPosition) {
     // Find direct children (e.g., if parent is "1", find "1.0", "1.1", etc.)
     const childPositions = Array.from(criteriaByPosition.keys())
-        .filter(pos => {
-        const parts = pos.split('.');
-        const parentParts = parentPosition.split('.');
+        .filter((pos) => {
+        const parts = pos.split(".");
+        const parentParts = parentPosition.split(".");
         // Must be exactly one level deeper
         if (parts.length !== parentParts.length + 1) {
             return false;
@@ -152,8 +152,8 @@ function buildChildrenFromPositions(parent, parentPosition, rootKey, criteriaByP
         return true;
     })
         .sort((a, b) => {
-        const aLast = parseInt(a.split('.').pop());
-        const bLast = parseInt(b.split('.').pop());
+        const aLast = parseInt(a.split(".").pop(), 10);
+        const bLast = parseInt(b.split(".").pop(), 10);
         return aLast - bLast;
     });
     for (const position of childPositions) {
@@ -177,8 +177,8 @@ export function extractRequirementBlocks(body) {
     const blocks = [];
     // Find all ```dotrequirements code blocks
     const blockRegex = /```dotrequirements\n([\s\S]*?)```/gm;
-    let match;
-    while ((match = blockRegex.exec(body)) !== null) {
+    let match = blockRegex.exec(body);
+    while (match !== null) {
         const blockContent = match[1];
         // Extract key from first line of block (format: "KEY: content")
         const firstLineMatch = blockContent.match(/^([\w-]+):\s*(.+)/);
@@ -187,6 +187,7 @@ export function extractRequirementBlocks(body) {
         }
         const key = firstLineMatch[1];
         blocks.push({ key, blockContent: blockContent.trim() });
+        match = blockRegex.exec(body);
     }
     return blocks;
 }

package/dist/schema/parser.d.ts

@@ -1,7 +1,7 @@
 /**
  * Parse Markdown requirements files into typed structures.
  */
-import { RequirementNode, RequirementsFile, ParsedCriterion } from './schemas.js';
+import { type ParsedCriterion, type RequirementNode, type RequirementsFile } from "./schemas.js";
 /**
  * Parse a criterion line in "position. Label → content" format.
  * Example: "0. Given → user has valid credentials"
@@ -18,14 +18,14 @@ export declare function parseRequirementBlock(key: string, blockContent: string)
  * Parse a complete requirements Markdown file.
  */
 export declare function parseRequirementsFile(markdownContent: string): {
-    metadata: RequirementsFile['_meta'];
+    metadata: RequirementsFile["_meta"];
     requirements: RequirementNode[];
 };
 /**
  * Parse requirements file from disk.
  */
 export declare function parseRequirementsFromFile(filePath: string): {
-    metadata: RequirementsFile['_meta'];
+    metadata: RequirementsFile["_meta"];
     requirements: RequirementNode[];
 };
 /**

package/dist/schema/parser.js

@@ -1,15 +1,10 @@
 /**
  * Parse Markdown requirements files into typed structures.
  */
-import YAML from 'yaml';
-import * as fs from 'fs';
-import { ValidationError, validateMetadata, } from './schemas.js';
-/**
- * Default delimiter for requirements.
- * Can be overridden for organization-specific preferences.
- */
-const DEFAULT_DELIMITER = '→';
-const DELIMITER_PATTERN = '(?:→|->)'; // Non-capturing group for both Unicode and ASCII
+import * as fs from "node:fs";
+import YAML from "yaml";
+import { ValidationError, validateMetadata, } from "./schemas.js";
+const DELIMITER_PATTERN = "(?:→|->)"; // Non-capturing group for both Unicode and ASCII
 /**
  * Parse a criterion line in "position. Label → content" format.
  * Example: "0. Given → user has valid credentials"
@@ -26,7 +21,7 @@ export function parseCriterionLine(line, delimiter = DELIMITER_PATTERN) {
     }
     return {
         position: match[1],
-        label: match[2] ? match[2].trim() : '', // Preserve original case, empty if no label
+        label: match[2] ? match[2].trim() : "", // Preserve original case, empty if no label
         content: match[3].trim(),
     };
 }
@@ -41,7 +36,7 @@ function parseRootLine(line, delimiter = DELIMITER_PATTERN) {
     const keyMatch = trimmed.match(/^([\w-]+):\s*(.+)$/);
     if (keyMatch) {
         return {
-            label: '', // Keys use empty string for unlabeled requirements
+            label: "", // Keys use empty string for unlabeled requirements
             content: keyMatch[2].trim(),
         };
     }
@@ -51,12 +46,12 @@ function parseRootLine(line, delimiter = DELIMITER_PATTERN) {
     if (!match) {
         // If no delimiter found, treat entire line as content with empty label
         return {
-            label: '',
+            label: "",
             content: trimmed,
         };
     }
     return {
-        label: match[1] ? match[1].trim() : '',
+        label: match[1] ? match[1].trim() : "",
         content: match[2].trim(),
     };
 }
@@ -66,20 +61,20 @@ function parseRootLine(line, delimiter = DELIMITER_PATTERN) {
  * Subsequent lines are criteria with position paths.
  */
 export function parseRequirementBlock(key, blockContent) {
-    const lines = blockContent.trim().split('\n');
+    const lines = blockContent.trim().split("\n");
     if (lines.length === 0) {
-        throw new ValidationError('Empty requirement block', key);
+        throw new ValidationError("Empty requirement block", key);
     }
     // First line is the requirement content
     const rootParsed = parseRootLine(lines[0]);
     if (!rootParsed.content) {
-        throw new ValidationError('Requirement content (first line) cannot be empty', key);
+        throw new ValidationError("Requirement content (first line) cannot be empty", key);
     }
     const root = {
         id: key,
         // Root requirements always use "requirementHeader" label for indexing/querying
         // The markdown format doesn't preserve root labels, but we standardize on this value
-        label: 'requirementHeader',
+        label: "requirementHeader",
         content: rootParsed.content,
         children: [],
     };
@@ -88,7 +83,7 @@ export function parseRequirementBlock(key, blockContent) {
     for (let i = 1; i < lines.length; i++) {
         const line = lines[i];
         // Skip empty lines and comments
-        if (!line.trim() || line.trim().startsWith('#')) {
+        if (!line.trim() || line.trim().startsWith("#")) {
             continue;
         }
         const criterion = parseCriterionLine(line);
@@ -108,8 +103,8 @@ export function parseRequirementBlock(key, blockContent) {
 function buildTreeFromPositions(root, rootKey, criteriaByPosition) {
     // Get all top-level children (single digit positions: "0", "1", "2")
     const topLevelPositions = Array.from(criteriaByPosition.keys())
-        .filter(pos => !pos.includes('.'))
-        .sort((a, b) => parseInt(a) - parseInt(b));
+        .filter((pos) => !pos.includes("."))
+        .sort((a, b) => parseInt(a, 10) - parseInt(b, 10));
     for (const position of topLevelPositions) {
         const criterion = criteriaByPosition.get(position);
         const childNode = {
@@ -129,9 +124,9 @@ function buildTreeFromPositions(root, rootKey, criteriaByPosition) {
 function buildChildrenFromPositions(parent, parentPosition, rootKey, criteriaByPosition) {
     // Find direct children (e.g., if parent is "1", find "1.0", "1.1", etc.)
     const childPositions = Array.from(criteriaByPosition.keys())
-        .filter(pos => {
-        const parts = pos.split('.');
-        const parentParts = parentPosition.split('.');
+        .filter((pos) => {
+        const parts = pos.split(".");
+        const parentParts = parentPosition.split(".");
         // Must be exactly one level deeper
         if (parts.length !== parentParts.length + 1) {
             return false;
@@ -145,8 +140,8 @@ function buildChildrenFromPositions(parent, parentPosition, rootKey, criteriaByP
         return true;
     })
         .sort((a, b) => {
-        const aLast = parseInt(a.split('.').pop());
-        const bLast = parseInt(b.split('.').pop());
+        const aLast = parseInt(a.split(".").pop(), 10);
+        const bLast = parseInt(b.split(".").pop(), 10);
         return aLast - bLast;
     });
     for (const position of childPositions) {
@@ -171,7 +166,7 @@ function extractFrontmatter(content) {
     const frontmatterRegex = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
     const match = content.match(frontmatterRegex);
     if (!match) {
-        throw new ValidationError('Missing YAML frontmatter (should start with ---)');
+        throw new ValidationError("Missing YAML frontmatter (should start with ---)");
     }
     const [, frontmatterYaml, body] = match;
     let frontmatter;
@@ -179,7 +174,7 @@ function extractFrontmatter(content) {
         frontmatter = YAML.parse(frontmatterYaml);
     }
     catch (error) {
-        throw new ValidationError('Failed to parse YAML frontmatter', undefined, error);
+        throw new ValidationError("Failed to parse YAML frontmatter", undefined, error);
     }
     return { frontmatter, body: body.trim() };
 }
@@ -194,8 +189,8 @@ function extractRequirementBlocks(body) {
     const blocks = new Map();
     // Find all ```dotrequirements code blocks
     const blockRegex = /```dotrequirements\n([\s\S]*?)```/gm;
-    let match;
-    while ((match = blockRegex.exec(body)) !== null) {
+    let match = blockRegex.exec(body);
+    while (match !== null) {
         const blockContent = match[1];
         // Extract key from first line of block (format: "KEY: content")
         const firstLineMatch = blockContent.match(/^([\w-]+):\s*(.+)/);
@@ -209,6 +204,7 @@ function extractRequirementBlocks(body) {
         const headingMatch = textBeforeBlock.match(/^#{2,6}\s+([^\n]+)\s*$/m);
         const title = headingMatch ? headingMatch[1].trim() : key;
         blocks.set(key, { title, blockContent: blockContent.trim() });
+        match = blockRegex.exec(body);
     }
     return blocks;
 }
@@ -223,7 +219,7 @@ export function parseRequirementsFile(markdownContent) {
     // Extract requirement blocks
     const blocks = extractRequirementBlocks(body);
     if (blocks.size === 0) {
-        throw new ValidationError('No requirement blocks found in document');
+        throw new ValidationError("No requirement blocks found in document");
     }
     // Parse each requirement block
     const requirements = [];
@@ -246,7 +242,7 @@ export function parseRequirementsFile(markdownContent) {
  */
 export function parseRequirementsFromFile(filePath) {
     try {
-        const content = fs.readFileSync(filePath, 'utf-8');
+        const content = fs.readFileSync(filePath, "utf-8");
         return parseRequirementsFile(content);
     }
     catch (error) {

package/dist/schema/resolver.d.ts

@@ -2,7 +2,7 @@
  * Resolve label-based requirement paths to numeric paths.
  * Supports: REQ123.given, REQ123.when.then, REQ123.given#1
  */
-import { RequirementNode } from './schemas.js';
+import type { RequirementNode } from "./schemas.js";
 /**
  * Parse a requirement path into segments.
  * E.g., "REQ123.given.then" → ["REQ123", "given", "then"]

package/dist/schema/resolver.js

@@ -8,7 +8,7 @@
  * E.g., "REQ123.given#1" → ["REQ123", "given#1"]
  */
 export function parseRequirementPath(path) {
-    return path.split('.');
+    return path.split(".");
 }
 /**
  * Parse a path segment that may include disambiguation.
@@ -22,7 +22,7 @@ export function parsePathSegment(segment) {
     }
     return {
         label: match[1],
-        index: match[2] ? parseInt(match[2]) : 0,
+        index: match[2] ? parseInt(match[2], 10) : 0,
     };
 }
 /**
@@ -31,7 +31,7 @@ export function parsePathSegment(segment) {
  * Examples: "Several-words" -> "several words", "AC" -> "ac"
  */
 function normalizeLabel(label) {
-    return label.replace(/-/g, ' ').toLowerCase();
+    return label.replace(/-/g, " ").toLowerCase();
 }
 /**
  * Find children matching a label.
@@ -40,7 +40,7 @@ function normalizeLabel(label) {
  */
 export function findChildrenByLabel(node, label) {
     const normalizedLabel = normalizeLabel(label);
-    return node.children.filter(child => normalizeLabel(child.label) === normalizedLabel);
+    return node.children.filter((child) => normalizeLabel(child.label) === normalizedLabel);
 }
 /**
  * Resolve a label-based path segment to a numeric index.
@@ -49,7 +49,7 @@ export function findChildrenByLabel(node, label) {
 export function resolvePathSegment(node, segment) {
     // Check if segment is numeric (direct index)
     if (/^\d+$/.test(segment)) {
-        const index = parseInt(segment);
+        const index = parseInt(segment, 10);
         if (index < node.children.length) {
             return {
                 child: node.children[index],
@@ -94,7 +94,7 @@ export function resolveRequirementPath(requirements, path) {
     }
     // First segment should be the root requirement ID
     const rootId = segments[0];
-    let currentNode = requirements.find(r => r.id === rootId);
+    let currentNode = requirements.find((r) => r.id === rootId);
     if (!currentNode) {
         return null;
     }
@@ -130,7 +130,7 @@ export function resolveToNumericPath(requirements, path) {
  *
  * Returns paths like: ["REQ123", "REQ123.given", "REQ123.when", ...]
  */
-export function getAllLabelPaths(node, prefix = '') {
+export function getAllLabelPaths(node, prefix = "") {
     const currentPath = prefix ? `${prefix}.${node.label}` : node.id;
     const paths = [currentPath];
     for (const child of node.children) {
@@ -148,7 +148,7 @@ export function checkPathAmbiguity(requirements, path) {
         return 0;
     }
     const rootId = segments[0];
-    let currentNode = requirements.find(r => r.id === rootId);
+    let currentNode = requirements.find((r) => r.id === rootId);
     if (!currentNode) {
         return 0;
     }
@@ -160,7 +160,7 @@ export function checkPathAmbiguity(requirements, path) {
         const segment = segments[i];
         // Numeric segments are never ambiguous
         if (/^\d+$/.test(segment)) {
-            const index = parseInt(segment);
+            const index = parseInt(segment, 10);
             if (index >= currentNode.children.length) {
                 return 0; // Invalid path
             }

package/dist/schema/scenario.d.ts

@@ -1,7 +1,7 @@
 /**
  * Scenario builder — turns a requirement tree into a browser-automation Scenario.
  *
- * Used by both the CLI (via `dotreq browsertest`) and the Convex Node action
+ * Used by both the CLI (via `dotreq acceptance-test`) and the Convex Node action
  * (`testCoverage/browserRun:run`) so the two paths produce identical scenarios
  * for the same input.
  *

package/dist/schema/scenario.js

@@ -1,7 +1,7 @@
 /**
  * Scenario builder — turns a requirement tree into a browser-automation Scenario.
  *
- * Used by both the CLI (via `dotreq browsertest`) and the Convex Node action
+ * Used by both the CLI (via `dotreq acceptance-test`) and the Convex Node action
  * (`testCoverage/browserRun:run`) so the two paths produce identical scenarios
  * for the same input.
  *

package/dist/schema/schemas.d.ts

@@ -2,7 +2,7 @@
  * Zod schemas for Markdown requirements format.
  * TypeScript types are inferred from these schemas using z.infer<>.
  */
-import { z } from 'zod';
+import { z } from "zod";
 /**
  * Requirement prefix format: uppercase letters and hyphens, 1-30 chars.
  * First char must be a letter.
@@ -100,7 +100,7 @@ export declare const CONVEX_ID_PATTERN: RegExp;
  */
 export type PushValidationResult = {
     valid: true;
-    action: 'create' | 'update';
+    action: "create" | "update";
     warning?: string;
 } | {
     valid: false;
@@ -246,7 +246,7 @@ export declare const RequirementsFileSchema: z.ZodObject<{
     }>;
 }, z.ZodTypeAny, "passthrough">>;
 export type RequirementsFile = z.infer<typeof RequirementsFileSchema> & {
-    [key: string]: any;
+    [key: string]: unknown;
 };
 /**
  * Parsed criterion from Markdown (position. Label: content format)