@promptbook/wizard 0.112.0-35 → 0.112.0-36

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
@@ -365,24 +365,6 @@ You can install all of them at once:
365
365
  npm i ptbk
366
366
  ```
367
367
 
368
- Promptbook also ships coding-agent CLI utilities through `ptbk coder`.
369
- For full `coder run` options and runner-specific examples, see [`scripts/run-codex-prompts/README.md`](./scripts/run-codex-prompts/README.md).
370
-
371
- #### `ptbk coder`
372
-
373
- Locally in this repository:
374
-
375
- ```bash
376
- npx ts-node ./src/cli/test/ptbk.ts coder run --dry-run
377
- ```
378
-
379
- In another project with `ptbk` installed:
380
-
381
- ```bash
382
- npm install ptbk
383
- npx ptbk coder run --dry-run
384
- ```
385
-
386
368
  Or you can install them separately:
387
369
 
388
370
  > ⭐ Marked packages are worth to try first
@@ -420,6 +402,121 @@ Or you can install them separately:
420
402
 
421
403
 
422
404
 
405
+ ### 🤖 Promptbook Coder
406
+
407
+ `ptbk coder` is Promptbook's workflow layer for AI-assisted software changes. Instead of opening one chat and manually copy-pasting tasks, you keep a queue of coding prompts in `prompts/*.md`, let a coding agent execute the next ready task, and then verify the result before archiving the prompt.
408
+
409
+ 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:
410
+
411
+ - prompt files with explicit statuses like `[ ]`, `[x]`, and `[-]`
412
+ - automatic selection of the next runnable task, including priority support
413
+ - optional shared repo context loaded from a file such as `AGENTS.md`
414
+ - automatic `git add`, commit, and push after each successful prompt
415
+ - dedicated coding-agent Git identity and optional GPG signing
416
+ - verification and repair flow for work that is done, partial, or broken
417
+ - helper commands for generating boilerplates and finding refactor prompts
418
+
419
+ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**; Promptbook Coder is the **workflow** that keeps coding work structured, reviewable, and repeatable across many prompts.
420
+
421
+ #### How the workflow works
422
+
423
+ 1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned templates in `prompts/templates/`, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.tmp`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
424
+ 2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
425
+ 3. You replace placeholder `@@@` sections with real coding tasks.
426
+ 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
427
+ 5. Promptbook Coder marks the prompt as done `[x]`, records runner metadata, then stages, commits, and pushes the resulting changes.
428
+ 6. `ptbk coder verify` reviews completed prompts, archives finished files to `prompts/done/`, and appends a repair prompt when more work is needed.
429
+
430
+ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority.
431
+
432
+ #### Features
433
+
434
+ - **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
435
+ - **Context injection:** `--context AGENTS.md` or inline extra instructions
436
+ - **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
437
+ - **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
438
+ - **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
439
+ - **Prompt triage:** `--priority` to process only more important tasks first
440
+ - **Failure logging:** failed runs write a neighboring `.error.log`
441
+ - **Line-ending normalization:** changed files are normalized back to LF by default
442
+
443
+ #### Local usage in this repository
444
+
445
+ When working on Promptbook itself, the repository usually runs the CLI straight from source:
446
+
447
+ ```bash
448
+ npx ts-node ./src/cli/test/ptbk.ts coder init
449
+
450
+ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/common.md
451
+
452
+ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
453
+
454
+ npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
455
+
456
+ npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
457
+
458
+ npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
459
+
460
+ npx ts-node ./src/cli/test/ptbk.ts coder verify
461
+ ```
462
+
463
+ #### Using `ptbk coder` in an external project
464
+
465
+ If you want to use the workflow in another repository, install the package and invoke the `ptbk` binary. After local installation, `npx ptbk ...` is the most portable form; plain `ptbk ...` also works when your environment exposes the local binary on `PATH`.
466
+
467
+ ```bash
468
+ npm install ptbk
469
+
470
+ ptbk coder init
471
+
472
+ npx ptbk coder generate-boilerplates
473
+
474
+ npx ptbk coder generate-boilerplates --template prompts/templates/agents-server.md
475
+
476
+ npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
477
+
478
+ npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
479
+
480
+ npx ptbk coder find-refactor-candidates
481
+
482
+ npx ptbk coder verify
483
+ ```
484
+
485
+ `ptbk coder init` also bootstraps `package.json` scripts for the four main coder commands, adds the coder temp ignore to `.gitignore`, and configures `.vscode/settings.json` so pasted images from `prompts/*.md` land in `prompts/screenshots/`.
486
+
487
+ #### What each command does
488
+
489
+ | Command | What it does |
490
+ | --- | --- |
491
+ | `ptbk coder init` | Creates `prompts/`, `prompts/done/`, `prompts/templates/common.md`, `prompts/templates/agents-server.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/`. |
492
+ | `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. |
493
+ | `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. |
494
+ | `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors. |
495
+ | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
496
+
497
+ #### Most useful `ptbk coder run` flags
498
+
499
+ | Flag | Purpose |
500
+ | --- | --- |
501
+ | `--agent <name>` | Selects the coding backend. |
502
+ | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
503
+ | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
504
+ | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
505
+ | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
506
+ | `--ignore-git-changes` | Disables the clean-working-tree guard. |
507
+ | `--priority <n>` | Runs only prompts at or above the given priority. |
508
+ | `--dry-run` | Prints which prompts are ready instead of executing them. |
509
+ | `--allow-credits` | Lets OpenAI Codex spend credits when required. |
510
+ | `--auto-migrate` | Runs testing-server database migrations after each successful prompt. |
511
+
512
+ #### Typical usage pattern
513
+
514
+ 1. Initialize once with `ptbk coder init`.
515
+ 2. Customize `prompts/templates/*.md` if needed, then create or write prompt files in `prompts/`.
516
+ 3. Put repository-specific instructions in `AGENTS.md`, then pass `--context AGENTS.md`.
517
+ 4. Run one prompt at a time interactively, or use `--no-wait` for unattended batches.
518
+ 5. Finish with `ptbk coder verify` so resolved prompts are archived and broken ones get explicit repair follow-ups.
519
+
423
520
 
424
521
 
425
522
 
package/esm/index.es.js CHANGED
@@ -38,7 +38,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
38
38
  * @generated
39
39
  * @see https://github.com/webgptorg/promptbook
40
40
  */
