@promptbook/cli 0.114.0-0 → 0.114.0-2

package/src/book-2.0/book-language-documentation/czechBookLanguageManualDictionary.ts

@@ -19,9 +19,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
     metadataLabels: {
         bookLanguageVersion: 'Verze jazyka Book',
         generatedAt: 'Vygenerováno',
-        commitmentGroups: 'Skupin commitmentů',
-        implementedCommitments: 'Hotových commitmentů',
-        placeholderCommitments: 'Připravovaných commitmentů',
+        commitmentCount: 'Počet commitmentů',
     },
     tableOfContentsTitle: 'Obsah',
     chapters: {
@@ -83,15 +81,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
         commitmentCatalog: {
             title: 'Katalog commitmentů',
             body: spaceTrim(`
-                Tato kapitola se generuje z definic commitmentů v \`src/commitments\`.
-                U každé skupiny commitmentů najdete:
-
-                - shrnutí významu (popis, ikona, stav)
-                - schéma pro parsování (\`createTypeRegex\` a \`createRegex\`)
-                - úplnou dokumentaci
-
-                Klíčová slova commitmentů jsou součástí syntaxe, a proto zůstávají anglicky.
-                Anglicky zůstávají i jejich referenční popisy, které jsou závaznou specifikací jazyka.
+                Každá sekce commitmentu vysvětluje jeho účel, důležité podrobnosti a ukazuje soustředěný příklad.
             `),
         },
         examples: {
@@ -178,41 +168,28 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 První neprázdný řádek, který není klíčovým slovem commitmentu.
                 2. **Blok commitmentu**:
                 Začíná klíčovým slovem commitmentu a pokračuje až k dalšímu commitmentu nebo oddělovači.
-                3. **Vodorovný oddělovač**:
-                Řádky jako \`---\` dělí zdroj na části; v Agents Serveru jimi lze oddělit agenty vložené přímo v knize.
+                3. **Více agentů**:
+                Řádky jako \`---\` oddělují agenty definované ve stejném zdroji Booku.
                 4. **Bloky kódu**:
-                Uvnitř obsahu commitmentu zůstávají zachované; hodí se pro ukázky a instrukce.
-                5. **Parametry**:
-                Podporovaný a rozpoznávaný je zápis \`@parametr\` i \`{parametr}\`.
+                Začínají a končí pomocí <code>\`\`\`</code>; jejich obsah zůstává uvnitř commitmentu zachovaný a hodí se pro ukázky a instrukce.
             `),
         },
         references: {
             title: 'Odkazy a zástupní agenti',
             body: spaceTrim(`
-                - Zkrácené odkazy jako \`{Jméno agenta}\` vyhodnocuje resolver odkazů v Agents Serveru.
+                - \`@Foo\` a \`{Foo foo}\` odkazují na jiného agenta; nejde o zápis parametrů.
+                - Zkrácené odkazy jako \`@Jméno agenta\` a \`{Jméno agenta}\` vyhodnocuje resolver odkazů v Agents Serveru.
                 - V příslušných commitmentech lze použít i zástupné agenty (například \`{User}\` nebo \`{Void}\`).
                 - \`{User}\` je určený pro \`TEAM\`; \`{Void}\` se hodí pro výslovné zrušení dědičnosti.
             `),
         },
-        keywordsTitle: 'Aktuálně rozpoznávaná klíčová slova commitmentů',
     },
     commitmentCatalogTitleSuffixes: {
         usedFirst: ' (nejdřív používané commitmenty)',
         all: ' (všechny commitmenty)',
     },
     commitmentLabels: {
-        status: 'Stav',
         aliases: 'Varianty zápisu',
-        semantics: 'Význam',
-        typeSchema: 'Schéma klíčového slova',
-        blockSchema: 'Schéma bloku',
-        lowLevelNotice: 'Nízkoúrovňový commitment',
-        usage: 'Použití u vybraných agentů',
-        usageOccurrence: 'výskyt',
-        usageOccurrences: 'výskytů',
-        statusImplemented: 'Hotovo',
-        statusPlaceholder: 'Připravuje se (zatím není plně hotové)',
-        noAliases: 'Žádné',
     },
     exampleLabels: {
         commitmentsUsed: 'Použité commitmenty',
@@ -262,14 +239,14 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 'Hodí se pro asistenty, kteří si musí držet kontext v čase.',
             ],
         },
