ptbk 0.114.0-2 → 0.114.0-20

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.
Files changed (2) hide show
  1. package/README.md +8 -16
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -70,8 +70,6 @@ Respond to incoming legal inquiries via email and keep the company website updat
70
70
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
71
71
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
72
72
  <br/>
73
- USE EMAIL<br/>
74
- USE BROWSER<br/>
75
73
  <br/>
76
74
  TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
77
75
 
@@ -160,7 +158,7 @@ GOAL Keep the company website updated with the latest legal policies and complia
160
158
 
161
159
  #### `Use` commitments
162
160
 
163
- Use commitments grant the agent real capabilities - tools it can use to interact with the outside world. `USE EMAIL` lets the agent send emails, `USE BROWSER` lets it access and read web content, `USE SEARCH ENGINE` lets it search the web, and many more.
161
+ Use commitments grant the agent real capabilities - tools it can use to interact with the outside world. `USE CALENDAR` lets the agent work with a calendar, `USE PROJECT` gives it access to a code repository, `USE MCP` connects any external Model Context Protocol server, and many more.
164
162
 
165
163
  These are what turn a chatbot into a persistent agent that actually does work.
166
164
 
@@ -177,9 +175,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
177
175
  **RULE** Never provide legal advice about criminal law.<br/>
178
176
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
179
177
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
180
- USE EMAIL<br/>
181
- USE BROWSER<br/>
182
- USE SEARCH ENGINE<br/>
183
178
 
184
179
  </td></tr></table>
185
180
 
@@ -200,9 +195,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
200
195
  **RULE** Never provide legal advice about criminal law.<br/>
201
196
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
202
197
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
203
- USE EMAIL<br/>
204
- USE BROWSER<br/>
205
- USE SEARCH ENGINE<br/>
206
198
  TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
207
199
 
208
200
  </td></tr></table>
@@ -389,7 +381,7 @@ Or you can install them separately:
389
381
 
390
382
  Promptbook Coder is **not another standalone coding model**. It is an orchestration layer over coding agents such as **GitHub Copilot**, **OpenAI Codex**, **Claude Code**, **Opencode**, **Cline**, and **Gemini CLI**. The difference is that Promptbook Coder adds a repeatable repository workflow on top of them:
391
383
 
392
- - prompt files with explicit statuses like `[ ]`, `[x]`, and `[-]`
384
+ - prompt files with explicit statuses like `[ ]`, `[^]`, `[x]`, and `[-]`
393
385
  - automatic selection of the next runnable task, including priority support
394
386
  - optional shared repo context loaded from a file such as `AGENTS.md`
395
387
  - automatic `git add`, commit, and push after each successful prompt
@@ -404,11 +396,11 @@ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**;
404
396
  1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.promptbook`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
405
397
  2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
406
398
  3. You replace placeholder `@@@` sections with real coding tasks.
407
- 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
399
+ 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent and immediately marks it as in progress `[^]`, naming the harness, the model and the step which is running.
408
400
  5. Promptbook Coder marks the prompt as done `[x]`, records runner metadata, then stages, commits, and pushes the resulting changes.
409
401
  6. `ptbk coder verify` reviews completed prompts, archives finished files to `prompts/done/`, and appends a repair prompt when more work is needed.
410
402
 
411
- Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority.
403
+ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority. A prompt left as `[^]` was interrupted in the middle of its implementation — the in-progress status is never reverted, so a killed or crashed coder always leaves that signal behind, and `--git-changes continue` resumes exactly that prompt with its uncommitted changes still in place.
412
404
 
413
405
  #### Features
414
406
 
@@ -416,7 +408,7 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
416
408
  - **Context injection:** `--agent agents/coding/developer.book --context AGENTS.md` or inline extra instructions
417
409
  - **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
418
410
  - **Unattended or interactive runs:** default auto mode, or `--no-auto` to wait for user confirmation before each prompt
419
- - **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
411
+ - **Git safety:** clean working tree check by default, or `--git-changes ignore` to keep the changes and `--git-changes continue` to resume an interrupted prompt
420
412
  - **Opt-in remote pushes:** commits stay local unless you explicitly pass `--auto-push`
421
413
  - **Prompt triage:** `--priority` to process only more important tasks first
422
414
  - **Failure logging:** failed runs write a neighboring `.error.log`
@@ -437,7 +429,7 @@ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gp
437
429
 
438
430
  npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
439
431
 
440
- npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --ignore-git-changes
432
+ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --git-changes ignore
441
433
 
442
434
  npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
443
435
 
@@ -463,7 +455,7 @@ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh -
463
455
 
464
456
  ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
465
457
 
466
- ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test --ignore-git-changes
458
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test --git-changes ignore
467
459
 
468
460
  ptbk coder find-refactor-candidates
469
461
 
@@ -495,7 +487,7 @@ ptbk coder verify
495
487
  | `--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`. |
496
488
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
497
489
  | `--no-auto` | Waits for user confirmation before each prompt instead of running automatically through the queue. |
498
- | `--ignore-git-changes` | Disables the clean-working-tree guard. |
490
+ | `--git-changes <mode>` | Decides what happens with a dirty working tree: `fail` (default), `ignore` to keep the changes, or `continue` to resume the single interrupted `[^]` prompt with them. |
499
491
  | `--priority <n>` | Runs only prompts at or above the given priority. |
500
492
  | `--dry-run` | Prints which prompts are ready instead of executing them. |
501
493
  | `--allow-credits` | Lets OpenAI Codex spend credits when required. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ptbk",
3
- "version": "0.114.0-2",
3
+ "version": "0.114.0-20",
4
4
  "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
5
5
  "private": false,
6
6
  "sideEffects": false,
@@ -91,10 +91,10 @@
91
91
  "zod": "$zod"
92
92
  },
93
93
  "peerDependencies": {
94
- "@promptbook/core": "0.114.0-2"
94
+ "@promptbook/core": "0.114.0-20"
95
95
  },
96
96
  "dependencies": {
97
- "promptbook": "0.114.0-2"
97
+ "promptbook": "0.114.0-20"
98
98
  },
99
99
  "bin": {
100
100
  "ptbk": "bin/promptbook-cli-proxy.js"