@promptbook/cli 0.113.0-5 → 0.113.0-8

package/src/utils/ascii-art/convertImageDataToAsciiArt.ts

@@ -385,10 +385,7 @@ function mapColorToAnsi256(color: HalfCellColor): number {
         if (gray > ANSI_256_NEAR_WHITE_GRAY_LEVEL) {
             return ANSI_256_WHITE_INDEX; // <- Note: Pure white lives in the color cube
         }
-        return (
-            232 +
-            Math.round(((gray - 8) / ANSI_256_GRAYSCALE_RAMP_MAX_LEVEL) * ANSI_256_GRAYSCALE_RAMP_INDEX_SPAN)
-        );
+        return 232 + Math.round(((gray - 8) / ANSI_256_GRAYSCALE_RAMP_MAX_LEVEL) * ANSI_256_GRAYSCALE_RAMP_INDEX_SPAN);
     }
 
     const redIndex = Math.round((red / 255) * 5);

package/src/version.ts

@@ -16,11 +16,11 @@ export const BOOK_LANGUAGE_VERSION: string_semantic_version = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.113.0-5';
+export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.113.0-8';
 
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.113.0-4`).
+ * It follows semantic versioning (e.g., `0.113.0-5`).
  *
  * @generated
  */

package/src/versions.txt

@@ -1171,3 +1171,4 @@
 0.113.0-3
 0.113.0-4
 0.113.0-5
+0.113.0-8

package/umd/index.umd.js

@@ -63,7 +63,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.113.0-5';
+    const PROMPTBOOK_ENGINE_VERSION = '0.113.0-8';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -14668,7 +14668,7 @@
         isAnimated: true,
         supportsPointerTracking: true,
         render({ context, size, palette, createRandom, timeMs, interaction }) {
-            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset, tentacleProfiles, skinSpots } = getOctopus3d4StableState(createRandom);
+            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset, tentacleProfiles, skinSpots, } = getOctopus3d4StableState(createRandom);
             const sceneCenterX = size * 0.5;
             const sceneCenterY = size * 0.535;
             const bob = Math.sin(timeMs / 980 + animationPhase) * size * 0.013;
@@ -15016,10 +15016,7 @@
             Math.max(0, Math.cos(effectiveLongitude)) * 0.12 +
             lowerBlend * tentacleInfluence.core * (0.12 + tentacleInfluence.depthScale * 0.07) -
             Math.max(0, -Math.cos(effectiveLongitude)) * 0.05;
-        const tentacleTubeRadius = lowerBlend *
-            tentacleInfluence.core *
-            (0.12 + tipBlend * 0.07 + tentacleInfluence.widthScale * 0.028) *
-            radiusX;
+        const tentacleTubeRadius = lowerBlend * tentacleInfluence.core * (0.12 + tipBlend * 0.07 + tentacleInfluence.widthScale * 0.028) * radiusX;
         const planarRadiusX = cosineLatitude * radiusX * horizontalScale + tentacleTubeRadius;
         const planarRadiusZ = cosineLatitude * radiusZ * depthScale + tentacleTubeRadius * 0.74;
         const lowerDrop = lowerBlend *
@@ -15031,9 +15028,7 @@
                         (morphologyProfile.tentacles.flowLengthScale - 1) * 0.1));
         const combinedTentacleSway = (primaryTentacleWave + secondaryTentacleWave) * radiusX * (0.06 + tipBlend * 0.06);
         return {
-            x: Math.sin(effectiveLongitude) * planarRadiusX +
-                combinedTentacleSway +
-                tentacleCurl * radiusX * 0.18,
+            x: Math.sin(effectiveLongitude) * planarRadiusX + combinedTentacleSway + tentacleCurl * radiusX * 0.18,
             y: Math.sin(latitude) * radiusY * (1 + upperBlend * 0.14) -
                 upperBlend * radiusY * 0.12 +
                 lowerDrop +
@@ -18292,10 +18287,10 @@
      *
      * @private
      */
-    const TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES = [
-        '-   If a teammate is relevant to the request, consult that teammate using the matching tool.',
-        '-   Do not ask the user for information that a listed teammate can provide directly.',
-    ];
+    const TEAM_SYSTEM_MESSAGE_GUIDANCE = _spaceTrim.spaceTrim(`
+    -   If a teammate is relevant to the request, consult that teammate using the matching tool.
+    -   Do not ask the user for information that a listed teammate can provide directly.
+`);
     /**
      * Constant for remote agents by Url.
      */
@@ -18477,7 +18472,7 @@
             `);
         });
         return _spaceTrim.spaceTrim((block) => `
-            ${block(TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES.join('\n'))}
+            ${block(TEAM_SYSTEM_MESSAGE_GUIDANCE)}
 
             ${block(teammateSections.join('\n\n'))}
         `);
