@promptbook/markdown-utils 0.112.0-123 → 0.112.0-124

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 (10) hide show
  1. package/README.md +14 -14
  2. package/esm/index.es.js +1 -1
  3. package/esm/src/cli/cli-commands/coder/ensureCoderDeveloperAgentFile.d.ts +25 -0
  4. package/esm/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts +2 -0
  5. package/esm/src/version.d.ts +1 -1
  6. package/package.json +1 -1
  7. package/umd/index.umd.js +1 -1
  8. package/umd/src/cli/cli-commands/coder/ensureCoderDeveloperAgentFile.d.ts +25 -0
  9. package/umd/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts +2 -0
  10. package/umd/src/version.d.ts +1 -1
package/README.md CHANGED
@@ -506,7 +506,7 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
506
506
  #### Features
507
507
 
508
508
  - **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
509
- - **Context injection:** `--context AGENTS.md` or inline extra instructions
509
+ - **Context injection:** `--agent agents/coding/developer.book --context AGENTS.md` or inline extra instructions
510
510
  - **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
511
511
  - **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
512
512
  - **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
@@ -526,11 +526,11 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
526
526
 
527
527
  npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
528
528
 
529
- npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
529
+ 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
530
530
 
531
- npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
531
+ 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
532
532
 
533
- npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
533
+ 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 --no-wait
534
534
 
535
535
  npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
536
536
 
@@ -552,11 +552,11 @@ ptbk coder generate-boilerplates
552
552
 
553
553
  ptbk coder generate-boilerplates --template prompts/templates/common.md
554
554
 
555
- ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
555
+ 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
556
556
 
557
- ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
557
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
558
558
 
559
- ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
559
+ 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 --no-wait
560
560
 
561
561
  ptbk coder find-refactor-candidates
562
562
 
@@ -569,13 +569,13 @@ ptbk coder verify
569
569
 
570
570
  #### What each command does
571
571
 
572
- | Command | What it does |
573
- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
572
+ | Command | What it does |
573
+ | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
574
574
  | `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/`. |
575
- | `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. |
576
- | `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. |
577
- | `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. |
578
- | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
575
+ | `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. |
576
+ | `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. |
577
+ | `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. |
578
+ | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
579
579
 
580
580
  #### Most useful `ptbk coder run` flags
581
581
 
@@ -598,7 +598,7 @@ ptbk coder verify
598
598
 
599
599
  1. Initialize once with `ptbk coder init`.
600
600
  2. Customize `prompts/templates/*.md` if needed, then create or write prompt files in `prompts/`.
601
- 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--context AGENTS.md`.
601
+ 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--agent agents/coding/developer.book --context AGENTS.md`.
602
602
  4. Run one prompt at a time interactively, or use `--no-wait` for unattended batches.
603
603
  5. Finish with `ptbk coder verify` so resolved prompts are archived and broken ones get explicit repair follow-ups.
604
604
 
package/esm/index.es.js CHANGED
@@ -22,7 +22,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
22
22
  * @generated
23
23
  * @see https://github.com/webgptorg/promptbook
24
24
  */