41
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-35';
41
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-36';
42
42
  /**
43
43
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
44
44
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -0,0 +1,127 @@
1
+ /**
2
+ * Relative path to the root prompts directory used by Promptbook coder utilities.
3
+ *
4
+ * @private internal utility of `ptbk coder`
5
+ */
6
+ export declare const PROMPTS_DIRECTORY_PATH = "prompts";
7
+ /**
8
+ * Relative path to the archive directory used by `coder verify`.
9
+ *
10
+ * @private internal utility of `ptbk coder`
11
+ */
12
+ export declare const PROMPTS_DONE_DIRECTORY_PATH: string;
13
+ /**
14
+ * Relative path to the project-owned boilerplate templates directory.
15
+ *
16
+ * @private internal utility of `ptbk coder`
17
+ */
18
+ export declare const PROMPTS_TEMPLATES_DIRECTORY_PATH: string;
19
+ /**
20
+ * Initialization statuses used when creating or updating coder configuration artifacts.
21
+ *
22
+ * @private internal utility of `ptbk coder`
23
+ */
24
+ export type InitializationStatus = 'created' | 'updated' | 'unchanged';
25
+ /**
26
+ * Identifiers of built-in coder boilerplate templates.
27
+ *
28
+ * @private internal utility of `ptbk coder`
29
+ */
30
+ export type BuiltInCoderPromptTemplate = 'common' | 'agents-server';
31
+ /**
32
+ * One built-in coder boilerplate template definition.
33
+ *
34
+ * @private internal utility of `ptbk coder`
35
+ */
36
+ export type CoderPromptTemplateDefinition = {
37
+ /**
38
+ * Stable built-in identifier that can also be used as a CLI shorthand.
39
+ */
40
+ readonly id: BuiltInCoderPromptTemplate;
41
+ /**
42
+ * Project-relative path where `ptbk coder init` materializes the template file.
43
+ */
44
+ readonly relativeFilePath: string;
45
+ /**
46
+ * Prefix inserted into generated prompt file slugs.
47
+ */
48
+ readonly slugPrefix: string | null;
49
+ /**
50
+ * Markdown content of the template.
51
+ */
52
+ readonly content: string;
53
+ };
54
+ /**
55
+ * Result of ensuring one default coder template file exists inside a project.
56
+ *
57
+ * @private internal utility of `ptbk coder`
58
+ */
59
+ export type EnsuredCoderPromptTemplateFile = {
60
+ /**
61
+ * Stable built-in identifier of the template.
62
+ */
63
+ readonly id: BuiltInCoderPromptTemplate;
64
+ /**
65
+ * Project-relative path of the materialized template file.
66
+ */
67
+ readonly relativeFilePath: string;
68
+ /**
69
+ * Status describing whether the file had to be created.
70
+ */
71
+ readonly status: InitializationStatus;
72
+ };
73
+ /**
74
+ * Fully resolved boilerplate template used by `coder generate-boilerplates`.
75
+ *
76
+ * @private internal utility of `ptbk coder`
77
+ */
78
+ export type ResolvedCoderPromptTemplate = {
79
+ /**
80
+ * Identifier or relative file path that was resolved.
81
+ */
82
+ readonly identifier: string;
83
+ /**
84
+ * Project-relative path when the template corresponds to a project file.
85
+ */
86
+ readonly relativeFilePath?: string;
87
+ /**
88
+ * Markdown content of the resolved template.
89
+ */
90
+ readonly content: string;
91
+ /**
92
+ * Prefix inserted into generated prompt file slugs.
93
+ */
94
+ readonly slugPrefix: string | null;
95
+ };
96
+ /**
97
+ * Lists the built-in coder boilerplate templates.
98
+ *
99
+ * @private internal utility of `ptbk coder`
100
+ */
101
+ export declare function getDefaultCoderPromptTemplateDefinitions(): ReadonlyArray<CoderPromptTemplateDefinition>;
102
+ /**
103
+ * Resolves one built-in coder boilerplate template definition by its stable identifier.
104
+ *
105
+ * @private internal utility of `ptbk coder`
106
+ */
107
+ export declare function getDefaultCoderPromptTemplateDefinition(template: BuiltInCoderPromptTemplate): CoderPromptTemplateDefinition;
108
+ /**
109
+ * Ensures the default project-owned coder template files exist without overwriting user customizations.
110
+ *
111
+ * @private internal utility of `ptbk coder`
112
+ */
113
+ export declare function ensureDefaultCoderPromptTemplateFiles(projectPath: string): Promise<ReadonlyArray<EnsuredCoderPromptTemplateFile>>;
114
+ /**
115
+ * Resolves the template requested by `coder generate-boilerplates`.
116
+ *
117
+ * Supports three modes:
118
+ * - omitted option => built-in `common`
119
+ * - built-in alias => one of the shared default templates
120
+ * - relative path => markdown template file resolved from the project root
121
+ *
122
+ * @private internal utility of `ptbk coder`
123
+ */
124
+ export declare function resolveCoderPromptTemplate({ projectPath, templateOption, }: {
125
+ readonly projectPath: string;
126
+ readonly templateOption?: string;
127
+ }): Promise<ResolvedCoderPromptTemplate>;
@@ -8,3 +8,13 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
8
8
  * @private internal function of `promptbookCli`