-        'use-project-and-wallet-integration-agent': {
-            title: 'Napojení na projekt (USE PROJECT) a peněženku',
-            goal: 'Pracovat s repozitáři na GitHubu a s přihlašovacími údaji z peněženky.',
+        'use-project-integration-agent': {
+            title: 'Napojení na projekt (USE PROJECT)',
+            goal: 'Pracovat s repozitářem na GitHubu přes připojení projektu.',
             walkthrough: [
                 '`USE PROJECT` zapne nástroje pro výpis, čtení a úpravy souborů a pro zakládání pull requestů.',
                 'Přihlašovací údaje se v Agents Serveru za běhu načtou ze záznamů v peněžence.',
-                '`WALLET` je zde ponechaný jen kvůli zpětné kompatibilitě, aktuální parsování Book 2.0 ho ignoruje.',
-                'V současném chování zajišťují napojení s přihlašovacími údaji commitmenty jako `USE PROJECT` a `USE EMAIL`.',
+                'Agent má také výslovná pravidla pro bezpečné úpravy a práci s přihlašovacími údaji.',
+                'Tento vzor použijte, když agent potřebuje soustředěný přístup k repozitáři.',
             ],
         },
         'use-calendar-integration-agent': {
@@ -340,10 +317,10 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
     footer: {
         title: 'Vygenerováno z:',
         body: spaceTrim(`
-            - Registru commitmentů a běhové dokumentace v \`src/commitments\`
-            - Chování parseru a překladače v \`src/book-2.0/agent-source\`
-            - Vyhodnocení odkazů a dědičnosti v Agents Serveru v \`apps/agents-server/src/utils\`
-            - Zdrojových bloků samostatné dokumentace v \`apps/agents-server/src/utils/bookLanguageDocumentation\`
+            - [Registru commitmentů a běhové dokumentace](https://github.com/webgptorg/promptbook/tree/main/src/commitments)
+            - [Parseru jazyka Book a práce se zdrojem](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/agent-source)
+            - [Vyhodnocení odkazů a dědičnosti v Agents Serveru](https://github.com/webgptorg/promptbook/tree/main/apps/agents-server/src/utils)
+            - [Zdrojových kódů samostatné příručky](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/book-language-documentation)
         `),
     },
 };

package/src/book-2.0/book-language-documentation/englishBookLanguageManualDictionary.ts

@@ -19,9 +19,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
     metadataLabels: {
         bookLanguageVersion: 'Book language version',
         generatedAt: 'Generated at',
-        commitmentGroups: 'Commitment groups',
-        implementedCommitments: 'Implemented commitments',
-        placeholderCommitments: 'Placeholder commitments',
+        commitmentCount: 'Number of commitments',
     },
     tableOfContentsTitle: 'Table of Contents',
     chapters: {
@@ -83,12 +81,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
         commitmentCatalog: {
             title: 'Commitment catalog',
             body: spaceTrim(`
-                This section is generated from commitment definitions in \`src/commitments\`.
-                For each commitment group you get:
-
-                - semantics summary (description/icon/status)
-                - parsing schema (\`createTypeRegex\` and \`createRegex\`)
-                - canonical documentation block
+                Each commitment section explains its purpose, important details, and a focused example.
             `),
         },
         examples: {
@@ -175,41 +168,28 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 First non-empty line that is not a commitment keyword.
                 2. **Commitment block**:
                 Starts with a commitment keyword and continues until the next commitment block or separator.
-                3. **Horizontal separator**:
-                Lines like \`---\` split sections; in Agents Server they can delimit embedded in-book agents.
+                3. **Multiple agent**:
+                Lines like \`---\` separate agents defined in the same Book source.
                 4. **Code fences**:
-                Preserved inside commitment content; useful for examples/instructions.
-                5. **Parameters**:
-                Both \`@parameter\` and \`{parameter}\` notations are supported and parsed.
+                Start and end with <code>\`\`\`</code>; their content is preserved inside commitments and is useful for examples and instructions.
             `),
         },
         references: {
             title: 'Reference tokens and pseudo-agents',
             body: spaceTrim(`
-                - Compact references like \`{Agent Name}\` are resolved by Agents Server reference resolver.
+                - \`@Foo\` and \`{Foo foo}\` reference another agent; they are not parameter notation.
+                - Compact references like \`@Agent Name\` and \`{Agent Name}\` are resolved by the Agents Server reference resolver.
                 - Pseudo-agent forms (for example \`{User}\`, \`{Void}\`) are supported in relevant commitments.
                 - \`{User}\` is intended for \`TEAM\`; \`{Void}\` is useful for explicit no-parent inheritance.
             `),
         },
-        keywordsTitle: 'Commitment keywords currently recognized',
     },
     commitmentCatalogTitleSuffixes: {
         usedFirst: ' (used commitments first)',
         all: ' (all commitments)',
     },
     commitmentLabels: {
-        status: 'Status',
         aliases: 'Aliases',
-        semantics: 'Semantics',
-        typeSchema: 'Type schema',
-        blockSchema: 'Block schema',
-        lowLevelNotice: 'Low-level commitment',
-        usage: 'Used in selected agents',
-        usageOccurrence: 'occurrence',
-        usageOccurrences: 'occurrences',
-        statusImplemented: 'Implemented',
-        statusPlaceholder: 'Placeholder (not fully implemented)',
-        noAliases: 'None',
     },
     exampleLabels: {
         commitmentsUsed: 'Commitments used',
@@ -259,14 +239,14 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 'Use this for assistants that must preserve context over time.',
             ],
         },
