@promptbook/core 0.114.0-0 → 0.114.0-2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -768,26 +768,27 @@ ptbk coder verify
768
768
  | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
769
769
  | `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/`. |
770
770
  | `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. |
771
- | `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. |
771
+ | `ptbk coder run` | Picks the next ready prompt, can run tests before coding to stop or repair pre-existing failures, 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. |
772
772
  | `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. |
773
773
  | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
774
774
 
775
775
  #### Most useful `ptbk coder run` flags
776
776
 
777
- | Flag | Purpose |
778
- | -------------------------- | -------------------------------------------------------------------------------------------------- |
779
- | `--harness <name>` | Selects the coding harness. |
780
- | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
781
- | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
782
- | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
783
- | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
784
- | `--no-auto` | Waits for user confirmation before each prompt instead of running automatically through the queue. |
785
- | `--ignore-git-changes` | Disables the clean-working-tree guard. |
786
- | `--priority <n>` | Runs only prompts at or above the given priority. |
787
- | `--dry-run` | Prints which prompts are ready instead of executing them. |
788
- | `--allow-credits` | Lets OpenAI Codex spend credits when required. |
789
- | `--auto-push` | Pushes each successful coding-agent commit to the configured remote. |
790
- | `--auto-migrate` | Runs testing-server database migrations after each successful prompt. |
777
+ | Flag | Purpose |
778
+ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
779
+ | `--harness <name>` | Selects the coding harness. |
780
+ | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
781
+ | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
782
+ | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
783
+ | `--test-before <mode>` | Runs tests before coding: `no` (default), `yes-and-fail` (stop with results), or `yes-and-fix` (create one repair prompt first); defaults to `npm test` when enabled without `--test`. |
784
+ | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
785
+ | `--no-auto` | Waits for user confirmation before each prompt instead of running automatically through the queue. |
786
+ | `--ignore-git-changes` | Disables the clean-working-tree guard. |
787
+ | `--priority <n>` | Runs only prompts at or above the given priority. |
788
+ | `--dry-run` | Prints which prompts are ready instead of executing them. |
789
+ | `--allow-credits` | Lets OpenAI Codex spend credits when required. |
790
+ | `--auto-push` | Pushes each successful coding-agent commit to the configured remote. |
791
+ | `--auto-migrate` | Runs testing-server database migrations after each successful prompt. |
791
792
 
792
793
  #### Typical usage pattern
793
794