@promptbook/pdf 0.112.0-66 → 0.112.0-70

package/README.md

@@ -410,7 +410,7 @@ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**;
 
 #### How the workflow works
 
-1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.tmp`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
+1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.promptbook`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
 2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
 3. You replace placeholder `@@@` sections with real coding tasks.
 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
@@ -481,13 +481,13 @@ npx ptbk coder find-refactor-candidates --level xhigh
 npx ptbk coder verify
 ```
 
-`ptbk coder init` also bootstraps a starter `AGENTS.md`, adds `package.json` scripts for the four main coder commands, adds the coder temp ignore to `.gitignore`, and configures `.vscode/settings.json` so pasted images from `prompts/*.md` land in `prompts/screenshots/`.
+`ptbk coder init` also bootstraps a starter `AGENTS.md`, adds `package.json` scripts for the four main coder commands, adds the shared `/.promptbook` temp ignore to `.gitignore`, and configures `.vscode/settings.json` so pasted images from `prompts/*.md` land in `prompts/screenshots/`.
 
 #### What each command does
 
 | Command                               | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
-| `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 `/.tmp`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
+| `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 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. |

package/esm/index.es.js

@@ -1,8 +1,8 @@
 import { mkdir, rm, readFile } from 'fs/promises';
 import { spaceTrim as spaceTrim$1 } from 'spacetrim';
-import { posix, basename, join, dirname, isAbsolute } from 'path';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
+import { basename, join, dirname, isAbsolute } from 'path';
 import { randomBytes } from 'crypto';
 import { Subject } from 'rxjs';
 import { forTime } from 'waitasecond';
@@ -24,7 +24,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-66';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-70';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -976,27 +976,33 @@ function saturate(amount) {
 // TODO: Maybe implement by mix+hsl
 
 /**
- * Relative directory name without the `./` prefix for Git ignore rules and glob patterns.
+ * Stable root directory used for Promptbook-owned temporary files and caches.
  *
- * @private internal utility for Promptbook-owned temp files
+ * @private internal utility for Promptbook temporary folders
  */
-const PROMPTBOOK_TEMP_DIRECTORY_NAME = '.promptbook';
+const PROMPTBOOK_TEMPORARY_DIRECTORY = '.promptbook';
 /**
- * Builds one project-relative path inside the shared Promptbook working directory.
+ * Builds one normalized project-relative path inside Promptbook's dedicated temporary root.
  *
- * @private internal utility for Promptbook-owned temp files
+ * The returned path intentionally uses `/` separators so the same helper can be reused from
+ * Node.js and edge-safe code without depending on the Node `path` module.
+ *
+ * @private internal utility for Promptbook temporary folders
  */
