@promptbook/cli 0.113.0-4 → 0.113.0-6

package/esm/scripts/run-codex-prompts/common/resolveCoderAgent.d.ts

@@ -0,0 +1,20 @@
+import type { string_book } from '../../../src/book-2.0/agent-source/string_book';
+/**
+ * Agent data resolved from the optional `--agent` book file.
+ */
+export type ResolvedCoderAgent = {
+    /**
+     * Raw source of the agent `.book` file.
+     */
+    readonly agentSource: string_book;
+    /**
+     * Compiled system message injected into each coding prompt.
+     */
+    readonly systemMessage: string;
+};
+/**
+ * Reads an optional agent `.book` file and compiles its system message for injection into coder prompts.
+ *
+ * Returns `undefined` when no agent path is provided.
+ */
+export declare function resolveCoderAgent(agentPath: string | undefined, currentWorkingDirectory: string): Promise<ResolvedCoderAgent | undefined>;

package/esm/scripts/run-codex-prompts/ui/CoderRunUiState.d.ts

@@ -41,6 +41,7 @@ export type { CoderRunProgressSnapshot };
  */
 export declare class CoderRunUiState extends EventEmitter {
     config: CoderRunConfig;
+    agentVisualLines: string[] | undefined;
     currentPromptLabel: string;
     currentScriptPaths: string[];
     currentAttempt: number;
@@ -72,6 +73,10 @@ export declare class CoderRunUiState extends EventEmitter {
      * Replaces the configuration shown in the UI header.
      */
     setConfig(config: CoderRunConfig): void;
+    /**
+     * Replaces the ASCII-art agent visual shown instead of the default brand banner.
+     */
+    setAgentVisualLines(agentVisualLines: ReadonlyArray<string> | undefined): void;
     /**
      * Feeds new prompt statistics from the main loop so the progress bar updates.
      */

package/esm/scripts/run-codex-prompts/ui/buildCoderRunAgentVisual.d.ts

@@ -0,0 +1,29 @@
+import type { string_book } from '../../../src/book-2.0/agent-source/string_book';
+/**
+ * Output width of the coder-run agent visual in terminal character cells.
+ *
+ * @private internal constant of coder run UI
+ */
+export declare const CODER_RUN_AGENT_VISUAL_COLUMNS = 24;
+/**
+ * Output height of the coder-run agent visual in terminal character cells.
+ *
+ * Half of the columns keeps the square avatar visually square in a common terminal font.
+ *
+ * @private internal constant of coder run UI
+ */
+export declare const CODER_RUN_AGENT_VISUAL_ROWS = 12;
+/**
+ * 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 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.
+ *
+ * @param agentSource Source of the `--agent` book file.
+ * @returns ANSI-colored ASCII-art lines or `null` when the visual cannot be rendered.
+ */
+export declare function buildCoderRunAgentVisual(agentSource: string_book): Promise<ReadonlyArray<string> | null>;

package/esm/scripts/run-codex-prompts/ui/buildCoderRunUiFrame.d.ts

@@ -11,6 +11,10 @@ export type BuildCoderRunUiFrameOptions = {
     readonly terminalWidth: number;
     readonly animationFrame: number;
     readonly spinner: string;
+    /**
+     * ANSI ASCII-art lines of the `--agent` avatar visual shown instead of the default brand banner.
+     */
+    readonly agentVisualLines?: readonly string[];
     readonly pauseState: CoderRunPauseState;
     readonly pauseTargetLabel: string;
     readonly config: CoderRunConfig;

package/esm/src/avatars/renderAvatarVisualAsciiArt.d.ts

@@ -0,0 +1,75 @@
+import type { AsciiArtColorDepth } from '../utils/ascii-art/convertImageDataToAsciiArt';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarVisualId } from './types/AvatarVisualDefinition';
+/**
+ * Default output width of the ASCII avatar in terminal character cells.
+ *
+ * @private within the repository
+ */
+export declare const DEFAULT_AVATAR_ASCII_ART_COLUMNS = 32;
+/**
+ * Factory creating a drawable canvas of the requested pixel size.
+ *
+ * In browsers this is typically `document.createElement('canvas')` (with width/height set),
+ * in Node.js an adapter around `createCanvas` of `@napi-rs/canvas` or a compatible library.
+ *
+ * @private within the repository
+ */
+export type CreateCanvasForAsciiArt = (width: number, height: number) => HTMLCanvasElement;
+/**
+ * Options for `renderAvatarVisualAsciiArt`.
+ *
+ * @private within the repository
+ */
+export type RenderAvatarVisualAsciiArtOptions = {
+    /**
+     * 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;
+    /**
+     * Output width in terminal character cells.
+     *
+     * @default `DEFAULT_AVATAR_ASCII_ART_COLUMNS`
+     */
+    readonly columns?: number;
+    /**
+     * Output height in terminal character cells.
+     *
+     * @default `columns / 2` so the square avatar stays visually square in a common terminal font
+     */
+    readonly rows?: number;
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     *
+     * @default 'TRUE_COLOR'
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+    /**
+     * Animation timestamp for animated visuals.
+     *
+     * @default `STATIC_AVATAR_ASCII_ART_FRAME_TIME_MS`
+     */
+    readonly timeMs?: number;
+    /**
+     * Platform-specific canvas factory used to rasterize the visual.
+     */
+    readonly createCanvas: CreateCanvasForAsciiArt;
+};
+/**
+ * Renders one built-in avatar visual into ANSI-colored ASCII art for terminal display.
+ *
+ * This is the universal bridge between the canvas avatar visuals shown on the website and
+ * text-based terminal UIs: the visual is rasterized through the exact same `renderAvatarVisual`
+ * pipeline the web uses, then the resulting pixels are converted into colored half-block
+ * characters by `convertImageDataToAsciiArt`.
+ *
+ * @param options Avatar identity, visual selection, output grid size, and the platform canvas factory.
+ * @returns One ANSI-colored string per output row.
+ *
+ * @private within the repository
+ */
+export declare function renderAvatarVisualAsciiArt(options: RenderAvatarVisualAsciiArtOptions): ReadonlyArray<string>;

package/esm/src/utils/ascii-art/$detectTerminalAnsiColorDepth.d.ts

@@ -0,0 +1,15 @@
+import type { AsciiArtColorDepth } from './convertImageDataToAsciiArt';
+/**
+ * Detects the ANSI color depth supported by the current terminal.
+ *
+ * Prefers 24-bit true color when the environment advertises it (modern terminals such as
+ * Windows Terminal, ConEmu, VS Code, mintty, iTerm2, and WezTerm) and falls back to the
+ * portable 256-color palette otherwise.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it reads the process environment
+ *
+ * @returns Color depth usable by `convertImageDataToAsciiArt`
+ *
+ * @private within the repository
+ */
+export declare function $detectTerminalAnsiColorDepth(): AsciiArtColorDepth;

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

@@ -0,0 +1,80 @@
+/**
+ * Color depth of the ANSI escape codes emitted by the ASCII-art conversion.
+ *
+ * - `TRUE_COLOR` emits 24-bit `38;2;r;g;b` / `48;2;r;g;b` sequences
+ * - `ANSI_256` approximates colors on the 256-color ANSI cube for older terminals
+ *
+ * @private within the repository
+ */
+export type AsciiArtColorDepth = 'TRUE_COLOR' | 'ANSI_256';
+/**
+ * Minimal structural subset of the DOM `ImageData` accepted by the ASCII-art conversion.
+ *
+ * Works with browser canvas `ImageData`, `@napi-rs/canvas` image data, or any raw RGBA buffer.
+ *
+ * @private within the repository
+ */
+export type AsciiArtImageData = {
+    /**
+     * Source image width in pixels.
+     */
+    readonly width: number;
+    /**
+     * Source image height in pixels.
+     */
+    readonly height: number;
+    /**
+     * Flat RGBA pixel buffer with 4 bytes per pixel.
+     */
+    readonly data: ArrayLike<number>;
+};
+/**
+ * Options for `convertImageDataToAsciiArt`.
+ *
+ * @private within the repository
+ */
+export type ConvertImageDataToAsciiArtOptions = {
+    /**
+     * Source pixels to convert.
+     */
+    readonly imageData: AsciiArtImageData;
+    /**
+     * Output width in terminal character cells.
+     */
+    readonly columns: number;
+    /**
+     * Output height in terminal character cells.
+     *
+     * Each character cell renders two vertically stacked pixels, so `rows = columns / 2`
+     * keeps a square image visually square in a common terminal font.
+     */
+    readonly rows: number;
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     *
+     * @default 'TRUE_COLOR'
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+    /**
+     * Alpha channel value (0-255) below which an averaged half-cell is treated as fully transparent.
+     *
+     * @default 32
+     */
+    readonly alphaThreshold?: number;
+};
+/**
+ * Converts raw RGBA image pixels into colored ASCII art for ANSI terminals.
+ *
+ * This is the universal image-to-terminal technique used across the repository:
+ * every output character cell covers a rectangular region of source pixels which is
+ * split into a top and bottom half; each half is area-averaged and rendered with
+ * half-block characters (`▀` / `▄`) so one character shows two "pixels" vertically.
+ * Transparent halves keep the terminal background so non-rectangular images
+ * (for example rounded avatar cards) compose naturally into any terminal UI.
+ *
+ * @param options Source pixels, output grid size, and ANSI color depth.
+ * @returns One ANSI-colored string per output row, each ending with a color reset.
+ *
+ * @private within the repository
+ */
+export declare function convertImageDataToAsciiArt(options: ConvertImageDataToAsciiArtOptions): ReadonlyArray<string>;

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.113.0-3`).
+ * It follows semantic versioning (e.g., `0.113.0-5`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.113.0-4",
+    "version": "0.113.0-6",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/src/avatars/avatarAnimationScheduler.ts

@@ -133,7 +133,8 @@ function ensureAvatarAnimationLoop(): void {
         // Run the most stale listeners first so each avatar keeps its target FPS even when
         // total work exceeds the per-frame budget.
         dueListenerEntries.sort(
-            (firstListenerEntry, secondListenerEntry) => firstListenerEntry.lastRunAtMs - secondListenerEntry.lastRunAtMs,
+            (firstListenerEntry, secondListenerEntry) =>
+                firstListenerEntry.lastRunAtMs - secondListenerEntry.lastRunAtMs,
         );
 
         const listenersToRunCount = Math.min(dueListenerEntries.length, MAX_AVATAR_LISTENERS_PER_FRAME);

package/src/avatars/renderAvatarVisualAsciiArt.ts

@@ -0,0 +1,138 @@
+import { spaceTrim } from 'spacetrim';
+import { EnvironmentMismatchError } from '../errors/EnvironmentMismatchError';
+import type { AsciiArtColorDepth } from '../utils/ascii-art/convertImageDataToAsciiArt';
+import { convertImageDataToAsciiArt } from '../utils/ascii-art/convertImageDataToAsciiArt';
+import { DEFAULT_AVATAR_SIZE } from './avatarRenderingUtils';
+import { renderAvatarVisual } from './renderAvatarVisual';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarVisualId } from './types/AvatarVisualDefinition';
+
+/**
+ * Default output width of the ASCII avatar in terminal character cells.
+ *
+ * @private within the repository
+ */
+export const DEFAULT_AVATAR_ASCII_ART_COLUMNS = 32;
+
+/**
+ * Stable animation timestamp used when rasterizing animated avatar visuals into a static ASCII frame.
+ *
+ * @private within the repository
+ */
+const STATIC_AVATAR_ASCII_ART_FRAME_TIME_MS = 840;
+
+/**
+ * Factory creating a drawable canvas of the requested pixel size.
+ *
+ * In browsers this is typically `document.createElement('canvas')` (with width/height set),
+ * in Node.js an adapter around `createCanvas` of `@napi-rs/canvas` or a compatible library.
+ *
+ * @private within the repository
+ */
+export type CreateCanvasForAsciiArt = (width: number, height: number) => HTMLCanvasElement;
+
+/**
+ * Options for `renderAvatarVisualAsciiArt`.
+ *
+ * @private within the repository
+ */
+export type RenderAvatarVisualAsciiArtOptions = {
+    /**
+     * 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;
+
+    /**
+     * Output width in terminal character cells.
+     *
+     * @default `DEFAULT_AVATAR_ASCII_ART_COLUMNS`
+     */
+    readonly columns?: number;
+
+    /**
+     * Output height in terminal character cells.
+     *
+     * @default `columns / 2` so the square avatar stays visually square in a common terminal font
+     */
+    readonly rows?: number;
+
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     *
+     * @default 'TRUE_COLOR'
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+
+    /**
+     * Animation timestamp for animated visuals.
+     *
+     * @default `STATIC_AVATAR_ASCII_ART_FRAME_TIME_MS`
+     */
+    readonly timeMs?: number;
+
+    /**
+     * Platform-specific canvas factory used to rasterize the visual.
+     */
+    readonly createCanvas: CreateCanvasForAsciiArt;
+};
+
+/**
+ * Renders one built-in avatar visual into ANSI-colored ASCII art for terminal display.
+ *
+ * This is the universal bridge between the canvas avatar visuals shown on the website and
+ * text-based terminal UIs: the visual is rasterized through the exact same `renderAvatarVisual`
+ * pipeline the web uses, then the resulting pixels are converted into colored half-block
+ * characters by `convertImageDataToAsciiArt`.
+ *
+ * @param options Avatar identity, visual selection, output grid size, and the platform canvas factory.
+ * @returns One ANSI-colored string per output row.
+ *
+ * @private within the repository
+ */
+export function renderAvatarVisualAsciiArt(options: RenderAvatarVisualAsciiArtOptions): ReadonlyArray<string> {
+    const columns = options.columns ?? DEFAULT_AVATAR_ASCII_ART_COLUMNS;
+    const rows = options.rows ?? Math.round(columns / 2);
+
+    const canvas = options.createCanvas(DEFAULT_AVATAR_SIZE, DEFAULT_AVATAR_SIZE);
+
+    if (!canvas.style) {
+        // Note: `renderAvatarVisual` expects a browser canvas shape; Node.js canvases only need this tiny compatibility shim.
+        (canvas as { style: HTMLCanvasElement['style'] }).style = {} as HTMLCanvasElement['style'];
+    }
+
+    renderAvatarVisual({
+        canvas,
+        avatarDefinition: options.avatarDefinition,
+        visualId: options.visualId,
+        size: DEFAULT_AVATAR_SIZE,
+        timeMs: options.timeMs ?? STATIC_AVATAR_ASCII_ART_FRAME_TIME_MS,
+        devicePixelRatio: 1,
+    });
+
+    const context = canvas.getContext('2d');
+
+    if (!context) {
+        throw new EnvironmentMismatchError(
+            spaceTrim(`
+                2D canvas rendering context is unavailable while converting the avatar visual to ASCII art.
+
+                Provide a \`createCanvas\` factory whose canvases support \`getContext('2d')\`,
+                for example \`createCanvas\` of \`@napi-rs/canvas\` in Node.js.
+            `),
+        );
+    }
+
+    const imageData = context.getImageData(0, 0, DEFAULT_AVATAR_SIZE, DEFAULT_AVATAR_SIZE);
+
+    return convertImageDataToAsciiArt({
+        imageData,
+        columns,
+        rows,
+        colorDepth: options.colorDepth,
+    });
+}