-        'use-project-and-wallet-integration-agent': {
-            title: 'USE PROJECT and WALLET external integration',
-            goal: 'Work with GitHub repositories and wallet-backed credentials.',
+        'use-project-integration-agent': {
+            title: 'USE PROJECT external integration',
+            goal: 'Work with a GitHub repository through a connected project integration.',
             walkthrough: [
                 '`USE PROJECT` enables repository tools for listing, reading, editing files, and creating PRs.',
                 'Credentials are resolved from wallet records at runtime in Agents Server.',
-                '`WALLET` is kept here as a compatibility marker, but current Book 2.0 parsing treats it as ignored.',
-                'In current runtime behavior, wallet-backed integrations are driven by commitments such as `USE PROJECT` and `USE EMAIL`.',
+                'The agent also defines explicit rules for safe editing and credential handling.',
+                'Use this pattern when an agent needs focused repository access.',
             ],
         },
         'use-calendar-integration-agent': {
@@ -337,10 +317,10 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
     footer: {
         title: 'Generated from:',
         body: spaceTrim(`
-            - Commitments registry and runtime docs in \`src/commitments\`
-            - Parser/compiler behavior in \`src/book-2.0/agent-source\`
-            - Agents Server reference/inheritance resolution in \`apps/agents-server/src/utils\`
-            - Standalone docs source blocks in \`apps/agents-server/src/utils/bookLanguageDocumentation\`
+            - [Commitments registry and runtime documentation](https://github.com/webgptorg/promptbook/tree/main/src/commitments)
+            - [Book language parser and source handling](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/agent-source)
+            - [Agents Server reference and inheritance resolution](https://github.com/webgptorg/promptbook/tree/main/apps/agents-server/src/utils)
+            - [Standalone manual source](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/book-language-documentation)
         `),
     },
 };

package/src/book-2.0/book-language-documentation/getBookLanguageManualCommitmentGroups.ts

@@ -3,6 +3,7 @@ import {
     isLowVisibilityCommitmentNotice,
 } from '../../commitments/_common/getCommitmentNoticeMetadata';
 import { getGroupedCommitmentDefinitions } from '../../commitments/_common/getGroupedCommitmentDefinitions';
+import { NotYetImplementedCommitmentDefinition } from '../../commitments/_base/NotYetImplementedCommitmentDefinition';
 
 /**
  * One grouped commitment definition as returned by the runtime registry.
@@ -23,7 +24,7 @@ export type BookLanguageManualCommitmentGroups = {
     readonly documented: ReadonlyArray<BookLanguageManualCommitmentGroup>;
 
     /**
-     * Low-level and unfinished commitments documented in their own closing chapter.
+     * Low-level commitments documented in their own closing chapter.
      */
     readonly lowLevel: ReadonlyArray<BookLanguageManualCommitmentGroup>;
 };
@@ -49,6 +50,13 @@ export function getBookLanguageManualCommitmentGroups(): BookLanguageManualCommi
             continue;
         }
 
