@promptbook/cli 0.112.0-40 → 0.112.0-42

package/README.md

@@ -19,11 +19,13 @@ Create persistent AI agents that turn your company's scattered knowledge into ac
 [![🧪 Test types](https://github.com/webgptorg/promptbook/actions/workflows/test-types.yml/badge.svg)](https://github.com/webgptorg/promptbook/actions/workflows/test-types.yml)
 [![Issues](https://img.shields.io/github/issues/webgptorg/promptbook.svg?style=flat)](https://github.com/webgptorg/promptbook/issues)
 
+## 🚀 Quick deploy
 
 
-## 🌟 New Features
 
--   **Gemini 3 Support**
+[![Vercel](https://img.shields.io/badge/Vercel-Deploy%20Agents%20Server-black?logo=vercel)](https://vercel.com/new/clone?project-name=promptbook-agents-server&repository-name=promptbook-agents-server&repository-url=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook&root-directory=apps%2Fagents-server&demo-title=Promptbook+Agents+Server&demo-description=Persistent+AI+agents+with+a+built-in+admin+UI.+This+deploy+creates+a+Supabase+project+automatically%2C+injects+the+required+database+credentials%2C+and+Promptbook+runs+the+SQL+migrations+on+first+startup.&demo-url=https%3A%2F%2Fgallery.ptbk.io%2F&external-id=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook%2Ftree%2Fmain%2Fapps%2Fagents-server&env=OPENAI_API_KEY%2CADMIN_PASSWORD%2CSUPABASE_AUTO_MIGRATE&envDescription=Supabase+is+created+automatically+by+the+required+Vercel+integration.+Add+OPENAI_API_KEY+from+https%3A%2F%2Fplatform.openai.com%2Fapi-keys%2C+choose+ADMIN_PASSWORD+for+your+first+admin+login%2C+and+leave+SUPABASE_AUTO_MIGRATE+enabled.&envLink=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook%2Fblob%2Fmain%2FREADME.md%23vercel-form-fields&envDefaults=%7B%22SUPABASE_AUTO_MIGRATE%22%3A%22true%22%7D&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22supabase%22%2C%22productSlug%22%3A%22supabase%22%7D%5D)
+
+
 
 
 
@@ -597,28 +599,28 @@ npx ptbk coder verify
 
 #### 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 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 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. |
+| 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 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 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.                                                                                                                                                                                                                                                                                                                                             |
 
 #### Most useful `ptbk coder run` flags
 
-| Flag | Purpose |
-| --- | --- |
-| `--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`. |
-| `--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-migrate` | Runs testing-server database migrations after each successful prompt. |
+| Flag                       | Purpose                                                                                            |
+| -------------------------- | -------------------------------------------------------------------------------------------------- |
+| `--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`.                                 |
+| `--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-migrate`           | Runs testing-server database migrations after each successful prompt.                              |
 
 #### Typical usage pattern
 

package/esm/apps/agents-server/src/database/acquireMigrationExecutionLock.d.ts

@@ -1,14 +1,25 @@
-import { Client } from 'pg';
+import type { Client } from 'pg';
 import type { DatabaseMigrationLogger } from './runDatabaseMigrations';
+/**
+ * Lock-acquisition strategies used by the migration runner.
+ *
+ * `wait` is appropriate for explicit/manual migration flows where the caller expects one serialized run.
+ * `skip` is appropriate for background startup checks where waiting would block request handling.
+ *
+ * @private function of runDatabaseMigrations
+ */
+export type DatabaseMigrationExecutionLockMode = 'wait' | 'skip';
 /**
  * Acquires advisory lock preventing concurrent migration execution across processes.
  *
  * @param client Connected PostgreSQL client.
  * @param logger Logger used for progress output.
+ * @param mode Whether the caller should block for the lock or skip when it is already held.
+ * @returns `true` when the lock was acquired and migrations may proceed.
  *
  * @private function of runDatabaseMigrations
  */
-export declare function acquireMigrationExecutionLock(client: Client, logger: DatabaseMigrationLogger): Promise<void>;
+export declare function acquireMigrationExecutionLock(client: Client, logger: DatabaseMigrationLogger, mode?: DatabaseMigrationExecutionLockMode): Promise<boolean>;
 /**
  * Releases advisory lock used for migration execution.
  *

package/esm/apps/agents-server/src/database/importRuntimeModule.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Imports a runtime-only module without letting Next.js statically bundle Node-only dependencies.
+ *
+ * @param specifier - Module specifier to import at runtime.
+ * @returns Imported module namespace.
+ * @private internal helper for runtime-only database utilities
+ */
+export declare function importRuntimeModule<TModule>(specifier: string): Promise<TModule>;

package/esm/apps/agents-server/src/database/migratePrefix.d.ts

@@ -1,4 +1,4 @@
-import { Client } from 'pg';
+import type { Client } from 'pg';
 import type { DatabaseMigrationAppliedBy, DatabaseMigrationLogger } from './runDatabaseMigrations';
 /**
  * Context for one prefix migration pass.

package/esm/apps/agents-server/src/database/resolveMigrationsDirectory.d.ts

@@ -5,7 +5,7 @@
  *
  * @private function of runDatabaseMigrations
  */
-export declare function resolveMigrationsDirectory(): string;
+export declare function resolveMigrationsDirectory(): Promise<string>;
 /**
  * Reads migration files from directory and sorts them lexicographically.
  *
@@ -14,4 +14,4 @@ export declare function resolveMigrationsDirectory(): string;
  *
  * @private function of runDatabaseMigrations
  */
-export declare function readMigrationFiles(migrationsDirectory: string): Array<string>;
+export declare function readMigrationFiles(migrationsDirectory: string): Promise<Array<string>>;

package/esm/apps/agents-server/src/database/runDatabaseMigrations.d.ts

@@ -1,4 +1,5 @@
 import { type ServerRecord } from '../utils/serverRegistry';
+import { type DatabaseMigrationExecutionLockMode } from './acquireMigrationExecutionLock';
 /**
  * Allowed values describing who applied a migration record.
  */
@@ -67,6 +68,10 @@ export type RunDatabaseMigrationsOptions = {
      * If true, prints every SQL migration body before execution.
      */
     readonly logSqlStatements?: boolean;
+    /**
+     * Whether migration execution should wait for the advisory lock or skip when another process already owns it.
+     */
+    readonly executionLockMode?: DatabaseMigrationExecutionLockMode;
 };
 /**
  * Result of one prefix migration run.
@@ -97,6 +102,10 @@ export type RunDatabaseMigrationsResult = {
      * Per-prefix summary.
      */
     readonly perPrefix: ReadonlyArray<DatabaseMigrationPrefixResult>;
+    /**
+     * Whether migration execution was skipped because another process already held the advisory lock.
+     */
+    readonly isSkippedDueToActiveMigrationLock: boolean;
 };
 /**
  * Reads migration runtime configuration from environment variables and `_Server`.