9
9
  */
10
10
  export declare function $initializeCoderGenerateBoilerplatesCommand(program: Program): $side_effect;
11
+ /**
12
+ * Generates boilerplate prompt files with unique emoji tags.
13
+ *
14
+ * @private internal function of `generatePromptBoilerplate` command
15
+ */
16
+ export declare function generatePromptBoilerplate({ projectPath, filesCount, templateOption, }: {
17
+ readonly projectPath: string;
18
+ readonly filesCount: number;
19
+ readonly templateOption?: string;
20
+ }): Promise<void>;
@@ -1,5 +1,24 @@
1
1
  import type { Command as Program } from 'commander';
2
2
  import type { $side_effect } from '../../../utils/organization/$side_effect';
3
+ import { type EnsuredCoderPromptTemplateFile, type InitializationStatus } from './boilerplateTemplates';
4
+ /**
5
+ * Generic JSON object used for standalone coder configuration files.
6
+ */
7
+ type JsonObject = Record<string, unknown>;
8
+ /**
9
+ * Result summary returned after coder configuration initialization.
10
+ */
11
+ type CoderInitializationSummary = {
12
+ readonly promptsDirectoryStatus: InitializationStatus;
13
+ readonly promptsDoneDirectoryStatus: InitializationStatus;
14
+ readonly promptsTemplatesDirectoryStatus: InitializationStatus;
15
+ readonly promptTemplateFileStatuses: ReadonlyArray<EnsuredCoderPromptTemplateFile>;
16
+ readonly envFileStatus: InitializationStatus;
17
+ readonly gitignoreFileStatus: InitializationStatus;
18
+ readonly packageJsonFileStatus: InitializationStatus;
19
+ readonly vscodeSettingsFileStatus: InitializationStatus;
20
+ readonly initializedEnvVariableNames: ReadonlyArray<string>;
21
+ };
3
22
  /**
4
23
  * Initializes `coder init` command for Promptbook CLI utilities.
5
24
  *
@@ -8,3 +27,22 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
8
27
  * @private internal function of `promptbookCli`
9
28
  */
