npm - @promptbook/cli - Versions diffs - 0.114.0-0 → 0.114.0-10 - Mend

@promptbook/cli 0.114.0-0 → 0.114.0-10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (750) hide show

package/umd/scripts/run-codex-prompts/server/coderServerHtml.d.ts CHANGED Viewed

@@ -6,4 +6,4 @@
  *
  * @private internal constant of `ptbk coder server`
  */
-export declare const CODER_SERVER_HTML = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Ptbk Coder Server</title>\n  <style>\n    * { box-sizing: border-box; margin: 0; padding: 0; }\n    body {\n      font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;\n      background: #f6f7f9;\n      color: #1f2933;\n      min-height: 100vh;\n    }\n\n    header {\n      background: #22313f;\n      color: white;\n      padding: 12px 18px;\n      display: flex;\n      align-items: center;\n      gap: 12px;\n      position: sticky;\n      top: 0;\n      z-index: 10;\n      box-shadow: 0 2px 10px rgba(15,23,42,0.22);\n    }\n    header h1 { font-size: 17px; font-weight: 700; flex-shrink: 0; letter-spacing: 0; }\n\n    .status-badge {\n      padding: 3px 10px;\n      border-radius: 999px;\n      font-size: 11px;\n      font-weight: 700;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-RUNNING { background: #0b875b; color: white; }\n    .status-PAUSING { background: #d97904; color: white; }\n    .status-PAUSED { background: #b42318; color: white; }\n\n    #pause-label {\n      font-size: 12px;\n      color: rgba(255,255,255,0.75);\n      flex: 1;\n      min-width: 0;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n\n    .btn {\n      padding: 6px 12px;\n      border: 0;\n      border-radius: 4px;\n      cursor: pointer;\n      font-size: 13px;\n      font-weight: 700;\n      transition: background 0.15s, opacity 0.15s;\n      flex-shrink: 0;\n    }\n    .btn:disabled { opacity: 0.55; cursor: default; }\n    .btn-pause { background: #ffd166; color: #1f2933; }\n    .btn-resume { background: #0b875b; color: white; }\n    .btn-save { background: #2563eb; color: white; }\n    .btn-cancel { background: #edf0f4; color: #1f2933; }\n\n    .run-strip {\n      background: white;\n      border-bottom: 1px solid #d8dee8;\n      padding: 12px 18px;\n      display: grid;\n      grid-template-columns: minmax(220px, 1.2fr) minmax(240px, 1fr) minmax(260px, 1.4fr);\n      gap: 14px;\n      align-items: center;\n    }\n    .run-title {\n      font-size: 14px;\n      font-weight: 700;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .run-subtitle,\n    .run-current,\n    .run-output {\n      color: #64748b;\n      font-size: 12px;\n      line-height: 1.45;\n      overflow: hidden;\n    }\n    .run-current,\n    .run-output {\n      display: -webkit-box;\n      -webkit-box-orient: vertical;\n      -webkit-line-clamp: 2;\n    }\n    .progress-shell {\n      display: grid;\n      grid-template-columns: 1fr auto;\n      gap: 8px;\n      align-items: center;\n    }\n    .progress-track {\n      height: 10px;\n      background: #e4e9f0;\n      border-radius: 999px;\n      overflow: hidden;\n    }\n    .progress-fill {\n      display: block;\n      height: 100%;\n      width: 0;\n      background: linear-gradient(90deg, #0b875b, #2563eb);\n      transition: width 0.2s;\n    }\n    .progress-label {\n      color: #475569;\n      font-size: 12px;\n      font-weight: 700;\n      min-width: 72px;\n      text-align: right;\n    }\n\n    .board {\n      display: flex;\n      gap: 14px;\n      padding: 16px;\n      overflow-x: auto;\n      min-height: calc(100vh - 119px);\n      align-items: flex-start;\n    }\n\n    .column {\n      background: #e9edf3;\n      border-top: 4px solid #94a3b8;\n      border-radius: 6px;\n      padding: 10px;\n      min-width: 250px;\n      width: 270px;\n      flex-shrink: 0;\n    }\n    .column-backlog { border-top-color: #64748b; }\n    .column-low-priority { border-top-color: #d97904; }\n    .column-todo { border-top-color: #2563eb; }\n    .column-in-progress { border-top-color: #7c3aed; }\n    .column-done { border-top-color: #0b875b; }\n    .column-errors { border-top-color: #b42318; }\n    .column-finished { border-top-color: #0891b2; }\n\n    .column-header {\n      font-size: 12px;\n      font-weight: 800;\n      text-transform: uppercase;\n      color: #475569;\n      margin-bottom: 10px;\n      display: flex;\n      align-items: center;\n      justify-content: space-between;\n      gap: 8px;\n    }\n    .column-count {\n      background: rgba(255,255,255,0.72);\n      border-radius: 999px;\n      padding: 2px 8px;\n      font-size: 11px;\n      color: #475569;\n    }\n    .column-cards { min-height: 40px; }\n\n    .card {\n      background: white;\n      border-radius: 6px;\n      padding: 10px 12px;\n      margin-bottom: 8px;\n      box-shadow: 0 1px 3px rgba(15,23,42,0.12);\n      cursor: pointer;\n      border-left: 3px solid #94a3b8;\n    }\n    .card:hover { box-shadow: 0 4px 12px rgba(15,23,42,0.16); }\n    .card-backlog { border-left-color: #64748b; }\n    .card-low-priority { border-left-color: #d97904; }\n    .card-todo { border-left-color: #2563eb; }\n    .card-in-progress { border-left-color: #7c3aed; }\n    .card-done { border-left-color: #0b875b; }\n    .card-errors { border-left-color: #b42318; }\n    .card-finished { border-left-color: #0891b2; }\n\n    .card-file {\n      font-size: 10px;\n      color: #7b8794;\n      margin-bottom: 6px;\n      font-weight: 600;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .card-summary {\n      font-size: 13px;\n      line-height: 1.45;\n      color: #1f2933;\n      word-break: break-word;\n      white-space: pre-wrap;\n      max-height: 76px;\n      overflow: hidden;\n      display: -webkit-box;\n      -webkit-line-clamp: 4;\n      -webkit-box-orient: vertical;\n    }\n    .card-tags {\n      display: flex;\n      flex-wrap: wrap;\n      gap: 5px;\n      margin-top: 8px;\n    }\n    .card-tag {\n      border-radius: 999px;\n      padding: 2px 7px;\n      font-size: 10px;\n      font-weight: 800;\n      line-height: 1.35;\n    }\n    .tag-not-ready { background: #e2e8f0; color: #475569; }\n    .tag-unwritten { background: #fff4cc; color: #8a5a00; }\n    .tag-implementing { background: #ede9fe; color: #5b21b6; }\n    .tag-verifying { background: #fae8ff; color: #86198f; }\n    .tag-priority { background: #ffedd5; color: #9a3412; }\n\n    .empty-column {\n      color: #94a3b8;\n      font-size: 12px;\n      padding: 10px 4px;\n      text-align: center;\n    }\n\n    .modal-overlay {\n      position: fixed;\n      inset: 0;\n      background: rgba(15,23,42,0.58);\n      display: flex;\n      align-items: flex-start;\n      justify-content: center;\n      padding: 56px 16px 16px;\n      z-index: 100;\n    }\n    .modal-overlay.hidden { display: none; }\n\n    .modal {\n      background: white;\n      border-radius: 8px;\n      width: 100%;\n      max-width: 720px;\n      padding: 18px;\n      box-shadow: 0 14px 40px rgba(15,23,42,0.28);\n    }\n    .modal-header {\n      display: flex;\n      align-items: flex-start;\n      justify-content: space-between;\n      margin-bottom: 14px;\n      gap: 12px;\n    }\n    .modal-meta { flex: 1; min-width: 0; }\n    .modal-file {\n      font-size: 11px;\n      color: #7b8794;\n      margin-bottom: 4px;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .modal-section-label { font-size: 14px; font-weight: 700; color: #1f2933; }\n    .modal-status {\n      font-size: 11px;\n      font-weight: 800;\n      padding: 3px 8px;\n      border-radius: 999px;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-backlog { background: #e2e8f0; color: #475569; }\n    .status-low-priority { background: #ffedd5; color: #9a3412; }\n    .status-todo { background: #dbeafe; color: #1d4ed8; }\n    .status-in-progress { background: #ede9fe; color: #5b21b6; }\n    .status-done { background: #dcfce7; color: #166534; }\n    .status-errors { background: #fee2e2; color: #991b1b; }\n    .status-finished { background: #cffafe; color: #155e75; }\n    .modal-close {\n      background: transparent;\n      border: 0;\n      color: #64748b;\n      cursor: pointer;\n      font-size: 20px;\n      padding: 0 4px;\n      line-height: 1;\n    }\n    .modal-close:hover { color: #1f2933; }\n\n    textarea {\n      width: 100%;\n      min-height: 300px;\n      font-family: \"SFMono-Regular\", Consolas, \"Courier New\", monospace;\n      font-size: 13px;\n      border: 2px solid #d8dee8;\n      border-radius: 4px;\n      padding: 10px 12px;\n      resize: vertical;\n      line-height: 1.6;\n      color: #1f2933;\n    }\n    textarea:focus {\n      outline: none;\n      border-color: #2563eb;\n      box-shadow: 0 0 0 3px rgba(37,99,235,0.12);\n    }\n    .modal-actions {\n      display: flex;\n      gap: 8px;\n      margin-top: 14px;\n      justify-content: flex-end;\n    }\n\n    .error-banner {\n      background: #fee2e2;\n      border-bottom: 2px solid #b42318;\n      color: #991b1b;\n      padding: 8px 18px;\n      font-size: 13px;\n      font-weight: 700;\n    }\n    .error-banner.hidden { display: none; }\n\n    @media (max-width: 860px) {\n      header { flex-wrap: wrap; }\n      #pause-label { order: 4; flex-basis: 100%; }\n      .run-strip { grid-template-columns: 1fr; }\n      .board { min-height: calc(100vh - 212px); }\n    }\n  </style>\n</head>\n<body>\n  <div id=\"error-banner\" class=\"error-banner hidden\"></div>\n\n  <header>\n    <h1>Ptbk Coder Server</h1>\n    <span id=\"status-badge\" class=\"status-badge status-RUNNING\">RUNNING</span>\n    <span id=\"pause-label\"></span>\n    <button id=\"toggle-btn\" class=\"btn btn-pause\">Pause</button>\n  </header>\n\n  <section class=\"run-strip\">\n    <div>\n      <div class=\"run-title\" id=\"run-title\">Initializing...</div>\n      <div class=\"run-subtitle\" id=\"run-subtitle\">Loading runner state</div>\n    </div>\n    <div class=\"progress-shell\">\n      <div class=\"progress-track\"><span class=\"progress-fill\" id=\"progress-fill\"></span></div>\n      <div class=\"progress-label\" id=\"progress-label\">0%</div>\n    </div>\n    <div>\n      <div class=\"run-current\" id=\"run-current\">No active prompt</div>\n      <div class=\"run-output\" id=\"run-output\"></div>\n    </div>\n  </section>\n\n  <div class=\"board\" id=\"board\"></div>\n\n  <div class=\"modal-overlay hidden\" id=\"modal-overlay\">\n    <div class=\"modal\">\n      <div class=\"modal-header\">\n        <div class=\"modal-meta\">\n          <div class=\"modal-file\" id=\"modal-file\"></div>\n          <div class=\"modal-section-label\" id=\"modal-section-label\"></div>\n        </div>\n        <span class=\"modal-status\" id=\"modal-status-badge\"></span>\n        <button class=\"modal-close\" id=\"modal-close\" title=\"Close\">&times;</button>\n      </div>\n\n      <textarea id=\"modal-content\" placeholder=\"Prompt content\"></textarea>\n\n      <div class=\"modal-actions\">\n        <button class=\"btn btn-cancel\" id=\"cancel-button\">Cancel</button>\n        <button class=\"btn btn-save\" id=\"save-button\">Save</button>\n      </div>\n    </div>\n  </div>\n\n  <script>\n    \"use strict\";\n\n    const BOARD_COLUMNS = [\n      { id: \"backlog\", title: \"Backlog\" },\n      { id: \"low-priority\", title: \"Outside priority\" },\n      { id: \"todo\", title: \"To do\" },\n      { id: \"in-progress\", title: \"In progress\" },\n      { id: \"done\", title: \"Done\" },\n      { id: \"errors\", title: \"Errors\" },\n      { id: \"finished\", title: \"Finished\" },\n    ];\n\n    let modalState = null;\n    let lastPauseState = \"RUNNING\";\n\n    function getColumnTitle(columnId) {\n      const column = BOARD_COLUMNS.find((columnCandidate) => columnCandidate.id === columnId);\n      return column ? column.title : columnId;\n    }\n\n    function showError(message) {\n      const banner = document.getElementById(\"error-banner\");\n      banner.textContent = message;\n      banner.classList.remove(\"hidden\");\n      clearTimeout(banner.timer);\n      banner.timer = setTimeout(() => banner.classList.add(\"hidden\"), 6000);\n    }\n\n    function escapeHtml(value) {\n      const element = document.createElement(\"div\");\n      element.textContent = String(value);\n      return element.innerHTML;\n    }\n\n    function renderBoardSkeleton() {\n      const board = document.getElementById(\"board\");\n      board.innerHTML = \"\";\n\n      for (const column of BOARD_COLUMNS) {\n        const columnElement = document.createElement(\"section\");\n        columnElement.className = \"column column-\" + column.id;\n        columnElement.innerHTML =\n          '<div class=\"column-header\">' +\n            '<span>' + escapeHtml(column.title) + '</span>' +\n            '<span class=\"column-count\" id=\"count-' + column.id + '\">0</span>' +\n          '</div>' +\n          '<div class=\"column-cards\" id=\"cards-' + column.id + '\">' +\n            '<div class=\"empty-column\">Loading</div>' +\n          '</div>';\n        board.appendChild(columnElement);\n      }\n    }\n\n    async function fetchStatus() {\n      try {\n        const response = await fetch(\"/api/status\");\n        if (!response.ok) {\n          showError(\"Status API error: \" + response.status);\n          return;\n        }\n\n        const status = await response.json();\n        renderPauseState(status);\n        renderRunState(status.runState);\n      } catch (error) {\n        showError(\"Could not reach coder server: \" + error.message);\n      }\n    }\n\n    function renderPauseState(status) {\n      lastPauseState = status.pauseState;\n\n      const badge = document.getElementById(\"status-badge\");\n      badge.textContent = status.pauseState;\n      badge.className = \"status-badge status-\" + status.pauseState;\n\n      const toggleButton = document.getElementById(\"toggle-btn\");\n      const pauseLabel = document.getElementById(\"pause-label\");\n\n      if (status.pauseState === \"RUNNING\") {\n        toggleButton.textContent = \"Pause\";\n        toggleButton.className = \"btn btn-pause\";\n        pauseLabel.textContent = \"\";\n        return;\n      }\n\n      toggleButton.textContent = \"Resume\";\n      toggleButton.className = \"btn btn-resume\";\n      pauseLabel.textContent =\n        (status.pauseState === \"PAUSING\" ? \"Pausing before: \" : \"Paused before: \") +\n        (status.pauseTargetLabel || \"next checkpoint\");\n    }\n\n    function renderRunState(runState) {\n      if (!runState) {\n        document.getElementById(\"run-title\").textContent = \"Waiting for runner state\";\n        document.getElementById(\"run-subtitle\").textContent = \"\";\n        return;\n      }\n\n      const progress = runState.progress || {};\n      const percentage = Number(progress.percentage || 0);\n      const runnerParts = [runState.config.agentName, runState.config.modelName, runState.config.thinkingLevel]\n        .filter(Boolean);\n\n      document.getElementById(\"run-title\").textContent = runState.statusMessage || runState.phase;\n      document.getElementById(\"run-subtitle\").textContent = runnerParts.join(\" / \");\n      document.getElementById(\"progress-fill\").style.width = Math.max(0, Math.min(100, percentage)) + \"%\";\n      document.getElementById(\"progress-label\").textContent =\n        percentage + \"% \" + (progress.sessionDone || 0) + \"/\" + (progress.sessionTotal || 0);\n      document.getElementById(\"run-current\").textContent = runState.currentPromptLabel\n        ? runState.currentPromptLabel + \" - attempt \" + runState.currentAttempt + \"/\" + runState.maxAttempts\n        : \"No active prompt\";\n\n      renderRunOutput(runState);\n    }\n\n    function renderRunOutput(runState) {\n      const statusLines = (runState.agentStatusTableRows || []).map((row) =>\n        row.status + \" - \" + row.agentName + (row.url ? \" - \" + row.url : \"\")\n      );\n      const outputLines = [\n        ...(runState.agentStatusLines || []),\n        ...statusLines,\n        ...(runState.agentOutputLines || []),\n        ...(runState.errors || []).map((errorLine) => \"Error: \" + errorLine),\n      ].slice(-3);\n\n      document.getElementById(\"run-output\").textContent = outputLines.join(\"\\n\");\n    }\n\n    async function fetchPrompts() {\n      try {\n        const response = await fetch(\"/api/prompts\");\n        if (!response.ok) {\n          showError(\"Prompts API error: \" + response.status);\n          return;\n        }\n\n        renderBoard(await response.json());\n      } catch (error) {\n        showError(\"Could not load prompts: \" + error.message);\n      }\n    }\n\n    function renderBoard(promptFiles) {\n      const columns = Object.fromEntries(BOARD_COLUMNS.map((column) => [column.id, []]));\n\n      for (const file of promptFiles) {\n        for (const section of file.sections) {\n          if (columns[section.column]) {\n            columns[section.column].push({ file, section });\n          }\n        }\n      }\n\n      for (const column of BOARD_COLUMNS) {\n        renderColumn(column.id, columns[column.id]);\n      }\n    }\n\n    function renderColumn(columnId, cards) {\n      const container = document.getElementById(\"cards-\" + columnId);\n      const countElement = document.getElementById(\"count-\" + columnId);\n\n      countElement.textContent = cards.length;\n      container.innerHTML = \"\";\n\n      if (cards.length === 0) {\n        container.innerHTML = '<div class=\"empty-column\">Empty</div>';\n        return;\n      }\n\n      for (const cardData of cards) {\n        container.appendChild(createPromptCard(cardData.file, cardData.section));\n      }\n    }\n\n    function createPromptCard(file, section) {\n      const card = document.createElement(\"article\");\n      card.className = \"card card-\" + section.column;\n      card.innerHTML =\n        '<div class=\"card-file\">' + escapeHtml(file.relativeFilePath || file.fileName) + \" #\" + (section.index + 1) + '</div>' +\n        '<div class=\"card-summary\">' + escapeHtml(section.summary) + '</div>' +\n        renderTags(section);\n      card.onclick = () => openModal(file, section);\n      return card;\n    }\n\n    function renderTags(section) {\n      const tags = [...(section.tags || [])];\n      if (section.priority > 0) {\n        tags.push({ id: \"priority\", label: \"P\" + section.priority });\n      }\n\n      if (tags.length === 0) {\n        return \"\";\n      }\n\n      return '<div class=\"card-tags\">' + tags.map((tag) =>\n        '<span class=\"card-tag tag-' + escapeHtml(tag.id) + '\">' + escapeHtml(tag.label) + '</span>'\n      ).join(\"\") + '</div>';\n    }\n\n    function openModal(file, section) {\n      modalState = { filePath: file.filePath, sectionIndex: section.index };\n\n      document.getElementById(\"modal-file\").textContent = file.relativeFilePath || file.fileName;\n      document.getElementById(\"modal-section-label\").textContent = \"Section \" + (section.index + 1);\n\n      const statusBadge = document.getElementById(\"modal-status-badge\");\n      statusBadge.textContent = getColumnTitle(section.column);\n      statusBadge.className = \"modal-status status-\" + section.column;\n\n      document.getElementById(\"modal-content\").value = section.content;\n      document.getElementById(\"modal-overlay\").classList.remove(\"hidden\");\n      setTimeout(() => document.getElementById(\"modal-content\").focus(), 50);\n    }\n\n    function closeModal() {\n      document.getElementById(\"modal-overlay\").classList.add(\"hidden\");\n      modalState = null;\n    }\n\n    async function saveModal() {\n      if (!modalState) {\n        return;\n      }\n\n      const content = document.getElementById(\"modal-content\").value;\n      const saveButton = document.getElementById(\"save-button\");\n      saveButton.disabled = true;\n      saveButton.textContent = \"Saving...\";\n\n      try {\n        const response = await fetch(\"/api/prompts/update\", {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({\n            filePath: modalState.filePath,\n            sectionIndex: modalState.sectionIndex,\n            content,\n          }),\n        });\n\n        if (!response.ok) {\n          throw new Error(\"HTTP \" + response.status);\n        }\n\n        closeModal();\n        await fetchPrompts();\n      } catch (error) {\n        showError(\"Save failed: \" + error.message);\n      } finally {\n        saveButton.disabled = false;\n        saveButton.textContent = \"Save\";\n      }\n    }\n\n    document.getElementById(\"toggle-btn\").onclick = async () => {\n      try {\n        const endpoint = lastPauseState === \"RUNNING\" ? \"/api/pause\" : \"/api/resume\";\n        await fetch(endpoint, { method: \"POST\" });\n        await fetchStatus();\n      } catch (error) {\n        showError(\"Toggle failed: \" + error.message);\n      }\n    };\n\n    document.getElementById(\"modal-close\").onclick = closeModal;\n    document.getElementById(\"cancel-button\").onclick = closeModal;\n    document.getElementById(\"save-button\").onclick = saveModal;\n\n    document.addEventListener(\"keydown\", (event) => {\n      if (event.key === \"Escape\") {\n        closeModal();\n        return;\n      }\n      if ((event.ctrlKey || event.metaKey) && event.key === \"Enter\") {\n        saveModal();\n      }\n    });\n\n    document.getElementById(\"modal-overlay\").addEventListener(\"click\", (event) => {\n      if (event.target === document.getElementById(\"modal-overlay\")) {\n        closeModal();\n      }\n    });\n\n    renderBoardSkeleton();\n    fetchStatus();\n    fetchPrompts();\n    setInterval(fetchStatus, 2000);\n    setInterval(fetchPrompts, 5000);\n  </script>\n</body>\n</html>\n";
+export declare const CODER_SERVER_HTML: string;

package/umd/scripts/run-codex-prompts/server/updatePromptSection.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@
  * Overwrites the body of one prompt section with new content, preserving the status line.
  *
  * The `newContent` string is the prompt text without the status marker.
- * The status line (`[ ]`, `[x]`, `[!]`, `[-]`) is kept intact.
+ * The status line (`[ ]`, `[^]`, `[x]`, `[!]`, `[-]`) is kept intact.
  *
  * @private internal utility of `ptbk coder server`
  */

package/umd/scripts/run-codex-prompts/testing/TestBeforeMode.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+/**
+ * Modes supported by `ptbk coder run --test-before`.
+ */
+export declare const TEST_BEFORE_MODE_VALUES: readonly ["no", "yes-and-fail", "yes-and-fix"];
+/**
+ * Behavior requested for the pre-coding verification run.
+ */
+export type TestBeforeMode = (typeof TEST_BEFORE_MODE_VALUES)[number];
+/**
+ * Default verification command used when a pre-coding mode is enabled without an explicit `--test` command.
+ */
+export declare const DEFAULT_CODER_TEST_COMMAND = "npm test";
+/**
+ * Checks whether a value is a supported `--test-before` mode.
+ */
+export declare function isTestBeforeMode(value: string): value is TestBeforeMode;

package/umd/scripts/run-codex-prompts/testing/createTestBeforeRepairPrompt.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type { PromptSelection } from '../prompts/types/PromptSelection';
+/**
+ * Creates the one queue prompt used to repair a pre-existing test failure.
+ */
+export declare function createTestBeforeRepairPrompt(options: {
+    readonly projectPath: string;
+    readonly testCommand: string;
+    readonly testOutput: string;
+}): Promise<PromptSelection>;

package/umd/scripts/run-codex-prompts/testing/limitTestOutput.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+/**
+ * Limits test output while keeping the end of the output, where test runners usually print the failure summary.
+ */
+export declare function limitTestOutput(testOutput: string): string;

package/umd/scripts/run-codex-prompts/testing/runPromptTestCommand.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * Options for running one verification command after a coding attempt.
  */
-type RunPromptTestCommandOptions = {
+export type RunPromptTestCommandOptions = {
     command: string;
     projectPath: string;
     scriptPath: string;
@@ -12,4 +12,3 @@ type RunPromptTestCommandOptions = {
  * Runs the configured verification command inside the project root and returns its output.
  */
 export declare function runPromptTestCommand(options: RunPromptTestCommandOptions): Promise<string>;
-export {};

package/umd/scripts/run-codex-prompts/testing/runPromptWithTestFeedback.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 import type { CoderRunStep } from '../common/CoderRunStep';
+import { type OnCoderRunStepStarted } from '../common/createCoderRunStepTracker';
 import type { PromptRunOptions } from '../runners/types/PromptRunOptions';
 import type { PromptRunResult } from '../runners/types/PromptRunResult';
 import type { PromptRunner } from '../runners/types/PromptRunner';
@@ -11,6 +12,11 @@ type RunPromptWithTestFeedbackOptions = PromptRunOptions & {
     promptLabel: string;
     testCommand?: string;
     onAttemptStarted?: (attemptCount: number) => void;
+    /**
+     * Notified right before each implementation, testing and fixing step starts, so the caller can
+     * record the in-progress state of the prompt.
+     */
+    onStepStarted?: OnCoderRunStepStarted;
     runPromptTestCommandExecutor?: typeof runPromptTestCommand;
 };
 /**

package/umd/scripts/run-codex-prompts/testing/runTestBefore.d.ts ADDED Viewed

@@ -0,0 +1,24 @@
+import type { WaitForCoderRunPauseCheckpoint } from '../common/CoderRunPauseCheckpoint';
+import { runPromptTestCommand } from './runPromptTestCommand';
+/**
+ * Result of the verification command executed before coding starts.
+ */
+export type TestBeforeResult = {
+    /**
+     * Whether the verification command completed successfully.
+     */
+    readonly isPassed: boolean;
+    /**
+     * Combined output produced by the verification command.
+     */
+    readonly testOutput: string;
+};
+/**
+ * Runs the configured verification command before the first coding prompt.
+ */
+export declare function runTestBefore(options: {
+    readonly testCommand: string;
+    readonly projectPath: string;
+    readonly waitForPauseCheckpoint?: WaitForCoderRunPauseCheckpoint;
+    readonly runPromptTestCommandExecutor?: typeof runPromptTestCommand;
+}): Promise<TestBeforeResult>;

package/umd/scripts/run-codex-prompts/ui/buildCoderRunAgentVisual.d.ts CHANGED Viewed

@@ -28,12 +28,12 @@ export type CoderRunAgentVisual = TerminalAgentAvatarVisual;
  * Builds the ANSI ASCII-art visual of the `--agent` book shown above the coder-run dashboard.
  *
  * The agent's avatar visual is resolved the same way as on the website - the `META AVATAR`
- * commitment wins, then the `META VISUAL` commitment, then the shared default visual - and is
- * rendered dynamically through the shared canvas avatar pipeline into terminal ASCII art.
- * The terminal variant uses a transparent horizontal canvas instead of the website's framed 1:1 surface.
+ * commitment wins, then the `META VISUAL` commitment, then the shared default visual.
+ * Character-based visuals such as `AsciiOctopus` paint the terminal grid directly, while pixel-based
+ * visuals are rendered through the shared canvas avatar pipeline into terminal ASCII art, using a
+ * transparent horizontal canvas instead of the website's framed 1:1 surface.
  *
- * The visual is decorative, so any failure (for example when the optional `@napi-rs/canvas`
- * module is not installed) returns `null` and the caller keeps the default brand banner.
+ * The visual is decorative, so any failure returns `null` and the caller keeps the default brand banner.
  *
  * @param agentSource Source of the `--agent` book file.
  * @returns ANSI-colored ASCII-art renderer or `null` when the visual cannot be rendered.

package/umd/scripts/run-codex-prompts/ui/buildCoderRunUiTerminalFrameUpdate.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+/**
+ * Builds the terminal output required to replace the previous coder-run frame with the next one.
+ *
+ * The complete update is returned as one string so callers can write it atomically. This prevents
+ * animated visuals from producing a separate terminal write for every changed row, which otherwise
+ * leaves a large rendering backlog in terminal emulators while their window is not focused.
+ *
+ * @private internal utility of coder run UI
+ */
+export type BuildCoderRunUiTerminalFrameUpdateOptions = {
+    /** Frame currently displayed in the terminal, with the cursor on its last row. */
+    readonly previousFrameLines: readonly string[];
+    /** Frame that should replace the currently displayed frame. */
+    readonly nextFrameLines: readonly string[];
+};
+/**
+ * Builds one atomic ANSI update that changes the displayed coder-run terminal frame.
+ *
+ * A change in frame height requires a full rewrite to reserve or clear rows correctly. Frames with
+ * the same height only rewrite contiguous groups of changed rows, returning to the frame bottom
+ * between groups so each group can be assembled into the same output payload safely.
+ *
+ * @returns One terminal output payload, or `undefined` when the frame is already up to date.
+ *
+ * @private internal utility of coder run UI
+ */
+export declare function buildCoderRunUiTerminalFrameUpdate(options: BuildCoderRunUiTerminalFrameUpdateOptions): string | undefined;

package/umd/scripts/run-codex-prompts/ui/buildRunUiFrameShared.d.ts CHANGED Viewed

@@ -67,6 +67,7 @@ export declare function buildControlPills(options: {
  * Builds the coder-run control pills shown in the footer box.
  */
 export declare function buildCoderRunControlPills(options: {
+    readonly phase: CoderRunPhase;
     readonly pauseControl: string;
     readonly pendingEnterLabel: string | undefined;
     readonly isEndAfterCurrentPromptRequested: boolean;

package/umd/scripts/verify-prompts/$orderPromptFiles.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type { PromptFile } from '../run-codex-prompts/prompts/types/PromptFile';
+import type { VerifyPromptsOrder } from './VerifyPromptsOrder';
+/**
+ * Orders the loaded prompt files for one verification pass.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - the `random` order is not deterministic
+ * Note: This function does NOT mutate the given array
+ */
+export declare function $orderPromptFiles(promptFiles: ReadonlyArray<PromptFile>, order: VerifyPromptsOrder): PromptFile[];

package/umd/scripts/verify-prompts/VerifyPromptsOrder.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+/**
+ * Orders supported by `ptbk coder verify --order`.
+ */
+export declare const VERIFY_PROMPTS_ORDER_VALUES: readonly ["from-earliest", "from-latest", "random"];
+/**
+ * Order in which the prompt files are processed during one verification run.
+ */
+export type VerifyPromptsOrder = (typeof VERIFY_PROMPTS_ORDER_VALUES)[number];
+/**
+ * Order used when `--order` is not provided.
+ */
+export declare const DEFAULT_VERIFY_PROMPTS_ORDER: VerifyPromptsOrder;
+/**
+ * Human-readable description of each supported order, shared by the CLI help and the verification output.
+ */
+export declare const VERIFY_PROMPTS_ORDER_DESCRIPTIONS: {
+    readonly 'from-earliest': "from the earliest prompt file";
+    readonly 'from-latest': "from the latest prompt file";
+    readonly random: "in random order";
+};
+/**
+ * Parses and validates one raw `--order` value.
+ *
+ * Note: `ptbk coder verify` lets Commander validate the value, this is used by the standalone script which parses the raw arguments itself
+ */
+export declare function parseVerifyPromptsOrder(orderValue: string | undefined): VerifyPromptsOrder;

package/umd/scripts/verify-prompts/verify-prompts.d.ts CHANGED Viewed

@@ -1,16 +1,22 @@
+import type { CoderGitSyncOptions } from '../run-codex-prompts/git/coderGitSync';
 import type { PromptFile } from '../run-codex-prompts/prompts/types/PromptFile';
+import type { VerifyPromptsOrder } from './VerifyPromptsOrder';
 /**
  * Options supported by the prompt verification helper.
  */
 export type VerifyPromptsOptions = {
     /**
-     * Process prompt files in reverse order.
+     * Order in which the prompt files are processed.
      */
-    readonly reverse?: boolean;
+    readonly order?: VerifyPromptsOrder;
     /**
      * Ignore prompt files whose filename or first prompt line contains one of the provided values.
      */
     readonly ignore?: ReadonlyArray<string>;
+    /**
+     * Automatic git synchronization applied around each single verification.
+     */
+    readonly gitSync?: CoderGitSyncOptions;
 };
 /**
  * Starts the verification loop and exits when no `[ ]` prompts remain.

package/umd/src/_packages/components.index.d.ts CHANGED Viewed

@@ -70,8 +70,10 @@ import type { CitationLabelResolver } from '../book-components/Chat/types/Citati
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
 import { parseMessageButtons } from '../book-components/Chat/utils/parseMessageButtons';
 import type { MarkdownInlineReference } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceIcon } from '../book-components/Chat/utils/renderMarkdown';
 import type { MarkdownInlineReferenceMenuStatus } from '../book-components/Chat/utils/renderMarkdown';
 import type { MarkdownInlineReferenceMenuOption } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenuAction } from '../book-components/Chat/utils/renderMarkdown';
 import type { MarkdownInlineReferenceMenu } from '../book-components/Chat/utils/renderMarkdown';
 import { ArrowIcon } from '../book-components/icons/ArrowIcon';
 import { MicIcon } from '../book-components/icons/MicIcon';
@@ -159,8 +161,10 @@ export type { CitationLabelResolver };
 export type { MessageButton };
 export { parseMessageButtons };
 export type { MarkdownInlineReference };
+export type { MarkdownInlineReferenceIcon };
 export type { MarkdownInlineReferenceMenuStatus };
 export type { MarkdownInlineReferenceMenuOption };
+export type { MarkdownInlineReferenceMenuAction };
 export type { MarkdownInlineReferenceMenu };
 export { ArrowIcon };
 export { MicIcon };

package/umd/src/_packages/types.index.d.ts CHANGED Viewed

@@ -62,8 +62,10 @@ import type { CitationLabelResolver } from '../book-components/Chat/types/Citati
 import type { ParsedCitation } from '../book-components/Chat/utils/parseCitationsFromContent';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
 import type { MarkdownInlineReference } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceIcon } from '../book-components/Chat/utils/renderMarkdown';
 import type { MarkdownInlineReferenceMenuStatus } from '../book-components/Chat/utils/renderMarkdown';
 import type { MarkdownInlineReferenceMenuOption } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenuAction } from '../book-components/Chat/utils/renderMarkdown';
 import type { MarkdownInlineReferenceMenu } from '../book-components/Chat/utils/renderMarkdown';
 import type { TeamToolResult } from '../book-components/Chat/utils/toolCallParsing/TeamToolResult';
 import type { QrCodeOptions } from '../book-components/Qr/useQrCode';
@@ -511,8 +513,10 @@ export type { CitationLabelResolver };
 export type { ParsedCitation };
 export type { MessageButton };
 export type { MarkdownInlineReference };
+export type { MarkdownInlineReferenceIcon };
 export type { MarkdownInlineReferenceMenuStatus };
 export type { MarkdownInlineReferenceMenuOption };
+export type { MarkdownInlineReferenceMenuAction };
 export type { MarkdownInlineReferenceMenu };
 export type { TeamToolResult };
 export type { QrCodeOptions };

package/umd/src/avatars/renderAvatarVisualTerminalText.d.ts ADDED Viewed

@@ -0,0 +1,80 @@
+import type { AsciiArtColorDepth } from '../utils/ascii-art/convertImageDataToAsciiArt';
+import type { ResolvedAvatarRenderDefinition } from './renderAvatarVisual';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarSurfaceStyle, AvatarVisualId, AvatarVisualTerminalTextGrid } from './types/AvatarVisualDefinition';
+/**
+ * Options shared by the terminal-text avatar renderers.
+ *
+ * @private within the repository
+ */
+export type RenderAvatarVisualTerminalTextOptions = {
+    /**
+     * Stable visual identity of the rendered agent avatar.
+     */
+    readonly avatarDefinition: AvatarDefinition;
+    /**
+     * Built-in avatar visual to render, the same one used on the website.
+     */
+    readonly visualId: AvatarVisualId;
+    /**
+     * Surface used to derive the avatar palette.
+     *
+     * @default 'framed'
+     */
+    readonly surface?: AvatarSurfaceStyle;
+    /**
+     * Output width in terminal character cells.
+     */
+    readonly columns: number;
+    /**
+     * Output height in terminal character cells.
+     */
+    readonly rows: number;
+    /**
+     * Animation timestamp for animated visuals.
+     */
+    readonly timeMs: number;
+    /**
+     * Optional stable render data reused across frames.
+     */
+    readonly resolvedAvatarRenderDefinition?: ResolvedAvatarRenderDefinition;
+};
+/**
+ * Options for `renderAvatarVisualTerminalTextLines`.
+ *
+ * @private within the repository
+ */
+export type RenderAvatarVisualTerminalTextLinesOptions = RenderAvatarVisualTerminalTextOptions & {
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     *
+     * @default 'TRUE_COLOR'
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+};
+/**
+ * Renders one frame of a character-based avatar visual straight into terminal character cells.
+ *
+ * Visuals which are themselves made of characters, for example `AsciiOctopus`, lose their identity
+ * when they are rasterized onto a canvas and converted back into half-block ASCII art - every glyph
+ * is averaged away into a colored blob. Such visuals expose `renderTerminalText`, which paints the
+ * terminal grid directly and is used instead of the raster pipeline.
+ *
+ * The square avatar is centered inside the requested grid the same way `renderAvatarVisualAsciiArt`
+ * centers the avatar canvas inside a wider terminal frame.
+ *
+ * @param options Avatar identity, visual selection, and output grid size.
+ * @returns Grid of `rows` rows of `columns` cells, or `null` when the visual has no terminal renderer.
+ *
+ * @private within the repository
+ */
+export declare function renderAvatarVisualTerminalTextGrid(options: RenderAvatarVisualTerminalTextOptions): AvatarVisualTerminalTextGrid | null;
+/**
+ * Renders one frame of a character-based avatar visual into ANSI-colored terminal lines.
+ *
+ * @param options Avatar identity, visual selection, output grid size, and ANSI color depth.
+ * @returns One ANSI-colored string per output row, or `null` when the visual has no terminal renderer.
+ *
+ * @private within the repository
+ */
+export declare function renderAvatarVisualTerminalTextLines(options: RenderAvatarVisualTerminalTextLinesOptions): ReadonlyArray<string> | null;

package/umd/src/avatars/types/AvatarVisualDefinition.d.ts CHANGED Viewed

@@ -72,6 +72,52 @@ export type AvatarVisualRenderContext = {
  * @private shared contract for the avatar rendering system
  */
 export type AvatarVisual = (context: AvatarVisualRenderContext) => void;
+/**
+ * One painted character cell of a terminal-text avatar frame.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalTextCell = {
+    /**
+     * Single character painted in the cell.
+     */
+    readonly character: string;
+    /**
+     * Color of the character as a CSS color string, optionally with an alpha channel.
+     */
+    readonly color: string_color;
+};
+/**
+ * One rendered terminal-text avatar frame as a grid of character cells.
+ *
+ * Rows are ordered top to bottom, cells left to right, and `null` leaves the terminal background visible.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalTextGrid = ReadonlyArray<ReadonlyArray<AvatarVisualTerminalTextCell | null>>;
+/**
+ * Rendering context forwarded to a terminal-text avatar visual.
+ *
+ * Unlike `AvatarVisualRenderContext` this carries no canvas, because the visual paints
+ * character cells of a fixed terminal grid instead of pixels.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalTextRenderContext = {
+    readonly columns: number;
+    readonly rows: number;
+    readonly timeMs: number;
+    readonly avatarDefinition: AvatarDefinition;
+    readonly palette: AvatarPalette;
+    readonly createRandom: (salt: string) => () => number;
+    readonly interaction: AvatarInteractionState;
+};
+/**
+ * Signature of one terminal-text avatar visual renderer.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalText = (context: AvatarVisualTerminalTextRenderContext) => AvatarVisualTerminalTextGrid;
 /**
  * Metadata and renderer for one built-in avatar visual.
  *
@@ -84,6 +130,14 @@ export type AvatarVisualDefinition = {
     readonly isAnimated: boolean;
     readonly supportsPointerTracking?: boolean;
     readonly render: AvatarVisual;
+    /**
+     * Optional native terminal renderer of visuals which are themselves made of characters.
+     *
+     * Character-based visuals lose their identity when they are rasterized onto a canvas and
+     * converted back into half-block ASCII art, so they paint the terminal character grid directly.
+     * Visuals without this renderer are rasterized through `renderAvatarVisualAsciiArt` instead.
+     */
+    readonly renderTerminalText?: AvatarVisualTerminalText;
 };
 /**
  * Props of the shared `<Avatar/>` component.

package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts CHANGED Viewed

@@ -31,13 +31,13 @@ export type BookParameter = {
 };
 /**
  * Capability of the agent
- * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+ * This is parsed from commitments like USE CALENDAR, USE PROJECT, KNOWLEDGE, etc.
  */
 export type AgentCapability = {
     /**
      * The type of the capability
      */
-    type: 'browser' | 'search-engine' | 'knowledge' | 'timeout' | 'time' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'email' | 'popup' | 'privacy' | 'project' | 'calendar' | 'wallet';
+    type: 'knowledge' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'popup' | 'privacy' | 'project' | 'calendar';
     /**
      * The label to display for this capability
      */
@@ -122,7 +122,7 @@ export type AgentBasicInformation = {
     parameters: Array<BookParameter>;
     /**
      * Capabilities of the agent
-     * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+     * This is parsed from commitments like USE CALENDAR, USE PROJECT, KNOWLEDGE, etc.
      */
     capabilities: Array<AgentCapability>;
     /**

package/umd/src/book-2.0/book-language-documentation/BookLanguageManualDictionary.d.ts CHANGED Viewed

@@ -86,9 +86,7 @@ export type BookLanguageManualDictionary = {
     readonly metadataLabels: {
         readonly bookLanguageVersion: string;
         readonly generatedAt: string;
-        readonly commitmentGroups: string;
-        readonly implementedCommitments: string;
-        readonly placeholderCommitments: string;
+        readonly commitmentCount: string;
     };
     /**
      * Heading of the table of contents.
@@ -128,7 +126,6 @@ export type BookLanguageManualDictionary = {
     readonly primitivesSections: {
         readonly coreSyntax: BookLanguageManualChapter;
         readonly references: BookLanguageManualChapter;
-        readonly keywordsTitle: string;
     };
     /**
      * Suffixes distinguishing a server-specific catalog from the portable one.
@@ -141,18 +138,7 @@ export type BookLanguageManualDictionary = {
      * Labels used in every commitment catalog entry.
      */
     readonly commitmentLabels: {
-        readonly status: string;
         readonly aliases: string;
-        readonly semantics: string;
-        readonly typeSchema: string;
-        readonly blockSchema: string;
-        readonly lowLevelNotice: string;
-        readonly usage: string;
-        readonly usageOccurrence: string;
-        readonly usageOccurrences: string;
-        readonly statusImplemented: string;
-        readonly statusPlaceholder: string;
-        readonly noAliases: string;
     };
     /**
      * Labels used by end-to-end example sections.

package/umd/src/book-2.0/book-language-documentation/getBookLanguageManualCommitmentGroups.d.ts CHANGED Viewed

@@ -16,7 +16,7 @@ export type BookLanguageManualCommitmentGroups = {
      */
     readonly documented: ReadonlyArray<BookLanguageManualCommitmentGroup>;
     /**
-     * Low-level and unfinished commitments documented in their own closing chapter.
+     * Low-level commitments documented in their own closing chapter.
      */
     readonly lowLevel: ReadonlyArray<BookLanguageManualCommitmentGroup>;
 };

package/umd/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.d.ts CHANGED Viewed

@@ -10,10 +10,6 @@ export type RenderCommitmentCatalogSectionOptions = {
      * Grouped commitment definition with aliases.
      */
     readonly groupedCommitment: BookLanguageManualCommitmentGroup;
-    /**
-     * Number of uses across the selected server agents.
-     */
-    readonly usageCount: number;
     /**
      * Translated labels of the manual.
      */