@promptbook/core 0.112.0-41 → 0.112.0-43

package/README.md

@@ -688,6 +688,7 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
 -   **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
 -   **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
 -   **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
+-   **Opt-in remote pushes:** commits stay local unless you explicitly pass `--auto-push`
 -   **Prompt triage:** `--priority` to process only more important tasks first
 -   **Failure logging:** failed runs write a neighboring `.error.log`
 -   **Line-ending normalization:** changed files are normalized back to LF by default
@@ -705,6 +706,8 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
 
 npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
 
+npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
+
 npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
 
 npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
@@ -727,9 +730,11 @@ npx ptbk coder generate-boilerplates
 
 npx ptbk coder generate-boilerplates --template prompts/templates/common.md
 
-npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
+npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
+
+npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
 
-npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
+npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
 
 npx ptbk coder find-refactor-candidates
 
@@ -746,7 +751,7 @@ npx ptbk coder verify
 | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
 | `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 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, marks success or failure, then commits and pushes the result.                                                                                                                                                                                                                                                                                                      |
+| `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. |
 | `ptbk coder verify`                   | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results.                                                                                                                                                                                                                                                                                                                                             |
 
@@ -757,12 +762,14 @@ npx ptbk coder verify
 | `--agent <name>`           | Selects the coding backend.                                                                        |
 | `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
 | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                 |
+| `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.    |
 | `--thinking-level <level>` | Sets reasoning effort for supported runners.                                                       |
 | `--no-wait`                | Skips interactive pauses between prompts for unattended execution.                                 |
 | `--ignore-git-changes`     | Disables the clean-working-tree guard.                                                             |
 | `--priority <n>`           | Runs only prompts at or above the given priority.                                                  |
 | `--dry-run`                | Prints which prompts are ready instead of executing them.                                          |
 | `--allow-credits`          | Lets OpenAI Codex spend credits when required.                                                     |
+| `--auto-push`              | Pushes each successful coding-agent commit to the configured remote.                               |
 | `--auto-migrate`           | Runs testing-server database migrations after each successful prompt.                              |
 
 #### Typical usage pattern

package/esm/index.es.js

