ptbk 0.119.0-16 → 0.119.0-21

package/dist/book/parse.js

@@ -1,15 +1,36 @@
 import { matchCommitmentKeyword } from './commitments.js';
 /**
  * Detects a fence opener/closer (``` or ~~~).
+ *
+ * @private Book language
  */
-function fenceMarker(line) {
+export function fenceMarker(line) {
     const match = /^\s{0,3}(`{3,}|~{3,})/.exec(line);
     return match?.[1];
 }
 /**
- * Reads a Book source: identifies the document kind and its commitments.
+ * Entity kinds by declaration keyword (and former ENTITY value).
+ */
+const KIND_BY_KEYWORD = { AGENT: 'agent', TASK: 'task', CHAT: 'chat' };
+/**
+ * Removes the literal escape (one leading backslash) of a content line outside fenced blocks.
+ */
+function unescapeLine(line) {
+    return line.startsWith('\\') ? line.slice(1) : line;
+}
+/**
+ * Human label of a commitment scope.
+ */
+function scopeLabel(scope) {
+    return scope === 'agent' ? 'an agent' : scope === 'task' ? 'a task' : scope === 'chat' ? 'a chat' : 'an agent/task';
+}
+/**
+ * Reads a Book: the opening `AGENT <name>`, `TASK <name>` or `CHAT <name>` declaration and the commitments after it.
  *
- * Fenced literal content is preserved as text and never interpreted as commitments.
+ * One grammar for every kind: a commitment starts at column zero with a complete uppercase keyword (at least three
+ * letters); its content continues until the next commitment. The location of the file never supplies the kind. Fenced
+ * blocks and lines escaped with a leading backslash are literal content. Former syntax (a plain name line, `ENTITY`,
+ * an introduction under the name) is diagnosed and recorded for explicit conversion, never silently accepted.
  *
  * @private Book language
  */
@@ -19,45 +40,23 @@ export function parseBook(source) {
     const lines = text.split(/\r?\n/);
     const diagnostics = [];
     const headerLine = lines.findIndex((line) => line.trim() !== '');
-    if (headerLine < 0) {
-        return { kind: 'empty', name: '', headerLine: -1, intro: '', commitments: [], diagnostics, lines, newline };
-    }
-    const header = lines[headerLine].trim();
-    let kind;
-    let name;
-    const headerMatch = matchCommitmentKeyword(header);
-    if (headerMatch && headerMatch.definition.keyword === 'TASK') {
-        kind = 'task';
-        name = headerMatch.content;
-        if (!name) {
-            kind = 'invalid';
-            diagnostics.push({ line: headerLine + 1, message: 'A task needs a nonempty title after `TASK`.', severity: 'error' });
-        }
-    }
-    else if (headerMatch && headerMatch.definition.scope !== 'agent' && headerMatch.definition.keyword.startsWith('TASK')) {
-        kind = 'invalid';
-        name = '';
-        diagnostics.push({ line: headerLine + 1, message: `\`${headerMatch.written}\` cannot start a Book; a task starts with \`TASK <title>\`.`, severity: 'error' });
-    }
-    else {
-        kind = 'agent';
-        name = header;
-    }
+    if (headerLine < 0)
+        return { kind: 'empty', name: '', headerLine: -1, commitments: [], diagnostics, lines, newline };
+    // Commitments after the opening line (fenced and escaped lines are content).
     const commitments = [];