-function getPromptbookTempPath(...pathSegments) {
-    return `./${getPromptbookTempPosixPath(...pathSegments)}`;
+function getPromptbookTemporaryPath(...pathSegments) {
+    const normalizedPathSegments = pathSegments.flatMap(splitPathSegments).filter(Boolean);
+    return [PROMPTBOOK_TEMPORARY_DIRECTORY, ...normalizedPathSegments].join('/');
 }
 /**
- * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
- *
- * @private internal utility for Promptbook-owned temp files
+ * Normalizes one raw path segment into slash-delimited pieces without empty items.
  */
-function getPromptbookTempPosixPath(...pathSegments) {
-    return posix.join(PROMPTBOOK_TEMP_DIRECTORY_NAME, ...pathSegments);
+function splitPathSegments(pathSegment) {
+    return pathSegment
+        .split(/[\\/]+/u)
+        .map((segment) => segment.trim())
+        .filter(Boolean);
 }
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Returns the same value that is passed as argument.
@@ -1180,7 +1186,7 @@ const DEFAULT_MAX_EXECUTION_ATTEMPTS = 7; // <- TODO: [🤹‍♂️]
  *
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_DOWNLOAD_CACHE_DIRNAME = getPromptbookTempPath('download-cache');
+const DEFAULT_DOWNLOAD_CACHE_DIRNAME = `./${getPromptbookTemporaryPath('download-cache')}`;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -1188,7 +1194,7 @@ const DEFAULT_DOWNLOAD_CACHE_DIRNAME = getPromptbookTempPath('download-cache');
  *
  * @public exported from `@promptbook/core`
  */
-getPromptbookTempPath('execution-cache');
+`./${getPromptbookTemporaryPath('execution-cache')}`;
 /**
  * Where to store the scrape cache
  *
@@ -1196,7 +1202,7 @@ getPromptbookTempPath('execution-cache');
  *
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_SCRAPE_CACHE_DIRNAME = getPromptbookTempPath('scrape-cache');
+const DEFAULT_SCRAPE_CACHE_DIRNAME = `./${getPromptbookTemporaryPath('scrape-cache')}`;
 // <- TODO: [🧜‍♂️]
 /**
  * Default settings for parsing and generating CSV files in Promptbook.
@@ -2075,11 +2081,11 @@ function capitalize(word) {
  */
 function pipelineJsonToString(pipelineJson) {
     const { title, pipelineUrl, bookVersion, description, parameters, tasks } = pipelineJson;
-    let pipelineString = `# ${title}`;
-    if (description) {
-        pipelineString += '\n\n';
-        pipelineString += description;
-    }
+    let pipelineString = spaceTrim$1((block) => `
+            # ${title}
+
+            ${block(description || '')}
+        `);
     const commands = [];
     if (pipelineUrl) {
         commands.push(`PIPELINE URL ${pipelineUrl}`);
@@ -2095,20 +2101,17 @@ function pipelineJsonToString(pipelineJson) {
     for (const parameter of parameters.filter(({ isOutput }) => isOutput)) {
         commands.push(`OUTPUT PARAMETER ${taskParameterJsonToString(parameter)}`);
     }
-    pipelineString += '\n\n';
-    pipelineString += commands.map((command) => `- ${command}`).join('\n');
+    pipelineString = spaceTrim$1((block) => `
+            ${block(pipelineString)}
+
+            ${block(commands.map((command) => `- ${command}`).join('\n'))}
+        `);
     for (const task of tasks) {
         const { 
         /* Note: Not using:> name, */
         title, description, 
         /* Note: dependentParameterNames, */
         jokerParameterNames: jokers, taskType, content, postprocessingFunctionNames: postprocessing, expectations, format, resultingParameterName, } = task;
-        pipelineString += '\n\n';
-        pipelineString += `## ${title}`;
-        if (description) {
-            pipelineString += '\n\n';
-            pipelineString += description;
-        }
         const commands = [];
         let contentLanguage = 'text';
         if (taskType === 'PROMPT_TASK') {
@@ -2171,18 +2174,23 @@ function pipelineJsonToString(pipelineJson) {
                 commands.push(`FORMAT JSON`);
             }
         } /* not else */
-        pipelineString += '\n\n';
-        pipelineString += commands.map((command) => `- ${command}`).join('\n');
-        pipelineString += '\n\n';
-        pipelineString += '```' + contentLanguage;
-        pipelineString += '\n';
-        pipelineString += spaceTrim$1(content);
-        //                   <- TODO: [main] !!3 Escape
-        //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
-        pipelineString += '\n';
-        pipelineString += '```';
-        pipelineString += '\n\n';
-        pipelineString += `\`-> {${resultingParameterName}}\``; // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
+        pipelineString = spaceTrim$1((block) => `
+                ${block(pipelineString)}
+
+                ## ${title}
+
+                ${block(description || '')}
+
+                ${block(commands.map((command) => `- ${command}`).join('\n'))}
+
+                \`\`\`${contentLanguage}
+                ${block(spaceTrim$1(content))}
+                \`\`\`
+
+                \`-> {${resultingParameterName}}\`
+            `); // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
+        // <- TODO: [main] !!3 Escape
+        // <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
     }
     return validatePipelineString(pipelineString);
 }