@@ -28,7 +28,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-41';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-43';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -7868,7 +7868,7 @@ function createEmptyAgentModelRequirements() {
         systemMessage: '',
         promptSuffix: '',
         // modelName: 'gpt-5',
-        modelName: 'gemini-2.5-flash-lite',
+        modelName: 'gpt-5.4-mini',
         temperature: 0.7,
         topP: 0.9,
         topK: 50,
@@ -15056,6 +15056,15 @@ const teamToolFunctions = {};
  * Map of team tool titles.
  */
 const teamToolTitles = {};
+/**
+ * Shared TEAM usage rules appended ahead of teammate listings.
+ *
+ * @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.',
+];
 /**
  * Constant for remote agents by Url.
  */
@@ -15145,12 +15154,9 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
             if (updatedTools.some((tool) => tool.name === entry.toolName)) {
                 continue;
             }
-            const toolDescription = entry.description
-                ? `Consult teammate ${entry.teammate.label}\n${entry.description}`
-                : `Consult teammate ${entry.teammate.label}`;
             updatedTools.push({
                 name: entry.toolName,
-                description: toolDescription,
+                description: buildTeamToolDescription(entry),
                 parameters: {
                     type: 'object',
                     properties: {
@@ -15219,22 +15225,72 @@ function resolveTeamTeammateLabels(teamContent, teammates) {
 /**
  * Builds the textual TEAM section body for the final system message.
  *
- * Each teammate is listed with its tool name and, when available, a one-line description.
- * Uses `spaceTrim` to ensure consistent whitespace and indentation.
+ * Each teammate is listed with its tool name, TEAM instructions, and optional profile hints.
  */
 function buildTeamSystemMessageBody(teamEntries) {
-    const lines = teamEntries.map((entry, index) => {
-        const toolLine = `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``;
-        if (!entry.description) {
-            return toolLine;
-        }
-        return spaceTrim$1(`
-            ${toolLine}
-               ${entry.description}
-        `);
-    });
+    const lines = [
+        ...TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES,
+        '',
+        ...teamEntries.map((entry, index) => {
+            const toolLine = `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``;
+            const detailLines = collectTeamEntryDetails(entry).map(formatTeamEntryDetailLine);
+            return [toolLine, ...detailLines].join('\n');
+        }),
+    ];
     return lines.join('\n');
 }
+/**
+ * Builds the model-visible description for one teammate tool.
+ *
+ * @private
+ */
+function buildTeamToolDescription(entry) {
+    const detailLines = collectTeamEntryDetails(entry).map(({ label, content }) => `${label}: ${content}`);
+    return [`Consult teammate ${entry.teammate.label}`, ...detailLines].join('\n');
+}
+/**
+ * Collects structured teammate details that should stay visible to the model.
+ *
+ * @private
+ */
+function collectTeamEntryDetails(entry) {
+    var _a;
+    const details = [];
+    const instructions = entry.teammate.instructions.trim();
+    const description = ((_a = entry.description) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+    if (instructions) {
+        details.push({
+            label: 'TEAM instructions',
+            content: instructions,
+        });
+    }
+    if (description) {
+        details.push({
+            label: 'Profile',
+            content: description,
+        });
+    }
+    return details;
+}
+/**
+ * Formats one teammate detail line for the TEAM system-message section.
+ *
+ * @private
+ */
+function formatTeamEntryDetailLine(detail) {
+    return indentMultilineText(`${detail.label}: ${detail.content}`, '   ');
+}
+/**
+ * Indents all lines of one potentially multi-line text block.
+ *
+ * @private
+ */
+function indentMultilineText(text, prefix) {
+    return text
+        .split('\n')
+        .map((line) => `${prefix}${line}`)
+        .join('\n');
+}
 /**
  * Registers tool function and title for a teammate tool.
  */
@@ -23457,6 +23513,60 @@ function stripMetaIdLines(agentSource) {
     return strippedLines.join('\n');
 }
 
+/**
+ * Builds normalized insert rows for a newly created persisted agent.
+ *
+ * @param agentSource - Source content of the agent.
+ * @param options - Optional folder placement, ordering, and visibility overrides.
+ * @param createdAt - Shared creation timestamp used across all persisted rows.
+ * @returns Insert rows and the created agent profile.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+function createAgentPersistenceRecords(agentSource, options = {}, createdAt = new Date().toISOString()) {
+    const preparedAgentSource = prepareAgentSourceForPersistence(agentSource);
+    const { agentProfile, agentSource: normalizedAgentSource } = preparedAgentSource;
+    const permanentId = preparedAgentSource.permanentId || $randomBase58(14);
+    const { agentName, agentHash } = agentProfile;
+    const agentInsertRecord = {
+        agentName,
+        agentHash,
+        permanentId,
+        agentProfile,
+        createdAt,
+        updatedAt: null,
+        promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+        usage: ZERO_USAGE,
+        agentSource: normalizedAgentSource,
+    };
+    if (options.folderId !== undefined) {
+        agentInsertRecord.folderId = options.folderId;
+    }
+    if (options.sortOrder !== undefined) {
+        agentInsertRecord.sortOrder = options.sortOrder;
+    }
+    if (options.visibility !== undefined) {
+        agentInsertRecord.visibility = options.visibility;
+    }
+    return {
+        createdAgent: {
+            ...agentProfile,
+            permanentId,
+        },
+        agentInsertRecord,
+        agentHistoryInsertRecord: {
+            createdAt,
+            agentName,
+            permanentId,
+            agentHash,
+            previousAgentHash: null,
+            agentSource: normalizedAgentSource,
+            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            versionName: null,
+        },
+    };
+}
+
 /**
  * Normalizes optional history version name before persistence.
  *
@@ -23580,52 +23690,18 @@ class AgentCollectionInSupabase /* TODO: [🌈][🐱‍🚀] implements AgentCol
      * @param options - Optional folder placement and ordering data.
      */
     async createAgent(agentSource, options = {}) {
-        const preparedAgentSource = prepareAgentSourceForPersistence(agentSource);
-        const { agentProfile, agentSource: normalizedAgentSource } = preparedAgentSource;
-        let { permanentId } = preparedAgentSource;
-        const { agentName, agentHash } = agentProfile;
-        if (!permanentId) {
-            permanentId = $randomBase58(14);
-        }
-        const insertPayload = {
-            agentName,
-            agentHash,
-            permanentId,
-            agentProfile,
-            createdAt: new Date().toISOString(),
-            updatedAt: null,
-            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
-            usage: ZERO_USAGE,
-            agentSource: normalizedAgentSource,
-        };
-        if (options.folderId !== undefined) {
-            insertPayload.folderId = options.folderId;
-        }
-        if (options.sortOrder !== undefined) {
-            insertPayload.sortOrder = options.sortOrder;
-        }
-        if (options.visibility !== undefined) {
-            insertPayload.visibility = options.visibility;
-        }
-        const insertAgentResult = await this.supabaseClient.from(this.getTableName('Agent')).insert(insertPayload);
+        const createdAt = new Date().toISOString();
+        const { createdAgent, agentInsertRecord, agentHistoryInsertRecord } = createAgentPersistenceRecords(agentSource, options, createdAt);
+        const insertAgentResult = await this.supabaseClient.from(this.getTableName('Agent')).insert(agentInsertRecord);
         if (insertAgentResult.error) {
             throw new DatabaseError(spaceTrim((block) => `
-                        Error creating agent "${agentProfile.agentName}" in Supabase:
+                        Error creating agent "${createdAgent.agentName}" in Supabase:
                         
                         ${block(insertAgentResult.error.message)}
                     `));
         }
-        await this.insertAgentHistoryRow({
-            createdAt: new Date().toISOString(),
-            agentName,
-            permanentId,
-            agentHash,
-            previousAgentHash: null,
-            agentSource: normalizedAgentSource,
-            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
-            versionName: null,
-        });
-        return { ...agentProfile, permanentId };
+        await this.insertAgentHistoryRow(agentHistoryInsertRecord);
+        return createdAgent;
     }
     /**
      * Updates an existing agent in the collection
@@ -32681,7 +32757,7 @@ class OpenAiVectorStoreHandler extends OpenAiExecutionTools {
 /**
  * Constant for default agent kit model name.
  */
-const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-nano';
+const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-mini';
 /**
  * Creates one structured log entry for streamed tool-call updates.
  *
@@ -34747,6 +34823,7 @@ class AgentLlmExecutionTools {
      * @param agentSource The agent source string that defines the agent's behavior
      */
     constructor(options) {
+        var _a;
         this.options = options;
         /**
          * Cached model requirements to avoid re-parsing the agent source
@@ -34756,6 +34833,7 @@ class AgentLlmExecutionTools {
          * Cached parsed agent information
          */
         this._cachedAgentInfo = null;
+        this.precomputedModelRequirements = (_a = options.precomputedModelRequirements) !== null && _a !== void 0 ? _a : null;
     }
     /**
      * Updates the agent source and clears the cache
@@ -34763,9 +34841,13 @@ class AgentLlmExecutionTools {
      * @param agentSource The new agent source string
      */
     updateAgentSource(agentSource) {
+        if (this.options.agentSource === agentSource) {
+            return;
+        }
         this.options.agentSource = agentSource;
         this._cachedAgentInfo = null;
         this._cachedModelRequirements = null;
+        this.precomputedModelRequirements = null;
     }
     /**
      * Get cached or parse agent information
@@ -34782,6 +34864,16 @@ class AgentLlmExecutionTools {
      * Note: [🐤] This is names `getModelRequirements` *(not `getAgentModelRequirements`)* because in future these two will be united
      */
     async getModelRequirements() {
+        var _a, _b;
+        if (this.precomputedModelRequirements !== null) {
+            if (this.options.isVerbose) {
+                console.info('[🤰]', 'Using precomputed agent model requirements', {
+                    agent: this.title,
+                    toolCount: (_b = (_a = this.precomputedModelRequirements.tools) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0,
+                });
+            }
+            return this.precomputedModelRequirements;
+        }
         if (this._cachedModelRequirements === null) {
             const preparationStartedAtMs = Date.now();
             if (this.options.isVerbose) {
@@ -34891,6 +34983,7 @@ class AgentLlmExecutionTools {
      * Resolves agent requirements, attachments, and runtime overrides into one forwarded chat prompt.
      */
     async prepareChatPrompt(prompt) {
+        var _a;
         const chatPrompt = this.requireChatPrompt(prompt);
         const { sanitizedRequirements, promptSuffix } = await this.getSanitizedAgentModelRequirements();
         const attachments = normalizeChatAttachments(chatPrompt.attachments);
@@ -34908,7 +35001,16 @@ class AgentLlmExecutionTools {
             mergedTools,
             knowledgeSourcesForAgent,
         });
-        console.log('!!!! promptWithAgentModelRequirements:', forwardedPrompt);
+        if (this.options.isVerbose) {
+            console.info('[🤰]', 'Prepared agent chat prompt', {
+                agent: this.title,
+                usedPrecomputedModelRequirements: this.precomputedModelRequirements !== null,
+                toolNames: mergedTools.map((tool) => tool.name),
+                knowledgeSourcesCount: (_a = knowledgeSourcesForAgent === null || knowledgeSourcesForAgent === void 0 ? void 0 : knowledgeSourcesForAgent.length) !== null && _a !== void 0 ? _a : 0,
+                promptSuffixLength: promptSuffix.length,
+                systemMessageLength: sanitizedRequirements.systemMessage.length,
+            });
+        }
         return {
             forwardedPrompt,
             sanitizedRequirements,
@@ -35095,6 +35197,7 @@ class AgentLlmExecutionTools {
      * Runs one prepared prompt through the deprecated OpenAI Assistant backend.
      */
     async callOpenAiAssistantChatModelStream(options) {
+        var _a, _b, _c, _d;
         const assistant = await this.getOrPrepareOpenAiAssistant({
             llmTools: options.llmTools,
             originalPrompt: options.originalPrompt,
@@ -35102,7 +35205,14 @@ class AgentLlmExecutionTools {
             onProgress: options.onProgress,
         });
         const promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools = createOpenAiAssistantPrompt(options.preparedChatPrompt.forwardedPrompt);
-        console.log('!!!! promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools:', promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools);
+        if (this.options.isVerbose) {
+            console.info('[🤰]', 'Prepared OpenAI Assistant prompt', {
+                agent: this.title,
+                toolNames: (_b = (_a = promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools.modelRequirements.tools) === null || _a === void 0 ? void 0 : _a.map((tool) => tool.name)) !== null && _b !== void 0 ? _b : [],
+                knowledgeSourcesCount: (_d = (_c = promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools.modelRequirements
+                    .knowledgeSources) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0,
+            });
+        }
         return assistant.callChatModelStream(promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools, options.onProgress, options.streamOptions);
     }
     /**
@@ -35793,7 +35903,8 @@ class Agent extends AgentLlmExecutionTools {
             isVerbose: options.isVerbose,
             llmTools: getSingleLlmExecutionTools(options.executionTools.llm),
             assistantPreparationMode: options.assistantPreparationMode,
-            agentSource: agentSource.value, // <- TODO: [🐱‍🚀] Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
+            agentSource: agentSource.value,
+            precomputedModelRequirements: options.precomputedModelRequirements,
         });
         this._agentName = undefined;
         /**
@@ -38411,6 +38522,7 @@ function $generateBookBoilerplate(options) {
                 
                 PERSONA ${block(personaDescription)}
                 ${block(initialRules.map((rule) => `RULE ${rule}`).join('\n'))}
+                CLOSED
             `));
     // Note: `META COLOR ${color || PROMPTBOOK_COLOR.toHex()}` was removed for now
     // Note: `META FONT Playfair Display, sans-serif` was removed for now