@promptbook/components 0.114.0-0 → 0.114.0-2

package/README.md

@@ -647,26 +647,27 @@ ptbk coder verify
 | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
 | `ptbk coder init`                     | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `/.promptbook`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
 | `ptbk coder generate-boilerplates`    | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root.                                                                                                                                                                                                                                                                         |
-| `ptbk coder run`                      | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled.                                                                                                                                                                  |
+| `ptbk coder run`                      | Picks the next ready prompt, can run tests before coding to stop or repair pre-existing failures, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled.                                                                                             |
 | `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow                                                                                                                                                                                                                                                                                                                                                         | low | medium | high | xhigh | extreme>` ranges from a very benevolent scan to a very aggressive sweep. |
 | `ptbk coder verify`                   | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results.                                                                                                                                                                                                                                                                                                                                                    |
 
 #### Most useful `ptbk coder run` flags
 
-| Flag                       | Purpose                                                                                            |
-| -------------------------- | -------------------------------------------------------------------------------------------------- |
-| `--harness <name>`         | Selects the coding harness.                                                                        |
-| `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
-| `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                 |
-| `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.   |
-| `--thinking-level <level>` | Sets reasoning effort for supported runners.                                                       |
-| `--no-auto`                | Waits for user confirmation before each prompt instead of running automatically through the queue. |
-| `--ignore-git-changes`     | Disables the clean-working-tree guard.                                                             |
-| `--priority <n>`           | Runs only prompts at or above the given priority.                                                  |
-| `--dry-run`                | Prints which prompts are ready instead of executing them.                                          |
-| `--allow-credits`          | Lets OpenAI Codex spend credits when required.                                                     |
-| `--auto-push`              | Pushes each successful coding-agent commit to the configured remote.                               |
-| `--auto-migrate`           | Runs testing-server database migrations after each successful prompt.                              |
+| Flag                       | Purpose                                                                                                                                                                                |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--harness <name>`         | Selects the coding harness.                                                                                                                                                            |
+| `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`.                                                                                     |
+| `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                                                                                                     |
+| `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.                                                                                       |
+| `--test-before <mode>`     | Runs tests before coding: `no` (default), `yes-and-fail` (stop with results), or `yes-and-fix` (create one repair prompt first); defaults to `npm test` when enabled without `--test`. |
+| `--thinking-level <level>` | Sets reasoning effort for supported runners.                                                                                                                                           |
+| `--no-auto`                | Waits for user confirmation before each prompt instead of running automatically through the queue.                                                                                     |
+| `--ignore-git-changes`     | Disables the clean-working-tree guard.                                                                                                                                                 |
+| `--priority <n>`           | Runs only prompts at or above the given priority.                                                                                                                                      |
+| `--dry-run`                | Prints which prompts are ready instead of executing them.                                                                                                                              |
+| `--allow-credits`          | Lets OpenAI Codex spend credits when required.                                                                                                                                         |
+| `--auto-push`              | Pushes each successful coding-agent commit to the configured remote.                                                                                                                   |
+| `--auto-migrate`           | Runs testing-server database migrations after each successful prompt.                                                                                                                  |
 
 #### Typical usage pattern
 

package/esm/index.es.js