+        if (
+            groupedCommitment.primary instanceof NotYetImplementedCommitmentDefinition ||
+            groupedCommitment.primary.isUnfinished
+        ) {
+            continue;
+        }
+
         if (isLowVisibilityCommitmentNotice(notice)) {
             lowLevel.push(groupedCommitment);
             continue;

package/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.ts

@@ -1,9 +1,4 @@
 import { spaceTrim } from 'spacetrim';
-import { NotYetImplementedCommitmentDefinition } from '../../commitments/_base/NotYetImplementedCommitmentDefinition';
-import {
-    formatCommitmentReplacementText,
-    getCommitmentNoticeMetadata,
-} from '../../commitments/_common/getCommitmentNoticeMetadata';
 import type { BookLanguageManualDictionary } from './BookLanguageManualDictionary';
 import type { BookLanguageManualCommitmentGroup } from './getBookLanguageManualCommitmentGroups';
 import { renderGroupedCommitmentDocumentationMarkdown } from './renderGroupedCommitmentDocumentationMarkdown';
@@ -30,11 +25,6 @@ export type RenderCommitmentCatalogSectionOptions = {
      */
     readonly groupedCommitment: BookLanguageManualCommitmentGroup;
 
-    /**
-     * Number of uses across the selected server agents.
-     */
-    readonly usageCount: number;
-
     /**
      * Translated labels of the manual.
      */
@@ -50,42 +40,17 @@ export type RenderCommitmentCatalogSectionOptions = {
  * @private internal utility of `createStandaloneBookLanguageMarkdown`
  */
 export function renderCommitmentCatalogSection(options: RenderCommitmentCatalogSectionOptions): string {
-    const { groupedCommitment, usageCount, dictionary } = options;
+    const { groupedCommitment, dictionary } = options;
     const { primary, aliases } = groupedCommitment;
     const labels = dictionary.commitmentLabels;
-    const notice = getCommitmentNoticeMetadata(primary);
-    const status =
-        primary instanceof NotYetImplementedCommitmentDefinition
-            ? labels.statusPlaceholder
-            : notice
-            ? `${labels.statusImplemented} (${notice.detailLabel})`
-            : labels.statusImplemented;
-    const aliasText = aliases.length === 0 ? labels.noAliases : aliases.map((alias) => `\`${alias}\``).join(', ');
-    const noticeText = notice
-        ? notice.kind === 'deprecated'
-            ? `- **${notice.detailLabel}:** ${notice.message}${formatCommitmentReplacementText(
-                  primary.deprecation?.replacedBy,
-              )}`
-            : `- **${labels.lowLevelNotice}:** ${notice.message}`
-        : '';
-    const usageMarkdown =
-        usageCount > 0
-            ? `- **${labels.usage}:** ${usageCount} ${
-                  usageCount === 1 ? labels.usageOccurrence : labels.usageOccurrences
-              }`
-            : '';
+    const aliasesMarkdown =
+        aliases.length === 0 ? '' : `- **${labels.aliases}:** ${aliases.map((alias) => `\`${alias}\``).join(', ')}`;
 
     return spaceTrim(
         (block) => `
             ### <a id="commitment-${toStableAnchorId(primary.type)}"></a>${primary.icon} ${primary.type}
 
-            - **${labels.status}:** ${status}
-            - **${labels.aliases}:** ${aliasText}
-            - **${labels.semantics}:** ${primary.description}
-            - **${labels.typeSchema} (\`createTypeRegex\`):** \`${stringifyRegex(primary.createTypeRegex())}\`
-            - **${labels.blockSchema} (\`createRegex\`):** \`${stringifyRegex(primary.createRegex())}\`
-            ${noticeText}
-            ${usageMarkdown}
+            ${aliasesMarkdown}
 
             ${block(
                 renderGroupedCommitmentDocumentationMarkdown(
@@ -96,15 +61,3 @@ export function renderCommitmentCatalogSection(options: RenderCommitmentCatalogS
         `,
     );
 }
-
-/**
- * Converts a regular expression into a concise literal-like string.
- *
- * @param regex - Regex instance.
- * @returns Printable regex pattern and flags.
- *
- * @private internal utility of `renderCommitmentCatalogSection`
- */
-function stringifyRegex(regex: RegExp): string {
-    return `/${regex.source}/${regex.flags}`;
-}