@promptbook/utils 0.112.0-66 → 0.112.0-69

package/README.md

@@ -711,7 +711,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.
@@ -782,13 +782,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,5 +1,5 @@
 import { spaceTrim as spaceTrim$1 } from 'spacetrim';
-import { posix, basename } from 'path';
+import { basename } from 'path';
 import { randomBytes } from 'crypto';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
@@ -18,7 +18,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-69';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -938,27 +938,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
 
 /**
  * Name for the Promptbook
@@ -1062,7 +1068,7 @@ const SMALL_NUMBER = 0.001;
  *
  * @public exported from `@promptbook/core`
  */
-getPromptbookTempPath('download-cache');
+`./${getPromptbookTemporaryPath('download-cache')}`;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -1070,7 +1076,7 @@ getPromptbookTempPath('download-cache');
  *
  * @public exported from `@promptbook/core`
  */
-getPromptbookTempPath('execution-cache');
+`./${getPromptbookTemporaryPath('execution-cache')}`;
 /**
  * Where to store the scrape cache
  *
@@ -1078,7 +1084,7 @@ getPromptbookTempPath('execution-cache');
  *
  * @public exported from `@promptbook/core`
  */
-getPromptbookTempPath('scrape-cache');
+`./${getPromptbookTemporaryPath('scrape-cache')}`;
 // <- TODO: [🧜‍♂️]
 /**
  * Default settings for parsing and generating CSV files in Promptbook.