@@ -40295,6 +40290,30 @@
     }
     // Note: [🟡] Code for repository script [RefactorCandidateLevel](scripts/find-refactor-candidates/RefactorCandidateLevel.ts) should never be published outside of `@promptbook/cli`
 
+    /**
+     * Creates a Commander argument parser that accepts only positive integers.
+     *
+     * The returned parser is meant to be passed as the coercion callback of `command.option(...)`.
+     * It throws a branded `NotAllowed` error with a clear message referencing the given option name
+     * when the provided value is not a positive integer.
+     *
+     * @private internal utility of `promptbookCli`
+     */
+    function createPositiveIntegerOptionParser(optionName) {
+        return (value) => {
+            const parsedValue = Number(value);
+            if (!Number.isInteger(parsedValue) || parsedValue <= 0) {
+                throw new NotAllowed(_spaceTrim.spaceTrim(`
+                    Invalid value for \`${optionName}\`: \`${value}\`.
+
+                    Use a positive integer.
+                `));
+            }
+            return parsedValue;
+        };
+    }
+    // Note: [🟡] Code for CLI option parser [createPositiveIntegerOptionParser](src/cli/cli-commands/common/createPositiveIntegerOptionParser.ts) should never be published outside of `@promptbook/cli`
+
     /**
      * Initializes `coder find-refactor-candidates` command for Promptbook CLI utilities
      *
@@ -40315,12 +40334,13 @@
         command.addOption(new commander.Option('--level <level>', `Set scan aggressiveness (${REFACTOR_CANDIDATE_LEVEL_VALUES.join(', ')})`)
             .choices([...REFACTOR_CANDIDATE_LEVEL_VALUES])
             .default(DEFAULT_REFACTOR_CANDIDATE_LEVEL));
+        command.option('--limit <candidate-count>', 'Create at most this many refactor prompts, keeping the most important candidates', createPositiveIntegerOptionParser('--limit'));
         command.action(handleActionErrors(async (cliOptions) => {
-            const { level = DEFAULT_REFACTOR_CANDIDATE_LEVEL } = cliOptions;
+            const { level = DEFAULT_REFACTOR_CANDIDATE_LEVEL, limit } = cliOptions;
             // Note: Import the function dynamically to avoid loading heavy dependencies until needed
             const { findRefactorCandidates } = await Promise.resolve().then(function () { return findRefactorCandidates$1; });
             try {
-                await findRefactorCandidates({ level });
+                await findRefactorCandidates({ level, limit });
             }
             catch (error) {
                 assertsError(error);
@@ -40404,26 +40424,26 @@
             id: 'common',
             relativeFilePath: path.join(PROMPTS_TEMPLATES_DIRECTORY_PATH, 'common.md'),
             slugPrefix: null,
-            content: buildCoderPromptTemplateContent([
-                '-   @@@',
-                "-   Keep in mind the DRY _(don't repeat yourself)_ principle.",
-                '-   Do a proper analysis of the current functionality before you start implementing.',
-                '-   Add the changes into the [changelog](changelog/_current-preversion.md)',
-            ]),
+            content: _spaceTrim.spaceTrim(`
+            -   @@@
+            -   Keep in mind the DRY _(don't repeat yourself)_ principle.
+            -   Do a proper analysis of the current functionality before you start implementing.
+            -   Add the changes into the [changelog](changelog/_current-preversion.md)
+        `),
             isDefaultProjectTemplate: true,
         },
         {
             id: 'agents-server',
             relativeFilePath: path.join(PROMPTS_TEMPLATES_DIRECTORY_PATH, 'agents-server.md'),
             slugPrefix: 'agents-server',
-            content: buildCoderPromptTemplateContent([
-                '-   @@@',
-                "-   Keep in mind the DRY _(don't repeat yourself)_ principle.",
-                '-   Do a proper analysis of the current functionality before you start implementing.',
-                '-   You are working with the [Agents Server](apps/agents-server)',
-                '-   If you need to do the database migration, do it',
-                '-   Add the changes into the [changelog](changelog/_current-preversion.md)',
-            ]),
+            content: _spaceTrim.spaceTrim(`
+            -   @@@
+            -   Keep in mind the DRY _(don't repeat yourself)_ principle.
+            -   Do a proper analysis of the current functionality before you start implementing.
+            -   You are working with the [Agents Server](apps/agents-server)
+            -   If you need to do the database migration, do it
+            -   Add the changes into the [changelog](changelog/_current-preversion.md)
+        `),
             isDefaultProjectTemplate: false,
         },
     ];
@@ -40543,12 +40563,6 @@
     function getDefaultCoderPromptTemplateDefinitionOrUndefined(template) {
         return DEFAULT_CODER_PROMPT_TEMPLATE_DEFINITIONS.find((definition) => definition.id === template);
     }
-    /**
-     * Builds stable markdown content for one coder prompt template without indentation drift.
-     */
-    function buildCoderPromptTemplateContent(lines) {
-        return lines.join('\n');
-    }
     /**
      * Creates a fully resolved template payload from one built-in definition.
      */