10
29
  export declare function $initializeCoderInitCommand(program: Program): $side_effect;
30
+ /**
31
+ * Lists the default npm scripts initialized by `ptbk coder init`.
32
+ *
33
+ * @private internal utility of `coder init` command
34
+ */
35
+ export declare function getDefaultCoderPackageJsonScripts(): Readonly<Record<string, string>>;
36
+ /**
37
+ * Lists the default VS Code settings initialized by `ptbk coder init`.
38
+ *
39
+ * @private internal utility of `coder init` command
40
+ */
41
+ export declare function getDefaultCoderVscodeSettings(): Readonly<JsonObject>;
42
+ /**
43
+ * Creates or updates all coder configuration artifacts required in the current project.
44
+ *
45
+ * @private internal utility of `coder init` command
46
+ */
47
+ export declare function initializeCoderProjectConfiguration(projectPath: string): Promise<CoderInitializationSummary>;
48
+ export {};
@@ -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-34`).
18
+ * It follows semantic versioning (e.g., `0.112.0-35`).
19
19
  *
20
20
  * @generated
21
21
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@promptbook/wizard",
3
- "version": "0.112.0-35",
3
+ "version": "0.112.0-36",
4
4
  "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
5
5
  "private": false,
6
6
  "sideEffects": false,
@@ -98,7 +98,7 @@
98
98
  "module": "./esm/index.es.js",
99
99
  "typings": "./esm/typings/src/_packages/wizard.index.d.ts",
100
100
  "peerDependencies": {
101
- "@promptbook/core": "0.112.0-35"
101
+ "@promptbook/core": "0.112.0-36"
102
102
  },
103
103
  "dependencies": {
104
104
  "@ai-sdk/deepseek": "0.1.17",
package/umd/index.umd.js CHANGED
@@ -49,7 +49,7 @@
49
49
  * @generated
50
50
  * @see https://github.com/webgptorg/promptbook
51
51
  */
52
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-35';
52
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-36';
53
53
  /**
54
54
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
55
55
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -0,0 +1,127 @@
1
+ /**
2
+ * Relative path to the root prompts directory used by Promptbook coder utilities.
3
+ *
4
+ * @private internal utility of `ptbk coder`
5
+ */
6
+ export declare const PROMPTS_DIRECTORY_PATH = "prompts";
7
+ /**
8
+ * Relative path to the archive directory used by `coder verify`.
9
+ *
10
+ * @private internal utility of `ptbk coder`
11
+ */
12
+ export declare const PROMPTS_DONE_DIRECTORY_PATH: string;
13
+ /**
14
+ * Relative path to the project-owned boilerplate templates directory.
15
+ *
16
+ * @private internal utility of `ptbk coder`
17
+ */
18
+ export declare const PROMPTS_TEMPLATES_DIRECTORY_PATH: string;
19
+ /**
20
+ * Initialization statuses used when creating or updating coder configuration artifacts.
21
+ *
22
+ * @private internal utility of `ptbk coder`
23
+ */
24
+ export type InitializationStatus = 'created' | 'updated' | 'unchanged';
25
+ /**
26
+ * Identifiers of built-in coder boilerplate templates.
27
+ *
28
+ * @private internal utility of `ptbk coder`
29
+ */
30
+ export type BuiltInCoderPromptTemplate = 'common' | 'agents-server';
31
+ /**
32
+ * One built-in coder boilerplate template definition.
33
+ *
34
+ * @private internal utility of `ptbk coder`
35
+ */
36
+ export type CoderPromptTemplateDefinition = {
37
+ /**
38
+ * Stable built-in identifier that can also be used as a CLI shorthand.
39
+ */
40
+ readonly id: BuiltInCoderPromptTemplate;
41
+ /**
42
+ * Project-relative path where `ptbk coder init` materializes the template file.
43
+ */
44
+ readonly relativeFilePath: string;
45
+ /**
46
+ * Prefix inserted into generated prompt file slugs.
47
+ */
48
+ readonly slugPrefix: string | null;
49
+ /**
50
+ * Markdown content of the template.
51
+ */
52
+ readonly content: string;
53
+ };
54
+ /**
55
+ * Result of ensuring one default coder template file exists inside a project.
56
+ *
57
+ * @private internal utility of `ptbk coder`
58
+ */
59
+ export type EnsuredCoderPromptTemplateFile = {
60
+ /**
61
+ * Stable built-in identifier of the template.
62
+ */
63
+ readonly id: BuiltInCoderPromptTemplate;
64
+ /**
65
+ * Project-relative path of the materialized template file.
66
+ */
67
+ readonly relativeFilePath: string;
68
+ /**
69
+ * Status describing whether the file had to be created.
70
+ */
71
+ readonly status: InitializationStatus;
72
+ };
73
+ /**
74
+ * Fully resolved boilerplate template used by `coder generate-boilerplates`.
75
+ *
76
+ * @private internal utility of `ptbk coder`
77
+ */
78
+ export type ResolvedCoderPromptTemplate = {
79
+ /**
80
+ * Identifier or relative file path that was resolved.
81
+ */
82
+ readonly identifier: string;
83
+ /**
84
+ * Project-relative path when the template corresponds to a project file.
85
+ */
86
+ readonly relativeFilePath?: string;
87
+ /**
88
+ * Markdown content of the resolved template.
89
+ */
90
+ readonly content: string;
91
+ /**
92
+ * Prefix inserted into generated prompt file slugs.
93
+ */
94
+ readonly slugPrefix: string | null;
95
+ };
96
+ /**
97
+ * Lists the built-in coder boilerplate templates.
98
+ *
99
+ * @private internal utility of `ptbk coder`
100
+ */
101
+ export declare function getDefaultCoderPromptTemplateDefinitions(): ReadonlyArray<CoderPromptTemplateDefinition>;
102
+ /**
103
+ * Resolves one built-in coder boilerplate template definition by its stable identifier.
104
+ *
105
+ * @private internal utility of `ptbk coder`
106
+ */
107
+ export declare function getDefaultCoderPromptTemplateDefinition(template: BuiltInCoderPromptTemplate): CoderPromptTemplateDefinition;
108
+ /**
109
+ * Ensures the default project-owned coder template files exist without overwriting user customizations.
110
+ *
111
+ * @private internal utility of `ptbk coder`
112
+ */
113
+ export declare function ensureDefaultCoderPromptTemplateFiles(projectPath: string): Promise<ReadonlyArray<EnsuredCoderPromptTemplateFile>>;
114
+ /**
115
+ * Resolves the template requested by `coder generate-boilerplates`.
116
+ *
117
+ * Supports three modes:
118
+ * - omitted option => built-in `common`
119
+ * - built-in alias => one of the shared default templates
120
+ * - relative path => markdown template file resolved from the project root
121
+ *
122
+ * @private internal utility of `ptbk coder`
123
+ */
124
+ export declare function resolveCoderPromptTemplate({ projectPath, templateOption, }: {
125
+ readonly projectPath: string;
126
+ readonly templateOption?: string;
127
+ }): Promise<ResolvedCoderPromptTemplate>;
@@ -8,3 +8,13 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
8
8
  * @private internal function of `promptbookCli`
9
9
  */
10
10
  export declare function $initializeCoderGenerateBoilerplatesCommand(program: Program): $side_effect;
11
+ /**
12
+ * Generates boilerplate prompt files with unique emoji tags.
13
+ *
14
+ * @private internal function of `generatePromptBoilerplate` command
15
+ */
16
+ export declare function generatePromptBoilerplate({ projectPath, filesCount, templateOption, }: {
17
+ readonly projectPath: string;
18
+ readonly filesCount: number;
19
+ readonly templateOption?: string;
20
+ }): Promise<void>;
@@ -1,5 +1,24 @@
1
1
  import type { Command as Program } from 'commander';
2
2
  import type { $side_effect } from '../../../utils/organization/$side_effect';
3
+ import { type EnsuredCoderPromptTemplateFile, type InitializationStatus } from './boilerplateTemplates';
4
+ /**
5
+ * Generic JSON object used for standalone coder configuration files.
6
+ */
7
+ type JsonObject = Record<string, unknown>;
8
+ /**
9
+ * Result summary returned after coder configuration initialization.
10
+ */
11
+ type CoderInitializationSummary = {
12
+ readonly promptsDirectoryStatus: InitializationStatus;
13
+ readonly promptsDoneDirectoryStatus: InitializationStatus;
14
+ readonly promptsTemplatesDirectoryStatus: InitializationStatus;
15
+ readonly promptTemplateFileStatuses: ReadonlyArray<EnsuredCoderPromptTemplateFile>;
16
+ readonly envFileStatus: InitializationStatus;
17
+ readonly gitignoreFileStatus: InitializationStatus;
18
+ readonly packageJsonFileStatus: InitializationStatus;
19
+ readonly vscodeSettingsFileStatus: InitializationStatus;
20
+ readonly initializedEnvVariableNames: ReadonlyArray<string>;
21
+ };
3
22
  /**
4
23
  * Initializes `coder init` command for Promptbook CLI utilities.
5
24
  *
@@ -8,3 +27,22 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
8
27
  * @private internal function of `promptbookCli`
9
28
  */
10
29
  export declare function $initializeCoderInitCommand(program: Program): $side_effect;
30
+ /**
31
+ * Lists the default npm scripts initialized by `ptbk coder init`.
32
+ *
33
+ * @private internal utility of `coder init` command
34
+ */
35
+ export declare function getDefaultCoderPackageJsonScripts(): Readonly<Record<string, string>>;
36
+ /**
37
+ * Lists the default VS Code settings initialized by `ptbk coder init`.
38
+ *
39
+ * @private internal utility of `coder init` command
40
+ */
41
+ export declare function getDefaultCoderVscodeSettings(): Readonly<JsonObject>;
42
+ /**
43
+ * Creates or updates all coder configuration artifacts required in the current project.
44
+ *
45
+ * @private internal utility of `coder init` command
46
+ */
47
+ export declare function initializeCoderProjectConfiguration(projectPath: string): Promise<CoderInitializationSummary>;
48
+ export {};
@@ -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-34`).
18
+ * It follows semantic versioning (e.g., `0.112.0-35`).
19
19
  *
20
20
  * @generated
21
21
  */