@promptbook/remote-server 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
@@ -396,24 +396,6 @@ You can install all of them at once:
396
396
  npm i ptbk
397
397
  ```
398
398
 
399
- Promptbook also ships coding-agent CLI utilities through `ptbk coder`.
400
- For full `coder run` options and runner-specific examples, see [`scripts/run-codex-prompts/README.md`](./scripts/run-codex-prompts/README.md).
401
-
402
- #### `ptbk coder`
403
-
404
- Locally in this repository:
405
-
406
- ```bash
407
- npx ts-node ./src/cli/test/ptbk.ts coder run --dry-run
408
- ```
409
-
410
- In another project with `ptbk` installed:
411
-
412
- ```bash
413
- npm install ptbk
414
- npx ptbk coder run --dry-run
415
- ```
416
-
417
399
  Or you can install them separately:
418
400
 
419
401
  > ⭐ Marked packages are worth to try first
@@ -451,6 +433,121 @@ Or you can install them separately:
451
433
 
452
434
 
453
435
 
436
+ ### 🤖 Promptbook Coder
437
+
438
+ `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.
439
+
440
+ 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:
441
+
442
+ - prompt files with explicit statuses like `[ ]`, `[x]`, and `[-]`
443
+ - automatic selection of the next runnable task, including priority support
444
+ - optional shared repo context loaded from a file such as `AGENTS.md`
445
+ - automatic `git add`, commit, and push after each successful prompt
446
+ - dedicated coding-agent Git identity and optional GPG signing
447
+ - verification and repair flow for work that is done, partial, or broken
448
+ - helper commands for generating boilerplates and finding refactor prompts
449
+
450
+ 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.
451
+
452
+ #### How the workflow works
453
+
454
+ 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/`.
455
+ 2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
456
+ 3. You replace placeholder `@@@` sections with real coding tasks.
457
+ 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
458
+ 5. Promptbook Coder marks the prompt as done `[x]`, records runner metadata, then stages, commits, and pushes the resulting changes.
459
+ 6. `ptbk coder verify` reviews completed prompts, archives finished files to `prompts/done/`, and appends a repair prompt when more work is needed.
460
+
461
+ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority.
462
+
463
+ #### Features
464
+
465
+ - **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
466
+ - **Context injection:** `--context AGENTS.md` or inline extra instructions
467
+ - **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
468
+ - **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
469
+ - **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
470
+ - **Prompt triage:** `--priority` to process only more important tasks first
471
+ - **Failure logging:** failed runs write a neighboring `.error.log`
472
+ - **Line-ending normalization:** changed files are normalized back to LF by default
473
+
474
+ #### Local usage in this repository
475
+
476
+ When working on Promptbook itself, the repository usually runs the CLI straight from source:
477
+
478
+ ```bash
479
+ npx ts-node ./src/cli/test/ptbk.ts coder init
480
+
481
+ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/common.md
482
+
483
+ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
484
+
485
+ npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
486
+
487
+ 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
488
+
489
+ npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
490
+
491
+ npx ts-node ./src/cli/test/ptbk.ts coder verify
492
+ ```
493
+
494
+ #### Using `ptbk coder` in an external project
495
+
496
+ 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`.
497
+
498
+ ```bash
499
+ npm install ptbk
500
+
501
+ ptbk coder init
502
+
503
+ npx ptbk coder generate-boilerplates
504
+
505
+ npx ptbk coder generate-boilerplates --template prompts/templates/agents-server.md
506
+
507
+ npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
508
+
509
+ npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
510
+
511
+ npx ptbk coder find-refactor-candidates
512
+
513
+ npx ptbk coder verify
514
+ ```
515
+
516
+ `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/`.
517
+
518
+ #### What each command does
519
+
520
+ | Command | What it does |
521
+ | --- | --- |
522
+ | `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/`. |
523
+ | `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. |
524
+ | `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. |
525
+ | `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors. |
526
+ | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
527
+
528
+ #### Most useful `ptbk coder run` flags
529
+
530
+ | Flag | Purpose |
531
+ | --- | --- |
532
+ | `--agent <name>` | Selects the coding backend. |
533
+ | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
534
+ | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
535
+ | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
536
+ | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
537
+ | `--ignore-git-changes` | Disables the clean-working-tree guard. |
538
+ | `--priority <n>` | Runs only prompts at or above the given priority. |
539
+ | `--dry-run` | Prints which prompts are ready instead of executing them. |
540
+ | `--allow-credits` | Lets OpenAI Codex spend credits when required. |
541
+ | `--auto-migrate` | Runs testing-server database migrations after each successful prompt. |
542
+
543
+ #### Typical usage pattern
544
+
545
+ 1. Initialize once with `ptbk coder init`.
546
+ 2. Customize `prompts/templates/*.md` if needed, then create or write prompt files in `prompts/`.
547
+ 3. Put repository-specific instructions in `AGENTS.md`, then pass `--context AGENTS.md`.
548
+ 4. Run one prompt at a time interactively, or use `--no-wait` for unattended batches.
549
+ 5. Finish with `ptbk coder verify` so resolved prompts are archived and broken ones get explicit repair follow-ups.
550
+
454
551
 
455
552
 
456
553
 
package/esm/index.es.js CHANGED
@@ -40,7 +40,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
40
40
  * @generated
41
41
  * @see https://github.com/webgptorg/promptbook
42
42
  */
43
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-35';
43
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-36';
44
44
  /**
45
45
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
46
46
  * 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/remote-server",
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/remote-server.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
  "@mozilla/readability": "0.6.0",
package/umd/index.umd.js CHANGED
@@ -50,7 +50,7 @@
50
50
  * @generated
51
51
  * @see https://github.com/webgptorg/promptbook
52
52
  */
53
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-35';
53
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-36';
54
54
  /**
55
55
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
56
56
  * 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
  */