@@ -41475,7 +41489,7 @@
         command.option('--preserve-logs', 'Keep generated temp prompt/log artifacts after successful rounds for debugging and analytics', false);
         addPromptRunnerExecutionOptions(command);
         command.option('--priority <minimum-priority>', 'Filter prompts by minimum priority level', parseIntOption$1, 0);
-        command.option('--limit <run-count>', 'Stop after processing this many prompt runs', parsePositiveIntegerOption);
+        command.option('--limit <run-count>', 'Stop after processing this many prompt runs', createPositiveIntegerOptionParser('--limit'));
         command.option('--wait-after-prompt <duration>', _spaceTrim.spaceTrim(`
             Wait this long after each prompt has been implemented, verified and committed before starting the next prompt.
             Accepts durations like 1h, 30m, 5s. Defaults to 0 (no wait).
@@ -41562,22 +41576,6 @@
         }
         return parsed;
     }
-    /**
-     * Parses a positive integer option value.
-     *
-     * @private internal utility of `coder run` command
-     */
-    function parsePositiveIntegerOption(value) {
-        const parsed = Number(value);
-        if (!Number.isInteger(parsed) || parsed <= 0) {
-            throw new NotAllowed(_spaceTrim.spaceTrim(`
-                Invalid value for \`--limit\`: \`${value}\`.
-
-                Use a positive integer.
-            `));
-        }
-        return parsed;
-    }
     /**
      * Joins one Commander option that may be parsed either as a single string or a variadic token array.
      *
@@ -69850,23 +69848,28 @@
         const extension = path.extname(filePath).toLowerCase();
         const relativePath = normalizeRefactorCandidatePath(path.relative(rootDir, filePath));
         const reasons = [];
+        let severityScore = 0;
         if (!lineCountExemptPaths.has(normalizedAbsolutePath)) {
             const lineCount = countLines(content);
             const maxLines = getMaxLinesForExtension(extension, heuristics);
             if (lineCount > maxLines) {
                 reasons.push(`lines ${lineCount}/${maxLines}`);
+                severityScore += lineCount / maxLines;
             }
         }
         if (STRUCTURAL_ANALYSIS_EXTENSIONS.includes(extension)) {
             const structureSummary = summarizeSourceFileStructure(content, extension, filePath);
             if (structureSummary.entityCount > heuristics.maxEntityCountPerFile) {
                 reasons.push(`entities ${structureSummary.entityCount}/${heuristics.maxEntityCountPerFile}`);
+                severityScore += structureSummary.entityCount / heuristics.maxEntityCountPerFile;
             }
             if (structureSummary.functionCount > heuristics.maxFunctionCountPerFile) {
                 reasons.push(`functions ${structureSummary.functionCount}/${heuristics.maxFunctionCountPerFile}`);
+                severityScore += structureSummary.functionCount / heuristics.maxFunctionCountPerFile;
             }
             if (structureSummary.maxFunctionComplexity > heuristics.maxFunctionComplexity) {
                 reasons.push(buildComplexityReason(structureSummary, heuristics.maxFunctionComplexity));
+                severityScore += structureSummary.maxFunctionComplexity / heuristics.maxFunctionComplexity;
             }
         }
         if (reasons.length === 0) {
@@ -69876,6 +69879,7 @@
             absolutePath: filePath,
             relativePath,
             reasons,
+            severityScore,
         };
     }
     /**
@@ -70335,6 +70339,37 @@
     }
     // Note: [🟡] Code for repository script [resolveRefactorCandidateProject](scripts/find-refactor-candidates/resolveRefactorCandidateProject.ts) should never be published outside of `@promptbook/cli`
 
+    /**
+     * Keeps at most `limit` refactor candidates, preferring the most important ones.
+     *
+     * When there are more candidates than `limit`, only the highest-severity candidates are kept
+     * (ties broken by relative path for determinism). When `limit` is `undefined` or there are fewer
+     * candidates than the limit, every candidate is returned. The original input order is preserved
+     * among the kept candidates, so `limit` acts purely as a filter and never reorders prompts.
+     *
+     * @private function of findRefactorCandidates
+     */
+    function selectMostImportantRefactorCandidates(candidates, limit) {
+        if (limit === undefined || candidates.length <= limit) {
+            return candidates;
+        }
+        const candidatesRankedByImportance = [...candidates].sort(compareRefactorCandidatesByImportance);
+        const keptRelativePaths = new Set(candidatesRankedByImportance.slice(0, limit).map((candidate) => candidate.relativePath));
+        return candidates.filter((candidate) => keptRelativePaths.has(candidate.relativePath));
+    }
+    /**
+     * Orders refactor candidates from most to least important.
+     *
+     * @private function of selectMostImportantRefactorCandidates
+     */
+    function compareRefactorCandidatesByImportance(candidateA, candidateB) {
+        if (candidateB.severityScore !== candidateA.severityScore) {
+            return candidateB.severityScore - candidateA.severityScore;
+        }
+        return candidateA.relativePath.localeCompare(candidateB.relativePath);
+    }
+    // Note: [🟡] Code for repository script [selectMostImportantRefactorCandidates](scripts/find-refactor-candidates/selectMostImportantRefactorCandidates.ts) should never be published outside of `@promptbook/cli`
+
     /**
      * Calculates the next available prompt numbering sequence for a month.
      */
