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.
- package/README.md +8 -16
- 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
|
|
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,
|
|
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 --
|
|
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 --
|
|
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
|
-
| `--
|
|
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-
|
|
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-
|
|
94
|
+
"@promptbook/core": "0.114.0-20"
|
|
95
95
|
},
|
|
96
96
|
"dependencies": {
|
|
97
|
-
"promptbook": "0.114.0-
|
|
97
|
+
"promptbook": "0.114.0-20"
|
|
98
98
|
},
|
|
99
99
|
"bin": {
|
|
100
100
|
"ptbk": "bin/promptbook-cli-proxy.js"
|