package/src/avatars/visuals/octopus3d3AvatarVisual.ts

@@ -502,12 +502,16 @@ function resolveVisibleContinuousOctopusPatches(
     }
 
     for (let longitudeIndex = 0; longitudeIndex < longitudePatchCount; longitudeIndex++) {
-        const patchCenterLongitude = (longitudeBoundaries[longitudeIndex]! + longitudeBoundaries[longitudeIndex + 1]!) / 2;
+        const patchCenterLongitude =
+            (longitudeBoundaries[longitudeIndex]! + longitudeBoundaries[longitudeIndex + 1]!) / 2;
         cachedTentacleInfluencesByPatchCenterLongitude[longitudeIndex] = resolveContinuousTentacleInfluence(
             options,
             patchCenterLongitude,
         );
-        cachedLobeWavesByPatchCenterLongitude[longitudeIndex] = resolveContinuousLobeWave(options, patchCenterLongitude);
+        cachedLobeWavesByPatchCenterLongitude[longitudeIndex] = resolveContinuousLobeWave(
+            options,
+            patchCenterLongitude,
+        );
         cachedCosByPatchCenterLongitude[longitudeIndex] = Math.max(0, Math.cos(patchCenterLongitude));
     }
 

package/src/avatars/visuals/octopus3d4AvatarVisual.ts