@@ -70658,7 +70693,7 @@
      * @public exported from `@promptbook/cli`
      */
     async function findRefactorCandidates(options = {}) {
-        const { level = DEFAULT_REFACTOR_CANDIDATE_LEVEL } = options;
+        const { level = DEFAULT_REFACTOR_CANDIDATE_LEVEL, limit } = options;
         const heuristics = getRefactorCandidateLevelConfiguration(level);
         initializeFindRefactorCandidatesRun();
         console.info(colors__default["default"].cyan('⚡🏭 Find refactor candidates'));
@@ -70682,8 +70717,10 @@
             console.info(colors__default["default"].green('All candidates already have prompts.'));
             return;
         }
+        const selectedCandidatesToWrite = selectMostImportantRefactorCandidates(candidatesToWrite, limit);
+        const skippedByLimit = candidatesToWrite.length - selectedCandidatesToWrite.length;
         const createdPrompts = await writeRefactorCandidatePrompts({
-            candidates: candidatesToWrite,
+            candidates: selectedCandidatesToWrite,
             rootDir,
             promptsDir,
         });
@@ -70691,6 +70728,9 @@
         if (alreadyTracked > 0) {
             console.info(colors__default["default"].gray(`Skipped ${alreadyTracked} candidate(s) with existing prompts.`));
         }
+        if (skippedByLimit > 0) {
+            console.info(colors__default["default"].gray(`Skipped ${skippedByLimit} lower-priority candidate(s) because of \`--limit ${limit}\`.`));
+        }
     }
     /**
      * Prints discovered refactor candidates with their reasons.
@@ -71942,8 +71982,7 @@
             if (gray > ANSI_256_NEAR_WHITE_GRAY_LEVEL) {
                 return ANSI_256_WHITE_INDEX; // <- Note: Pure white lives in the color cube
             }
-            return (232 +
-                Math.round(((gray - 8) / ANSI_256_GRAYSCALE_RAMP_MAX_LEVEL) * ANSI_256_GRAYSCALE_RAMP_INDEX_SPAN));
+            return 232 + Math.round(((gray - 8) / ANSI_256_GRAYSCALE_RAMP_MAX_LEVEL) * ANSI_256_GRAYSCALE_RAMP_INDEX_SPAN);
         }
         const redIndex = Math.round((red / 255) * 5);
         const greenIndex = Math.round((green / 255) * 5);