@promptbook/cli 0.112.0-22 → 0.112.0-23

package/esm/index.es.js

@@ -5,9 +5,9 @@ import * as fs from 'fs';
 import { writeFileSync, readFileSync, existsSync } from 'fs';
 import * as path from 'path';
 import { join, basename, dirname, isAbsolute, relative, extname, resolve } from 'path';
+import { mkdir, readFile, writeFile, stat, access, constants, readdir, watch, unlink, rm, rename, rmdir } from 'fs/promises';
 import { forTime, forEver } from 'waitasecond';
 import prompts from 'prompts';
-import { stat, access, constants, readFile, writeFile, readdir, mkdir, watch, unlink, rm, rename, rmdir } from 'fs/promises';
 import * as dotenv from 'dotenv';
 import hexEncoder from 'crypto-js/enc-hex';
 import sha256 from 'crypto-js/sha256';
@@ -57,7 +57,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-22';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-23';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1827,6 +1827,205 @@ function buildPromptSlug$1(template, title) {
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */
 
+/**
+ * Relative path to the root prompts directory used by Promptbook coder utilities.
+ */
+const PROMPTS_DIRECTORY_PATH = 'prompts';
+/**
+ * Relative path to the archive directory used by `coder verify`.
+ */
+const PROMPTS_DONE_DIRECTORY_PATH = join(PROMPTS_DIRECTORY_PATH, 'done');
+/**
+ * Required environment variables for coding-agent git identity.
+ */
+const REQUIRED_CODER_ENV_VARIABLES = [
+    {
+        name: 'CODING_AGENT_GIT_NAME',
+        value: 'Promptbook Coding Agent',
+    },
+    {
+        name: 'CODING_AGENT_GIT_EMAIL',
+        value: 'coding-agent@promptbook.studio',
+    },
+    {
+        name: 'CODING_AGENT_GIT_SIGNING_KEY',
+        value: '13406525ED912F938FEA85AB4046C687298B2382',
+    },
+];
+/**
+ * Initializes `coder init` command for Promptbook CLI utilities.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
+ *
+ * @private internal function of `promptbookCli`
+ */
+function $initializeCoderInitCommand(program) {
+    const command = program.command('init');
+    command.alias('initialize');
+    command.description(spaceTrim$1(`
+            Initialize Promptbook coder configuration for current project
+
+            Creates:
+            - prompts/
+            - prompts/done/
+
+            Ensures required coding-agent environment variables in .env:
+            - CODING_AGENT_GIT_NAME
+            - CODING_AGENT_GIT_EMAIL
+            - CODING_AGENT_GIT_SIGNING_KEY
+        `));
+    command.action(handleActionErrors(async () => {
+        const summary = await initializeCoderProjectConfiguration(process.cwd());
+        printInitializationSummary(summary);
+    }));
+}
+/**
+ * Creates or updates all coder configuration artifacts required in the current project.
+ */
+async function initializeCoderProjectConfiguration(projectPath) {
+    const promptsDirectoryStatus = await ensureDirectory(projectPath, PROMPTS_DIRECTORY_PATH);
+    const promptsDoneDirectoryStatus = await ensureDirectory(projectPath, PROMPTS_DONE_DIRECTORY_PATH);
+    const { envFileStatus, initializedEnvVariableNames } = await ensureCoderEnvFile(projectPath);
+    return {
+        promptsDirectoryStatus,
+        promptsDoneDirectoryStatus,
+        envFileStatus,
+        initializedEnvVariableNames,
+    };
+}
+/**
+ * Ensures a relative directory exists in the project root.
+ */
+async function ensureDirectory(projectPath, relativeDirectoryPath) {
+    const directoryPath = join(projectPath, relativeDirectoryPath);
+    const existedBefore = await isExistingDirectory(directoryPath);
+    if (!existedBefore) {
+        await mkdir(directoryPath, { recursive: true });
+        return 'created';
+    }
+    return 'unchanged';
+}
+/**
+ * Ensures `.env` exists and contains all required coder environment variables.
+ */
+async function ensureCoderEnvFile(projectPath) {
+    const envFilePath = join(projectPath, '.env');
+    const envFileExistedBefore = await isExistingFile(envFilePath);
+    const currentEnvContent = envFileExistedBefore ? await readFile(envFilePath, 'utf-8') : '';
+    const existingEnvVariables = parseEnvVariableNames(currentEnvContent);
+    const missingEnvVariables = REQUIRED_CODER_ENV_VARIABLES.filter(({ name }) => !existingEnvVariables.has(name));
+    if (missingEnvVariables.length === 0) {
+        if (!envFileExistedBefore) {
+            await writeFile(envFilePath, '# Environment variables for Promptbook coder\n', 'utf-8');
+            return {
+                envFileStatus: 'created',
+                initializedEnvVariableNames: [],
+            };
+        }
+        return {
+            envFileStatus: 'unchanged',
+            initializedEnvVariableNames: [],
+        };
+    }
+    const envBlockToAppend = buildMissingEnvVariablesBlock(missingEnvVariables);
+    const nextEnvContent = appendBlock(currentEnvContent, envBlockToAppend);
+    await writeFile(envFilePath, nextEnvContent, 'utf-8');
+    return {
+        envFileStatus: envFileExistedBefore ? 'updated' : 'created',
+        initializedEnvVariableNames: missingEnvVariables.map(({ name }) => name),
+    };
+}
+/**
+ * Parses variable names currently defined in `.env` style content.
+ */
+function parseEnvVariableNames(envContent) {
+    const variableNames = new Set();
+    for (const line of envContent.split(/\r?\n/)) {
+        const trimmedLine = line.trim();
+        if (trimmedLine === '' || trimmedLine.startsWith('#')) {
+            continue;
+        }
+        const match = trimmedLine.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+        if (!match || !match[1]) {
+            continue;
+        }
+        variableNames.add(match[1]);
+    }
+    return variableNames;
+}
+/**
+ * Builds a `.env` block containing missing coder environment variables.
+ */
+function buildMissingEnvVariablesBlock(variables) {
+    return spaceTrim$1(`
+        # Promptbook coder identity (initialized by \`ptbk coder init\`)
+        ${variables.map(({ name, value }) => `${name}=${JSON.stringify(value)}`).join('\n')}
+    `);
+}
+/**
+ * Appends one text block to existing file content while preserving readable newlines.
+ */
+function appendBlock(currentContent, blockToAppend) {
+    if (currentContent.trim() === '') {
+        return `${blockToAppend}\n`;
+    }
+    const normalizedCurrentContent = currentContent.endsWith('\n') ? currentContent : `${currentContent}\n`;
+    return `${normalizedCurrentContent}\n${blockToAppend}\n`;
+}
+/**
+ * Prints a readable summary of what was initialized for the user.
+ */
+function printInitializationSummary(summary) {
+    console.info(colors.green('Promptbook coder configuration initialized.'));
+    console.info(colors.gray(`- prompts/: ${formatInitializationStatus(summary.promptsDirectoryStatus)}`));
+    console.info(colors.gray(`- prompts/done/: ${formatInitializationStatus(summary.promptsDoneDirectoryStatus)}`));
+    console.info(colors.gray(`- .env: ${formatInitializationStatus(summary.envFileStatus)}`));
+    if (summary.initializedEnvVariableNames.length > 0) {
+        console.info(colors.cyan(`- Added env variables: ${summary.initializedEnvVariableNames.join(', ')}`));
+    }
+    else {
+        console.info(colors.gray('- Required coder env variables are already present.'));
+    }
+}
+/**
+ * Formats one initialization status into a human-readable label.
+ */
+function formatInitializationStatus(status) {
+    if (status === 'created') {
+        return 'created';
+    }
+    if (status === 'updated') {
+        return 'updated';
+    }
+    return 'unchanged';
+}
+/**
+ * Checks whether a path exists and is a file.
+ */
+async function isExistingFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Checks whether a path exists and is a directory.
+ */
+async function isExistingDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */
+
 /**
  * Initializes `coder run` command for Promptbook CLI utilities
  *
@@ -1976,6 +2175,7 @@ function $initializeCoderVerifyCommand(program) {
  * Initializes `coder` command with subcommands for Promptbook CLI utilities
  *
  * The coder command provides utilities for automated coding:
+ * - init: Initialize coder configuration in current project
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
  * - run: Run coding prompts with AI agents
@@ -1992,6 +2192,7 @@ function $initializeCoderCommand(program) {
             Coding utilities for automated development workflows
 
             Subcommands:
+            - init: Initialize coder configuration in current project
             - generate-boilerplates: Generate prompt boilerplate files
             - find-refactor-candidates: Find files that need refactoring
             - run: Run coding prompts with AI agents
@@ -1999,6 +2200,7 @@ function $initializeCoderCommand(program) {
             - find-fresh-emoji-tags: Find unused emoji tags
         `));
     // Register all subcommands
+    $initializeCoderInitCommand(coderCommand);
     $initializeCoderGenerateBoilerplatesCommand(coderCommand);
     $initializeCoderFindRefactorCandidatesCommand(coderCommand);
     $initializeCoderRunCommand(coderCommand);
@@ -31208,6 +31410,28 @@ async function promptbookCli() {
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */
 
+/**
+ * Tracks whether CLI runtime registrations were already initialized in this process.
+ *
+ * @private internal utility of Promptbook CLI bootstrap
+ */
+let isCliRuntimeRegistered = false;
+/**
+ * Shared bootstrap for Promptbook CLI used by both local `ts-node` and packaged `npx` entrypoints.
+ *
+ * @private internal utility of Promptbook CLI bootstrap
+ */
+async function $runPromptbookCli() {
+    if (!isCliRuntimeRegistered) {
+        await Promise.resolve().then(function () { return cli_index; });
+        isCliRuntimeRegistered = true;
+    }
+    await promptbookCli();
+}
+/**
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */
+
 /**
  * Note: [🔺] Purpose of this file is to export CLI for production environment
  */
@@ -31218,7 +31442,7 @@ async function promptbookCli() {
  */
 const _CLI = {
     // Note: [🥠]
-    _initialize_promptbookCli: promptbookCli,
+    _initialize_promptbookCli: $runPromptbookCli,
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -39908,6 +40132,47 @@ const _OpenAiSdkTranspilerRegistration = $bookTranspilersRegister.register(OpenA
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+// ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
+
+var cli_index = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    BOOK_LANGUAGE_VERSION: BOOK_LANGUAGE_VERSION,
+    PROMPTBOOK_ENGINE_VERSION: PROMPTBOOK_ENGINE_VERSION,
+    _CLI: _CLI,
+    _AnthropicClaudeMetadataRegistration: _AnthropicClaudeMetadataRegistration,
+    _AnthropicClaudeRegistration: _AnthropicClaudeRegistration,
+    _AzureOpenAiMetadataRegistration: _AzureOpenAiMetadataRegistration,
+    _AzureOpenAiRegistration: _AzureOpenAiRegistration,
+    _DeepseekMetadataRegistration: _DeepseekMetadataRegistration,
+    _DeepseekRegistration: _DeepseekRegistration,
+    _GoogleMetadataRegistration: _GoogleMetadataRegistration,
+    _GoogleRegistration: _GoogleRegistration,
+    _OllamaMetadataRegistration: _OllamaMetadataRegistration,
+    _OllamaRegistration: _OllamaRegistration,
+    _OpenAiMetadataRegistration: _OpenAiMetadataRegistration,
+    _OpenAiAssistantMetadataRegistration: _OpenAiAssistantMetadataRegistration,
+    _OpenAiCompatibleMetadataRegistration: _OpenAiCompatibleMetadataRegistration,
+    _OpenAiRegistration: _OpenAiRegistration,
+    _OpenAiAssistantRegistration: _OpenAiAssistantRegistration,
+    _OpenAiCompatibleRegistration: _OpenAiCompatibleRegistration,
+    _BoilerplateScraperRegistration: _BoilerplateScraperRegistration,
+    _BoilerplateScraperMetadataRegistration: _BoilerplateScraperMetadataRegistration,
+    _LegacyDocumentScraperRegistration: _LegacyDocumentScraperRegistration,
+    _LegacyDocumentScraperMetadataRegistration: _LegacyDocumentScraperMetadataRegistration,
+    _DocumentScraperRegistration: _DocumentScraperRegistration,
+    _DocumentScraperMetadataRegistration: _DocumentScraperMetadataRegistration,
+    _MarkdownScraperRegistration: _MarkdownScraperRegistration,
+    _MarkdownScraperMetadataRegistration: _MarkdownScraperMetadataRegistration,
+    _MarkitdownScraperRegistration: _MarkitdownScraperRegistration,
+    _MarkitdownScraperMetadataRegistration: _MarkitdownScraperMetadataRegistration,
+    _PdfScraperRegistration: _PdfScraperRegistration,
+    _PdfScraperMetadataRegistration: _PdfScraperMetadataRegistration,
+    _WebsiteScraperRegistration: _WebsiteScraperRegistration,
+    _WebsiteScraperMetadataRegistration: _WebsiteScraperMetadataRegistration,
+    _FormattedBookInMarkdownTranspilerRegistration: _FormattedBookInMarkdownTranspilerRegistration,
+    _OpenAiSdkTranspilerRegistration: _OpenAiSdkTranspilerRegistration
+});
+
 /**
  * Shuffles an array of items randomly and returns a new array
  *