@@ -193,8 +193,14 @@ export const octopus3d4AvatarVisual: AvatarVisualDefinition = {
     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;
@@ -568,7 +574,8 @@ function resolveVisibleBlobbyContinuousPatches(
     }
 
     for (let longitudeIndex = 0; longitudeIndex < longitudePatchCount; longitudeIndex++) {
-        const patchCenterLongitude = (longitudeBoundaries[longitudeIndex]! + longitudeBoundaries[longitudeIndex + 1]!) / 2;
+        const patchCenterLongitude =
+            (longitudeBoundaries[longitudeIndex]! + longitudeBoundaries[longitudeIndex + 1]!) / 2;
         cachedTentacleInfluencesByPatchCenterLongitude[longitudeIndex] = resolveBlobbyTentacleInfluence(
             options,
             patchCenterLongitude,
@@ -702,8 +709,7 @@ function sampleBlobbyContinuousSurfacePointWithLongitudeCache(
     const lowerBlend = smoothStep(0.34, 1, verticalProgress);
     const tipBlend = smoothStep(0.66, 1, verticalProgress);
     const centerPull = resolveSignedAngularDistance(longitude, tentacleInfluence.centerLongitude);
-    const effectiveLongitude =
-        longitude + centerPull * lowerBlend * tentacleInfluence.core * (0.26 + tipBlend * 0.22);
+    const effectiveLongitude = longitude + centerPull * lowerBlend * tentacleInfluence.core * (0.26 + tipBlend * 0.22);
     const mantleRipple =
         Math.sin(
             longitude * morphologyProfile.body.lobeCount +
@@ -742,10 +748,7 @@ function sampleBlobbyContinuousSurfacePointWithLongitudeCache(
         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;
+        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 =
@@ -759,10 +762,7 @@ function sampleBlobbyContinuousSurfacePointWithLongitudeCache(
     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 +
@@ -911,11 +911,7 @@ function drawBlobbyContinuousSurfacePatch(
     drawProjectedQuad(context, surfacePatch.corners, surfacePatch.fillStyle);
 
     if (surfacePatch.lightIntensity > 0) {
-        drawProjectedQuad(
-            context,
-            surfacePatch.corners,
-            `rgba(255, 255, 255, ${0.2 * surfacePatch.lightIntensity})`,
-        );
+        drawProjectedQuad(context, surfacePatch.corners, `rgba(255, 255, 255, ${0.2 * surfacePatch.lightIntensity})`);
     } else if (surfacePatch.lightIntensity < 0) {
         drawProjectedQuad(
             context,

package/src/cli/cli-commands/agents-server/buildAgentsServer.ts

@@ -739,7 +739,9 @@ function isNextBuildTerminationRetryable(exitStatus: NextBuildExitStatus): boole
  * Creates one visible retry message for a killed Next.js build attempt.
  */
 function createNextBuildRetryMessage(exitStatus: NextBuildExitStatus, nextAttempt: number): string {
-    return `\nAgents Server Next build was terminated by ${describeNextBuildExitStatus(exitStatus)}. Retrying attempt ${nextAttempt}/${AGENTS_SERVER_BUILD_MAX_ATTEMPTS}.\n`;
+    return `\nAgents Server Next build was terminated by ${describeNextBuildExitStatus(
+        exitStatus,
+    )}. Retrying attempt ${nextAttempt}/${AGENTS_SERVER_BUILD_MAX_ATTEMPTS}.\n`;
 }
 
 /**

package/src/cli/cli-commands/coder/boilerplateTemplates.ts

@@ -120,26 +120,26 @@ const DEFAULT_CODER_PROMPT_TEMPLATE_DEFINITIONS = [
         id: 'common',
         relativeFilePath: 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(`
+            -   @@@
+            -   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: 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(`
+            -   @@@
+            -   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,
     },
 ] as const satisfies ReadonlyArray<CoderPromptTemplateDefinition>;
@@ -288,13 +288,6 @@ function getDefaultCoderPromptTemplateDefinitionOrUndefined(
     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: ReadonlyArray<string>): string {
-    return lines.join('\n');
-}
-
 /**
  * Creates a fully resolved template payload from one built-in definition.
  */

package/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.ts

@@ -8,10 +8,7 @@ import {
     PROMPTS_TEMPLATES_DIRECTORY_PATH,
 } from './boilerplateTemplates';
 import { ensureCoderEnvFile } from './ensureCoderEnvFile';
-import {
-    CODER_AGENTS_DIRECTORY_PATH,
-    ensureCoderDeveloperAgentFile,
-} from './ensureCoderDeveloperAgentFile';
+import { CODER_AGENTS_DIRECTORY_PATH, ensureCoderDeveloperAgentFile } from './ensureCoderDeveloperAgentFile';
 import { ensureCoderGitignoreFile } from './ensureCoderGitignoreFile';
 import { ensureCoderMarkdownFile } from './ensureCoderMarkdownFile';
 import { ensureCoderPackageJsonFile } from './ensureCoderPackageJsonFile';

package/src/cli/cli-commands/coder/run.ts

@@ -12,10 +12,7 @@ import {
     normalizePromptRunnerCliOptions,
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
-import {
-    DEFAULT_WAIT_AFTER_ERROR_MS,
-    parseOptionalWaitDuration,
-} from './waitOptions';
+import { DEFAULT_WAIT_AFTER_ERROR_MS, parseOptionalWaitDuration } from './waitOptions';
 
 /**
  * Initializes `coder run` command for Promptbook CLI utilities
@@ -66,11 +63,7 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
     );
     addPromptRunnerExecutionOptions(command);
     command.option('--priority <minimum-priority>', 'Filter prompts by minimum priority level', parseIntOption, 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', parsePositiveIntegerOption);
     command.option(
         '--wait-after-prompt <duration>',
         spaceTrim(`

package/src/commitments/TEAM/TEAM.ts

@@ -113,10 +113,10 @@ const teamToolTitles: Record<string_javascript_name, string> = {};
  *
  * @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.',
-] as const;
+const TEAM_SYSTEM_MESSAGE_GUIDANCE = 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.
  */
@@ -352,7 +352,7 @@ function buildTeamSystemMessageBody(teamEntries: ReadonlyArray<TeamToolEntry>):
 
     return spaceTrim(
         (block) => `
-            ${block(TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES.join('\n'))}
+            ${block(TEAM_SYSTEM_MESSAGE_GUIDANCE)}
 
             ${block(teammateSections.join('\n\n'))}
         `,