-    const introLines = [];
+    const introduction = [];
     let current;
     let fence;
     const close = (end) => {
         if (!current)
             return;
         const continuation = current.continuation.join('\n').trim();
-        const body = [current.match.content, ...current.continuation].join('\n').trim();
         commitments.push({
             keyword: current.match.definition.keyword,
             written: current.match.written,
             definition: current.match.definition,
             value: current.match.content,
-            body,
+            body: [current.match.content, ...current.continuation].join('\n').trim(),
             continuation,
             startLine: current.start,
             endLine: end,
@@ -67,6 +66,7 @@ export function parseBook(source) {
     for (let index = headerLine + 1; index < lines.length; index++) {
         const line = lines[index];
         const marker = fenceMarker(line);
+        let content = line;
         if (fence) {
             if (marker && marker[0] === fence[0] && marker.length >= fence.length && line.trim() === marker)
                 fence = undefined;
@@ -79,34 +79,121 @@ export function parseBook(source) {
             if (match) {
                 close(index);
                 current = { match, start: index, continuation: [] };
-                if (match.definition.keyword === 'TASK') {
-                    diagnostics.push({
-                        line: index + 1,
-                        message: 'A later `TASK` line does not declare another task; only the first nonempty line identifies the document.',
-                        severity: 'warning',
-                    });
-                }
                 continue;
             }
+            content = unescapeLine(line);
         }
         if (current)
-            current.continuation.push(line);
+            current.continuation.push(content);
         else
-            introLines.push(line);
+            introduction.push(index);
     }
     close(lines.length);
     if (fence)
         diagnostics.push({ line: lines.length, message: 'An unterminated fenced block runs to the end of the document.', severity: 'warning' });
+    // The opening declaration.
+    const header = lines[headerLine];
+    const opening = matchCommitmentKeyword(header);
+    let declaredKind;
+    let name = '';
+    let plainHeader = false;
+    let uppercaseName = false;
+    if (opening?.definition.kind === 'declaration') {
+        declaredKind = KIND_BY_KEYWORD[opening.definition.keyword];
+        name = opening.content;
+        if (!name)
+            diagnostics.push({ line: headerLine + 1, message: `\`${opening.written}\` needs the entity's name on the same line, e.g. \`${opening.written} Improve CSV export\`.`, severity: 'error' });
+    }
+    else if (opening?.definition.unknown && /^(AGENT|TASK|CHAT) /.test(opening.written)) {
+        // `TASK API cleanup`: the name's first word joins the keyword under the boundary rule.
+        const [keyword, ...rest] = opening.written.split(/\s+/);
+        name = [...rest, opening.content].filter(Boolean).join(' ');
+        uppercaseName = true;
+        diagnostics.push({
+            line: headerLine + 1,
+            message: `\`${opening.written}\` is not a declaration: the name's first word must not be all uppercase (for example \`${keyword} ${rest[0][0]}${rest[0].slice(1).toLowerCase()}${name.slice(rest[0].length)}\`).`,
+            severity: 'error',
+        });
+    }
+    else if (opening && !opening.definition.unknown) {
+        diagnostics.push({ line: headerLine + 1, message: `A Book must start with \`AGENT <name>\`, \`TASK <name>\` or \`CHAT <name>\`, not \`${opening.written}\`.`, severity: 'error' });
+    }
+    else {
+        // A plain first line: the former unprefixed name header (an all-uppercase name reads as an unknown keyword).
+        plainHeader = true;
+        uppercaseName = Boolean(opening);
+        name = header.trim();
+    }
+    if (/^\s/.test(header) && !plainHeader)
+        diagnostics.push({ line: headerLine + 1, message: 'The opening declaration must start at the beginning of the line.', severity: 'error' });
+    // Text under the opening line belongs to the name declaration, which is a single line.
+    const introductionLines = introduction.filter((index) => lines[index].trim() !== '');
+    const introductionText = introduction.length ? introduction.map((index) => unescapeLine(lines[index])).join('\n').trim() : '';
+    if (introductionLines.length && !plainHeader && declaredKind) {
+        diagnostics.push({
+            line: introductionLines[0] + 1,
+            message: `The ${declaredKind} name is a single line; put this text under a commitment such as ${declaredKind === 'task' ? 'GOAL' : declaredKind === 'agent' ? 'PERSONA, GOAL or NOTE' : 'NOTE'} (\`ptbk migrate\` converts it).`,
+            severity: 'error',
+        });
+    }
+    // Historical ENTITY lines and further declarations.
+    const entities = commitments.filter((commitment) => commitment.keyword === 'ENTITY');
+    // `ENTITY TASK` reads as one complete keyword; its second word is the former kind.
+    const entityValues = [...new Set(entities.map((commitment) => (commitment.written.split(/\s+/)[1] ?? commitment.value).trim().toUpperCase()))];
+    const entity = entityValues.length > 1 ? 'conflict' : entityValues.length ? (KIND_BY_KEYWORD[entityValues[0]] ?? 'unsupported') : undefined;
+    if (entities.length && declaredKind) {
+        const contradicts = entity !== declaredKind;
+        diagnostics.push({
+            line: entities[0].startLine + 1,
+            message: contradicts ? `ENTITY ${entities[0].value} contradicts the opening \`${opening.written}\` declaration and cannot override it.` : 'ENTITY is former syntax; the opening declaration already states the kind (remove this line).',
+            severity: contradicts ? 'error' : 'warning',
+        });
+    }
     for (const commitment of commitments) {
-        const scope = commitment.definition.scope;
-        if (kind === 'task' && scope === 'agent') {
-            diagnostics.push({ line: commitment.startLine + 1, message: `\`${commitment.written}\` is an agent commitment and has no meaning in a task.`, severity: 'warning' });
+        if (commitment.definition.kind === 'declaration') {
+            diagnostics.push({ line: commitment.startLine + 1, message: `A Book defines exactly one entity; this second \`${commitment.written}\` declaration is invalid.`, severity: 'error' });
+        }
+    }
+    const legacyPresent = plainHeader || uppercaseName || entities.length > 0 || (introductionLines.length > 0 && Boolean(declaredKind));
+    const legacy = legacyPresent
+        ? {
+            plainHeader,
+            entity,
+            uppercaseName: uppercaseName || undefined,
+            introduction: introductionLines.length ? { start: introduction[0], end: introduction[introduction.length - 1] + 1, text: introductionText } : undefined,
+        }
+        : undefined;
+    if (plainHeader) {
+        diagnostics.push({
+            line: headerLine + 1,
+            message: `"${name}" starts with a plain name line (former syntax). Canonical Books start with \`AGENT <name>\`, \`TASK <name>\` or \`CHAT <name>\`; convert it explicitly with \`ptbk migrate\`.`,
+            severity: 'error',
+        });
+    }
+    const kind = declaredKind && name ? declaredKind : undefined;
+    for (const commitment of commitments) {
+        if (commitment.definition.kind === 'declaration' || commitment.keyword === 'ENTITY')
+            continue;
+        const singleLine = commitment.definition.kind === 'control' || commitment.definition.kind === 'repeatable-control' || commitment.definition.kind === 'flag';
+        if (singleLine && commitment.continuation && kind) {
+            diagnostics.push({
+                line: commitment.startLine + 2,
+                message: `\`${commitment.written}\` takes single-line content; the text below it belongs to no instruction (put it under a commitment such as ${kind === 'task' ? 'GOAL' : kind === 'agent' ? 'PERSONA or NOTE' : 'NOTE'}).`,
+                severity: 'warning',
+            });
         }
-        if (kind === 'agent' && scope === 'task') {
-            diagnostics.push({ line: commitment.startLine + 1, message: `\`${commitment.written}\` is a task commitment and has no meaning in an agent.`, severity: 'warning' });
+        if (commitment.definition.unknown) {
+            diagnostics.push({ line: commitment.startLine + 1, message: `Unknown commitment \`${commitment.written}\`; it is preserved but has no effect.`, severity: 'warning' });
+            continue;
         }
+        if (!kind)
+            continue;
+        const scope = commitment.definition.scope;
+        if (scope === 'any' || scope === kind || (scope === 'both' && kind !== 'chat'))
+            continue;
+        diagnostics.push({ line: commitment.startLine + 1, message: `\`${commitment.written}\` is ${scopeLabel(scope)} commitment and has no meaning in a ${kind}.`, severity: 'warning' });
     }
-    return { kind, name, headerLine, intro: introLines.join('\n').trim(), commitments, diagnostics, lines, newline };
+    return { kind: kind ?? 'invalid', name, declaredKind, legacy, headerLine, commitments, diagnostics, lines, newline };
 }
 /**
  * Returns all commitments of a canonical keyword.

package/dist/book/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/book/parse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/book/parse.ts"],"names":[],"mappings":"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"}

package/dist/book/references.d.ts

@@ -25,7 +25,7 @@ export declare function nonAgentOf(normalized: string): NonAgentName | undefined
  * @private Book language
  */
 export type AgentReference = {
-    /** Exact source text, e.g. `@Developer` or `{Frontend Developer}`. */
+    /** Exact source text, e.g. `@Developer`, `{{Frontend Developer}}` or the compatible `{Frontend Developer}`. */
     readonly raw: string;
     /** Name without reference syntax, e.g. `Frontend Developer`. */
     readonly name: string;
@@ -35,7 +35,8 @@ export type AgentReference = {
     readonly index: number;
 };
 /**
- * Parses a single dedicated reference field value (`@Name`, `{Name}` or a bare name, as in `FROM Adam`).
+ * Parses a single dedicated reference field value (`@Name`, `{{Name}}`, the compatible `{Name}` or a bare name, as in
+ * `FROM Adam`).
  *
  * Returns `undefined` for an empty or malformed value.
  *
@@ -43,7 +44,8 @@ export type AgentReference = {
  */
 export declare function parseReferenceValue(value: string): AgentReference | undefined;
 /**
- * Finds agent references (`@Token` and `{Name}`) in natural text, skipping fenced/inline code and email addresses.
+ * Finds references (`@Token`, `{{Name}}` and the compatible `{Name}`) in natural text, skipping fenced/inline code and
+ * email addresses.
  *
  * @private Book language
  */
@@ -55,8 +57,14 @@ export declare function findAgentReferences(text: string): AgentReference[];
  */
 export declare function maskCode(text: string): string;
 /**
- * Formats an agent name as a reference (`@Name` for single tokens, `{Name}` otherwise).
+ * Formats a name as a reference (`@Name` for a single word, `{{Name}}` otherwise).
  *
  * @private Book language
  */
 export declare function formatAgentReference(name: string): string;
+/**
+ * The plain name of a reference (`@Developer`, `{{Frontend Developer}}`, `{Frontend Developer}` or a bare name).
+ *
+ * @private Book language
+ */
+export declare function referenceName(value: string): string;

package/dist/book/references.js

@@ -36,7 +36,8 @@ export function nonAgentOf(normalized) {
  */
 const TRAILING_PUNCTUATION = /[.,;:!?)\]}>"'`]+$/;
 /**
- * Parses a single dedicated reference field value (`@Name`, `{Name}` or a bare name, as in `FROM Adam`).
+ * Parses a single dedicated reference field value (`@Name`, `{{Name}}`, the compatible `{Name}` or a bare name, as in
+ * `FROM Adam`).
  *
  * Returns `undefined` for an empty or malformed value.
  *
@@ -47,7 +48,15 @@ export function parseReferenceValue(value) {
     if (!text)
         return undefined;
     let name;
-    if (text.startsWith('{')) {
+    if (text.startsWith('{{')) {
+        const end = text.indexOf('}}');
+        if (end < 0)
+            return undefined;
+        name = text.slice(2, end).trim();
+        if (text.slice(end + 2).trim())
+            return undefined;
+    }
+    else if (text.startsWith('{')) {
         const end = text.indexOf('}');
         if (end < 0)
             return undefined;
@@ -69,29 +78,37 @@ export function parseReferenceValue(value) {
     return { raw: text, name, normalized, index: 0 };
 }
 /**
- * Finds agent references (`@Token` and `{Name}`) in natural text, skipping fenced/inline code and email addresses.
+ * Finds references (`@Token`, `{{Name}}` and the compatible `{Name}`) in natural text, skipping fenced/inline code and
+ * email addresses.
  *
  * @private Book language
  */
 export function findAgentReferences(text) {
     const references = [];
     const masked = maskCode(text);
-    const pattern = /\{([^{}\n]{1,120})\}|@([^\s@{}()[\]<>,;:!?"'`]+)/g;
+    const pattern = /\{\{([^{}\n]{1,240})\}\}|\{([^{}\n]{1,240})\}|@([^\s@{}()[\]<>,;:!?"'`]+)/g;
     let match;
     while ((match = pattern.exec(masked)) !== null) {
         const index = match.index;
-        if (match[2] !== undefined) {
+        if (match[1] !== undefined) {
+            const name = match[1].trim();
+            const normalized = normalizeAgentName(name);
+            if (normalized)
+                references.push({ raw: match[0], name, normalized, index });
+            continue;
+        }
+        if (match[3] !== undefined) {
             const previous = index > 0 ? masked[index - 1] : '';
             if (/[A-Za-z0-9._%+-]/.test(previous))
                 continue; // e-mail address or similar
-            const name = match[2].replace(TRAILING_PUNCTUATION, '');
+            const name = match[3].replace(TRAILING_PUNCTUATION, '');
             const normalized = normalizeAgentName(name);
             if (!normalized)
                 continue;
             references.push({ raw: `@${name}`, name, normalized, index });
         }
         else {
-            const name = match[1].trim();
+            const name = match[2].trim();
             // Braces around code-like or template content are not references.
             if (!name || /[=$%#|\\/]/.test(name) || /^\d+(,\d*)?$/.test(name))
                 continue;
@@ -129,11 +146,19 @@ export function maskCode(text) {
     return result.slice(0, text.length);
 }
 /**
- * Formats an agent name as a reference (`@Name` for single tokens, `{Name}` otherwise).
+ * Formats a name as a reference (`@Name` for a single word, `{{Name}}` otherwise).
  *
  * @private Book language
  */
 export function formatAgentReference(name) {
-    return /^[^\s{}@]+$/.test(name) ? `@${name}` : `{${name}}`;
+    return /^[\p{L}\p{N}][\p{L}\p{N}_-]*$/u.test(name) && !/[-_]$/.test(name) ? `@${name}` : `{{${name}}}`;
+}
+/**
+ * The plain name of a reference (`@Developer`, `{{Frontend Developer}}`, `{Frontend Developer}` or a bare name).
+ *
+ * @private Book language
+ */
+export function referenceName(value) {
+    return parseReferenceValue(value)?.name ?? value.trim();
 }
 //# sourceMappingURL=references.js.map

package/dist/book/references.js.map

@@ -1 +1 @@
-{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/book/references.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/book/references.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,uBAAuB,GAAsC,IAAI,GAAG,CAAC;IACvE,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACvB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC3C,OAAO,IAAI;SACN,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB;IACzC,OAAO,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC;AAkBD;;GAEG;AACH,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,IAAY,CAAC;IACjB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YAAE,OAAO,SAAS,CAAC;IACrD,CAAC;SAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YAAE,OAAO,SAAS,CAAC;IACrD,CAAC;SAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;IAC1C,CAAC;SAAM,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC5C,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,4EAA4E,CAAC;IAC7F,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,UAAU;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5E,SAAS;QACb,CAAC;QACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,SAAS,CAAC,4BAA4B;YAC7E,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;YACxD,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,UAAU;gBAAE,SAAS;YAC1B,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;YAC9B,kEAAkE;YAClE,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC5E,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,UAAU;gBAAE,SAAS;YAC1B,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACjC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAyB,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM;gBAAE,KAAK,GAAG,SAAS,CAAC;YACzF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACzC,SAAS;QACb,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACT,KAAK,GAAG,MAAM,CAAC;YACf,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACzC,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IACnF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC7C,OAAO,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;AAC3G,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACvC,OAAO,mBAAmB,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC"}

package/dist/book/write.d.ts

@@ -0,0 +1,42 @@
+import { type EntityKind } from './parse.js';
+/**
+ * Declaration keyword of each entity kind.
+ *
+ * @private Book language
+ */
+export declare const DECLARATION_KEYWORD: Readonly<Record<EntityKind, 'AGENT' | 'TASK' | 'CHAT'>>;
+/**
+ * Whether a content line must be escaped (leading backslash) so it stays literal: it would start a commitment, begin
+ * a fence or already starts with the escape character.
+ *
+ * @private Book language
+ */
+export declare function needsLiteralEscape(line: string): boolean;
+/**
+ * Escapes arbitrary text as commitment continuation lines (lossless: the parser removes exactly one backslash).
+ *
+ * @private Book language
+ */
+export declare function literalLines(text: string): string[];
+/**
+ * Renders one commitment with arbitrary multi-line content: the first line stays on the keyword line when it cannot
+ * be mistaken for part of the keyword, everything else is escaped literal continuation.
+ *
+ * @private Book language
+ */
+export declare function renderCommitment(keyword: string, content: string): string[];
+/**
+ * Representable single-line spelling of a declared name.
+ *
+ * Whitespace collapses to single spaces; an all-uppercase first word (which would join the keyword under the boundary
+ * rule) is recased (`API cleanup` → `Api cleanup`, `A plan` → `a plan`), which keeps the normalized identity.
+ *
+ * @private Book language
+ */
+export declare function declarationName(name: string): string;
+/**
+ * Renders the opening declaration of a Book (`AGENT <name>`, `TASK <name>`, `CHAT <name>`).
+ *
+ * @private Book language
+ */
+export declare function renderDeclaration(kind: EntityKind, name: string): string;

package/dist/book/write.js

@@ -0,0 +1,74 @@
+import { matchCommitmentKeyword } from './commitments.js';
+import { fenceMarker, parseBook } from './parse.js';
+/**
+ * Declaration keyword of each entity kind.
+ *
+ * @private Book language
+ */
+export const DECLARATION_KEYWORD = { agent: 'AGENT', task: 'TASK', chat: 'CHAT' };
+/**
+ * Whether a content line must be escaped (leading backslash) so it stays literal: it would start a commitment, begin
+ * a fence or already starts with the escape character.
+ *
+ * @private Book language
+ */
+export function needsLiteralEscape(line) {
+    return line.startsWith('\\') || fenceMarker(line) !== undefined || matchCommitmentKeyword(line) !== undefined;
+}
+/**
+ * Escapes arbitrary text as commitment continuation lines (lossless: the parser removes exactly one backslash).
+ *
+ * @private Book language
+ */
+export function literalLines(text) {
+    return text
+        .replace(/\r\n?/g, '\n')
+        .split('\n')
+        .map((line) => (needsLiteralEscape(line) ? `\\${line}` : line));
+}
+/**
+ * Renders one commitment with arbitrary multi-line content: the first line stays on the keyword line when it cannot
+ * be mistaken for part of the keyword, everything else is escaped literal continuation.
+ *
+ * @private Book language
+ */
+export function renderCommitment(keyword, content) {
+    const text = content.replace(/\r\n?/g, '\n').trim();
+    if (!text)
+        return [keyword];
+    const [first, ...rest] = text.split('\n');
+    const inline = `${keyword} ${first.trim()}`;
+    const fitsInline = !first.startsWith('\\') && fenceMarker(first) === undefined && matchCommitmentKeyword(inline)?.definition.keyword === keyword;
+    if (!fitsInline)
+        return [keyword, ...literalLines(text)];
+    return rest.length ? [inline, ...literalLines(rest.join('\n'))] : [inline];
+}
+/**
+ * Representable single-line spelling of a declared name.
+ *
+ * Whitespace collapses to single spaces; an all-uppercase first word (which would join the keyword under the boundary
+ * rule) is recased (`API cleanup` → `Api cleanup`, `A plan` → `a plan`), which keeps the normalized identity.
+ *
+ * @private Book language
+ */
+export function declarationName(name) {
+    const single = name.replace(/\s+/g, ' ').trim();
+    const [first = '', ...rest] = single.split(' ');
+    if (!/^\p{Lu}[\p{Lu}\p{M}]*$/u.test(first))
+        return single;
+    const recased = first.length > 1 ? `${first[0]}${first.slice(1).toLowerCase()}` : first.toLowerCase();
+    return [recased, ...rest].join(' ');
+}
+/**
+ * Renders the opening declaration of a Book (`AGENT <name>`, `TASK <name>`, `CHAT <name>`).
+ *
+ * @private Book language
+ */
+export function renderDeclaration(kind, name) {
+    const line = `${DECLARATION_KEYWORD[kind]} ${declarationName(name)}`;
+    const document = parseBook(line);
+    if (document.kind !== kind)
+        throw new Error(`Cannot declare "${name}" as a ${kind}: ${document.diagnostics.map((diagnostic) => diagnostic.message).join(' ')}`);
+    return line;
+}
+//# sourceMappingURL=write.js.map

package/dist/book/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/book/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA4D,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3I;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AAClH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,OAAO,IAAI;SACN,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAe;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,GAAG,OAAO,IAAI,KAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,CAAC,KAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,KAAM,CAAC,KAAK,SAAS,IAAI,sBAAsB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,KAAK,OAAO,CAAC;IACnJ,IAAI,CAAC,UAAU;QAAE,OAAO,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACtG,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB,EAAE,IAAY;IAC5D,MAAM,IAAI,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,UAAU,IAAI,KAAK,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChK,OAAO,IAAI,CAAC;AAChB,CAAC"}