@@ -41,7 +41,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.114.0-0';
+const PROMPTBOOK_ENGINE_VERSION = '0.114.0-2';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -28093,6 +28093,14 @@ const DETAILS_PLACEHOLDER_WRAPPED_REGEX = new RegExp(`<p>\\s*(${DETAILS_PLACEHOL
  * @private utility of `renderMarkdown`
  */
 const INLINE_REFERENCE_REGEX = /\[\[([^\]\r\n]+?)\]\]/g;
+/**
+ * Pattern matching ordinary markdown links that can be promoted to inline reference chips.
+ *
+ * Images are intentionally captured separately and left unchanged by the replacement helper.
+ *
+ * @private utility of `renderMarkdown`
+ */
+const MARKDOWN_INLINE_REFERENCE_LINK_REGEX = /(!?)\[([^\]\r\n]*)\]\(\s*(<[^>\r\n]+>|[^)\s]+)(?:\s+(?:"[^"\r\n]*"|'[^'\r\n]*'|\([^)]*\)))?\s*\)/g;
 /**
  * Collection of math delimiter definitions.
  */
@@ -28330,11 +28338,12 @@ const CHAT_MARKDOWN_CONVERTER = createChatMarkdownConverter();
  * outer `<details>` and optional `<summary>` markup untouched.
  *
  * @param detailsBlock - Raw `<details>...</details>` HTML captured from markdown.
+ * @param options - Markdown rendering options to reuse for the details body.
  * @returns `<details>` HTML whose body has been converted from markdown to HTML.
  *
  * @private utility of `renderMarkdown`
  */
-function renderDetailsBlock(detailsBlock) {
+function renderDetailsBlock(detailsBlock, options) {
     var _a, _b;
     const openTagMatch = detailsBlock.match(/^<details\b[^>]*>/i);
     const closeTagMatch = detailsBlock.match(/<\/details\s*>$/i);
@@ -28347,7 +28356,7 @@ function renderDetailsBlock(detailsBlock) {
     const summaryMatch = innerContent.match(/^(\s*<summary\b[^>]*>[\s\S]*?<\/summary\s*>)([\s\S]*)$/i);
     const summaryHtml = (_a = summaryMatch === null || summaryMatch === void 0 ? void 0 : summaryMatch[1]) !== null && _a !== void 0 ? _a : '';
     const bodyMarkdown = ((_b = summaryMatch === null || summaryMatch === void 0 ? void 0 : summaryMatch[2]) !== null && _b !== void 0 ? _b : innerContent);
-    const renderedBody = renderMarkdown(bodyMarkdown);
+    const renderedBody = renderMarkdown(bodyMarkdown, options);
     return `${openTag}${summaryHtml}${renderedBody}${closeTag}`;
 }
 /**
@@ -28384,16 +28393,17 @@ function maskMarkdownCodeSegments(markdown) {
  * processes their content.
  *
  * @param markdown - Markdown text that may contain raw HTML `<details>` blocks.
+ * @param options - Markdown rendering options to reuse for the details body.
  * @returns Masked markdown and a restore helper that returns `string_html`.
  *
  * @private utility of `renderMarkdown`
  */
-function maskDetailsBlocks(markdown) {
+function maskDetailsBlocks(markdown, options) {
     const blocks = [];
     DETAILS_BLOCK_REGEX.lastIndex = 0;
     const masked = markdown.replace(DETAILS_BLOCK_REGEX, (match) => {
         const placeholder = `${DETAILS_PLACEHOLDER_PREFIX}${blocks.length}__`;
-        blocks.push(renderDetailsBlock(match));
+        blocks.push(renderDetailsBlock(match, options));
         return placeholder;
     });
     return {
@@ -28494,6 +28504,79 @@ function createMarkdownInlineReferenceByKey(references) {
     }
     return referenceByKey;
 }
+/**
+ * Returns whether a href starts with a configured source href prefix.
+ *
+ * @param href - Markdown link destination.
+ * @param sourceHrefPrefix - Configured source href prefix.
+ * @returns Whether the href belongs to the source prefix.
+ *
+ * @private utility of `renderMarkdown`
+ */
+function doesHrefStartWithSourceHrefPrefix(href, sourceHrefPrefix) {
+    if (href === sourceHrefPrefix) {
+        return true;
+    }
+    const normalizedSourceHrefPrefix = sourceHrefPrefix.endsWith('/') ? sourceHrefPrefix : `${sourceHrefPrefix}/`;
+    return href.startsWith(normalizedSourceHrefPrefix);
+}
+/**
+ * Returns a comparable path for an absolute href when the configured source prefix is relative.
+ *
+ * @param href - Href to normalize.
+ * @returns Absolute URL pathname or the original href when it is relative/invalid.
+ *
+ * @private utility of `renderMarkdown`
+ */
+function resolveAbsoluteHrefPath(href) {
+    try {
+        return new URL(href).pathname;
+    }
+    catch (_a) {
+        return href;
+    }
+}
+/**
+ * Returns whether one markdown link destination belongs to one inline reference.
+ *
+ * Relative project paths also match absolute URLs on the current server, which keeps
+ * server-generated relative links and model-generated absolute links consistent.
+ *
+ * @param reference - Candidate inline reference.
+ * @param href - Markdown link destination.
+ * @returns Whether the href should render as the reference chip.
+ *
+ * @private utility of `renderMarkdown`
+ */
+function doesMarkdownInlineReferenceMatchHref(reference, href) {
+    const normalizedHref = href.trim();
+    return (reference.sourceHrefPrefixes || []).some((sourceHrefPrefix) => {
+        const normalizedSourceHrefPrefix = sourceHrefPrefix.trim();
+        if (!normalizedSourceHrefPrefix) {
+            return false;
+        }
+        if (doesHrefStartWithSourceHrefPrefix(normalizedHref, normalizedSourceHrefPrefix)) {
+            return true;
+        }
+        const isRelativeSourceHrefPrefix = !/^[a-z][a-z0-9+.-]*:/i.test(normalizedSourceHrefPrefix);
+        const isAbsoluteHref = /^[a-z][a-z0-9+.-]*:/i.test(normalizedHref);
+        return (isRelativeSourceHrefPrefix &&
+            isAbsoluteHref &&
+            doesHrefStartWithSourceHrefPrefix(resolveAbsoluteHrefPath(normalizedHref), normalizedSourceHrefPrefix));
+    });
+}
+/**
+ * Finds the inline reference represented by a markdown link destination.
+ *
+ * @param references - Inline references available to the markdown renderer.
+ * @param href - Markdown link destination.
+ * @returns Matching reference or `undefined` when the href is unrelated.
+ *
+ * @private utility of `renderMarkdown`
+ */
+function findMarkdownInlineReferenceByHref(references, href) {
+    return references.find((reference) => doesMarkdownInlineReferenceMatchHref(reference, href));
+}
 /**
  * Renders one inline reference as raw HTML that is sanitized by the shared markdown sanitizer.
  *
@@ -28573,10 +28656,18 @@ function applyMarkdownInlineReferences(markdown, options) {
     if (referenceByKey.size === 0) {
         return markdown;
     }
-    return markdown.replace(INLINE_REFERENCE_REGEX, (match, rawReference) => {
+    const markdownWithInlineReferenceTokens = markdown.replace(INLINE_REFERENCE_REGEX, (match, rawReference) => {
         const reference = referenceByKey.get(normalizeMarkdownInlineReferenceKey(rawReference));
         return reference ? renderMarkdownInlineReferenceHtml(reference, className) : match;
     });
+    return markdownWithInlineReferenceTokens.replace(MARKDOWN_INLINE_REFERENCE_LINK_REGEX, (match, imageMarker, _linkLabel, rawHref) => {
+        if (imageMarker) {
+            return match;
+        }
+        const href = rawHref.replace(/^<|>$/g, '');
+        const reference = findMarkdownInlineReferenceByHref(references, href);
+        return reference ? renderMarkdownInlineReferenceHtml(reference, className) : match;
+    });
 }
 /**
  * Loads KaTeX CSS in browser environments that need to display math output.
@@ -28614,7 +28705,7 @@ function renderMarkdown(markdown, options) {
     const converter = options ? createChatMarkdownConverter(options) : CHAT_MARKDOWN_CONVERTER;
     try {
         const normalizedMarkdown = normalizeMarkdownSublists(markdown);
-        const { masked: maskedMarkdown, restore: restoreDetails } = maskDetailsBlocks(normalizedMarkdown);
+        const { masked: maskedMarkdown, restore: restoreDetails } = maskDetailsBlocks(normalizedMarkdown, options);
         const { masked: codeMaskedMarkdown, restore: restoreCode } = maskMarkdownCodeSegments(maskedMarkdown);
         const referencedMarkdown = applyMarkdownInlineReferences(codeMaskedMarkdown, options);
         const inlineReferenceMarkdown = restoreCode(referencedMarkdown);