25
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-123';
25
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-124';
26
26
  /**
27
27
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
28
28
  * Note: [💞] Ignore a discrepancy between file name and entity name
package/esm/src/cli/cli-commands/coder/ensureCoderDeveloperAgentFile.d.ts ADDED
@@ -0,0 +1,25 @@
1
+ import type { InitializationStatus } from './boilerplateTemplates';
2
+ /**
3
+ * Relative directory path for agents initialized by `ptbk coder init`.
4
+ *
5
+ * @private internal utility of `coder init` command
6
+ */
7
+ export declare const CODER_AGENTS_DIRECTORY_PATH = "agents";
8
+ /**
9
+ * Relative file path to the default developer agent initialized by `ptbk coder init`.
10
+ *
11
+ * @private internal utility of `coder init` command
12
+ */
13
+ export declare const CODER_DEVELOPER_AGENT_FILE_PATH = "agents/developer.book";
14
+ /**
15
+ * Source file path of the bundled developer agent inside the Promptbook repository.
16
+ *
17
+ * @private internal utility of `coder init` command
18
+ */
19
+ export declare const DEFAULT_CODER_DEVELOPER_AGENT_SOURCE_FILE_PATH = "agents/default/developer.book";
20
+ /**
21
+ * Ensures the default developer agent exists in the initialized project.
22
+ *
23
+ * @private function of `initializeCoderProjectConfiguration`
24
+ */
25
+ export declare function ensureCoderDeveloperAgentFile(projectPath: string): Promise<InitializationStatus>;
package/esm/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts CHANGED
@@ -9,6 +9,8 @@ export type CoderInitializationSummary = {
9
9
  readonly promptsDoneDirectoryStatus: InitializationStatus;
10
10
  readonly promptsTemplatesDirectoryStatus: InitializationStatus;
11
11
  readonly promptTemplateFileStatuses: ReadonlyArray<EnsuredCoderPromptTemplateFile>;
12
+ readonly agentsDirectoryStatus: InitializationStatus;
13
+ readonly developerAgentFileStatus: InitializationStatus;
12
14
  readonly agentsFileStatus: InitializationStatus;
13
15
  readonly agentCodingFileStatus: InitializationStatus;
14
16
  readonly envFileStatus: InitializationStatus;
package/esm/src/version.d.ts CHANGED
@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
15
15
  export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
16
16
  /**
17
17
  * Represents the version string of the Promptbook engine.
18
- * It follows semantic versioning (e.g., `0.112.0-122`).
18
+ * It follows semantic versioning (e.g., `0.112.0-123`).
19
19
  *
20
20
  * @generated
21
21
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@promptbook/markdown-utils",
3
- "version": "0.112.0-123",
3
+ "version": "0.112.0-124",
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,
package/umd/index.umd.js CHANGED
@@ -25,7 +25,7 @@
25
25
  * @generated
26
26
  * @see https://github.com/webgptorg/promptbook
27
27
  */
28
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-123';
28
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-124';
29
29
  /**
30
30
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
31
31
  * Note: [💞] Ignore a discrepancy between file name and entity name
package/umd/src/cli/cli-commands/coder/ensureCoderDeveloperAgentFile.d.ts ADDED
@@ -0,0 +1,25 @@
1
+ import type { InitializationStatus } from './boilerplateTemplates';
2
+ /**
3
+ * Relative directory path for agents initialized by `ptbk coder init`.
4
+ *
5
+ * @private internal utility of `coder init` command
6
+ */
7
+ export declare const CODER_AGENTS_DIRECTORY_PATH = "agents";
8
+ /**
9
+ * Relative file path to the default developer agent initialized by `ptbk coder init`.
10
+ *
11
+ * @private internal utility of `coder init` command
12
+ */
13
+ export declare const CODER_DEVELOPER_AGENT_FILE_PATH = "agents/developer.book";
14
+ /**
15
+ * Source file path of the bundled developer agent inside the Promptbook repository.
16
+ *
17
+ * @private internal utility of `coder init` command
18
+ */
19
+ export declare const DEFAULT_CODER_DEVELOPER_AGENT_SOURCE_FILE_PATH = "agents/default/developer.book";
20
+ /**
21
+ * Ensures the default developer agent exists in the initialized project.
22
+ *
23
+ * @private function of `initializeCoderProjectConfiguration`
24
+ */
25
+ export declare function ensureCoderDeveloperAgentFile(projectPath: string): Promise<InitializationStatus>;
package/umd/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts CHANGED
@@ -9,6 +9,8 @@ export type CoderInitializationSummary = {
9
9
  readonly promptsDoneDirectoryStatus: InitializationStatus;
10
10
  readonly promptsTemplatesDirectoryStatus: InitializationStatus;
11
11
  readonly promptTemplateFileStatuses: ReadonlyArray<EnsuredCoderPromptTemplateFile>;
12
+ readonly agentsDirectoryStatus: InitializationStatus;
13
+ readonly developerAgentFileStatus: InitializationStatus;
12
14
  readonly agentsFileStatus: InitializationStatus;
13
15
  readonly agentCodingFileStatus: InitializationStatus;
14
16
  readonly envFileStatus: InitializationStatus;
package/umd/src/version.d.ts CHANGED
@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
15
15
  export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
16
16
  /**
17
17
  * Represents the version string of the Promptbook engine.
18
- * It follows semantic versioning (e.g., `0.112.0-122`).
18
+ * It follows semantic versioning (e.g., `0.112.0-123`).
19
19
  *
20
20
  * @generated
21
21
  */