ptbk 0.119.0-17 → 0.119.0-21

package/README.md

@@ -1,6 +1,6 @@
 # Promptbook (`ptbk`)
 
-Promptbook operates readable **agents** and **tasks** over a Git project. Agents are Books with lasting roles, goals and rules; tasks are bounded work. Once started, the agenda runs unattended: it executes one task at a time, routes unassigned tasks through Manager, verifies every result with your project check and commits it together with its completion record (`PTBK: <task title>` plus a `Task-ID` trailer). When the backlog is empty, agents with goals are asked whether new work is useful. You are asked only when something genuinely needs a person.
+Promptbook operates readable **agents**, **tasks** and **chats** over a Git project. All three are Books in one language: each starts with `AGENT <name>`, `TASK <name>` or `CHAT <name>`, and that name is its identity. Agents have lasting roles, goals and rules; tasks are bounded work; chats are persistent conversations between you and an agent. Once started, the agenda runs unattended: it executes one task at a time, routes unassigned tasks through Manager, verifies every result with your project check and commits it together with its completion record (`PTBK: <task name>` plus a `Task-Name` trailer). When the backlog is empty, agents with goals are asked whether new work is useful; Fixer keeps the project itself healthy. When something genuinely needs a person, the responsible agent asks you in a chat.
 
 This repository publishes exactly one npm package, `ptbk`, which installs the `ptbk` command. It requires Node.js 22.13+ (Node 22 line) or 24+, npm 10+ and Git.
 
@@ -15,18 +15,23 @@ npm install --save-dev ptbk
 npx ptbk --version
 ```
 
-Global and local installations are independent; every project keeps using the installation that started it, including after restarts.
+Global and local installations are independent; every project keeps using the installation that started it, including after restarts. A dashboard or status opened with another ptbk version shows the service through its own installation.
 
 ## Use
 
 ```bash
 ptbk init                 # describe your project, answer a few setup questions; the agenda then starts in the background
 ptbk dashboard            # live terminal view and controls (Q leaves, the service keeps running)
-ptbk status               # one snapshot: requests, current work, queue, connection
-ptbk add "Improve CSV export"   # creates and commits a task (with its Task-ID); Manager assigns it
-ptbk list "#<task-id>"    # one task: its trace, browser video and commits
-ptbk answer               # answer questions agents asked you
-ptbk stop                 # stop (stays stopped after reboot until the next start or init)
+ptbk dashboard --global   # every running project engine on this computer, from any directory
+ptbk status               # one snapshot: agents waiting for you, current work, queue, connection
+ptbk chat                 # talk with Chatter (Enter) or choose another agent; Ctrl+C closes only the chat
+ptbk ask "What is left?"  # quick question to one agent, saved as a chat
+ptbk answer               # answer agents that wait for you
+ptbk add "Improve CSV export"   # creates and commits a task; Manager assigns it
+ptbk list "{{Improve CSV export — 2026-10-18 01:25:00}}"  # one task: its trace, browser video and commits
+ptbk pause                # no new task starts; the current one finishes first (ptbk resume continues)
+ptbk stop                 # graceful stop after the current task (stays stopped after reboot); -F stops now
+ptbk restart              # graceful restart: exactly one replacement with the same configuration
 ptbk start                # start an initialized, cloned or stopped project
 ptbk run --limit 1        # finite run with one agent/harness configuration
 ```
@@ -37,8 +42,21 @@ Run `ptbk help` for all commands and `ptbk help <command>` for one command's opt
 
 -   **Unattended setup:** `ptbk init --non-interactive --installation local --harness openai-codex --check "npm test" --intent-file brief.md --attach mockup.png` (`--no-start` only prepares the project).
 -   **Harnesses:** OpenAI Codex and Claude Code are featured; GitHub Copilot, Cline, OpenCode, Gemini CLI and Qwen Code are also supported. They are installed globally and use their own login.
--   **Files:** agents in `agents/` (core Adam, Manager and Teacher in `agents/.core/`), tasks in `tasks/` (Books or Markdown), specifications in `specs/`, per-task audit evidence in `traces/<task-id>/`, configuration in `ptbk.json`, runtime state in the Git-ignored `.ptbk/`.
--   **Task IDs and traces:** every task has a stable ID (`TASK ID` in Books, `<!-- ptbk-task-id: … -->` in Markdown sections) that also appears in its commits' `Task-ID` trailer and names `traces/<task-id>/`: the consolidated harness output (`harness.log`), events (`events.jsonl`) and, when the task used the project browser, its video (`video/`, sign-in steps excluded). `ptbk.json` `traces.commit` (default off: `traces/` is ignored), `traces.ignoreVideos` (default on) and `traces.recordVideo` (default on) are chosen on init's Traces screen. With `ffmpeg` on PATH videos are H.264 MP4, otherwise Motion-JPEG MOV.
+-   **Files:** agents in `agents/` (core Adam, Manager, Teacher, Fixer and Chatter in `agents/.core/`), tasks in `tasks/` (Books or Markdown), chats in `chats/`, specifications in `specs/`, per-task audit evidence in `traces/<task-file-basename>/`, configuration in `ptbk.json`, runtime state in the Git-ignored `.ptbk/`.
+-   **Books:** every Book opens with one declaration, then commitments, e.g.
+
+    ```book
+    TASK Improve CSV export — 2026-10-18 01:25:00
+    GOAL Preserve column names and quote cells with commas or newlines.
+    TASK AGENT @Developer
+    LINK {{Discuss CSV requirements — 2026-10-18 01:24:00}}
+    ```
+
+    A commitment keyword is a complete line-initial uppercase word sequence of at least three letters (so a name must not begin with an all-uppercase word: `AGENT Ceo`, not `AGENT CEO`); descriptions go under commitments such as `GOAL`, `PERSONA` or `NOTE`. New tasks and chats get generated names — a readable title plus the creation date/time, distinct from every other name. Books in the former syntax (a plain name line, `ENTITY`) are reported and converted only by `ptbk migrate`.
+-   **Names, references and traces:** `@Name` and `{{Multi Word Name}}` (the older `{Name}` still reads) reference any Book through one resolver: built-ins (`@Void`, `@Null`, `@Expert`, `@User`), then `agents/`, `tasks/`, `chats/`, the rest of the project and finally Git-ignored content; a same-name copy is shadowed and reported, never merged or renamed. Commits carry `Task-Name`/`Chat-Name` trailers and each task's evidence lives in `traces/<task-file-basename>/` — the task's source filename without `.book` (e.g. `tasks/2026-10-19-1205-browser-repair.book` → `traces/2026-10-19-1205-browser-repair/`), with the declared name and source revision recorded inside: the consolidated harness output (`harness.log`), events (`events.jsonl`) and, when the task used the project browser, its video (`video/`, sign-in steps excluded). `ptbk.json` `traces.commit` (default off: `traces/` is ignored), `traces.ignoreVideos` (default on) and `traces.recordVideo` (default on) are chosen on init's Traces screen. With `ffmpeg` on PATH videos are H.264 MP4, otherwise Motion-JPEG MOV.
+-   **Chats:** a new chat goes to **Chatter**, the project's conversational guide (Enter), unless you choose another agent; Chatter consults the right specialists for you (attributed, linked consultation chats) and creates ordinary tasks only when you ask for work. Every message you or an agent write is committed (`PTBK: Chat - <name>`); reading never commits. A correction in a chat can schedule an ordinary Teacher task. Questions, sign-in requests and failure decisions from running tasks are chats started by the responsible agent (dashboard key `A`, `ptbk answer`); the task resumes on a valid answer. The dashboards start chats with `C` (terminal) or **New chat** (browser).
+-   **Browser:** agents share one browser per project. Profiles: the dedicated Promptbook profile shared by your projects (default; one project at a time), an isolated project profile in `.ptbk/`, your own Chrome profile, or a custom path (`browser.profile`: `global`, `isolated`, `user` or a path).
+-   **Service lifecycle:** a running engine is `running`, `pausing`, `pause` or `stopping`. Pause and stop let the current task finish without starting another one; `ptbk resume` cancels a pending pause, stop or restart; `ptbk stop --force` (`-F`) interrupts owned work immediately (recoverable). The dashboards and browser expose the same controls; leaving a dashboard never stops the service, and any number of dashboards can watch one engine. Execution details (agent, harness, model, thinking level) and browser details (profile, health, recheck/retry/restart) are collapsible panels (`E`/`B` in the terminal).
 -   **Remote access:** `ptbk start` serves a dashboard on `127.0.0.1` and publishes it through a Cloudflare quick tunnel; devices must pair with a single-use link shown in the local terminal (`ptbk access pair`). Use `--no-tunnel` for local-only access or `--no-server` for neither.
 -   **Presentation:** pretty terminal UI by default; `--raw` (or redirected output) gives plain text without prompts. `--non-interactive` never asks questions.
 -   **Commits:** every mutating workflow commits its own changes with a `PTBK: ` subject; `--no-commit` is the explicit exception.

package/dist/book/commitments.d.ts

@@ -1,20 +1,22 @@
 /**
- * Which document kinds a commitment belongs to.
+ * Which document kinds a commitment belongs to (`both` = agents and tasks, `chat` = chats, `any` = every kind).
  *
  * @private Book language
  */
-export type CommitmentScope = 'agent' | 'task' | 'both';
+export type CommitmentScope = 'agent' | 'task' | 'both' | 'chat' | 'any';
 /**
  * How a commitment's content is interpreted.
  *
+ * - `declaration`: the opening type-and-name commitment (`AGENT`, `TASK`, `CHAT`); its content is the name
  * - `instruction`: repeatable multi-line natural-language content
  * - `control`: single-value control field (its value is the first line)
  * - `repeatable-control`: control field that may appear several times (e.g. `TASK DONE`, `TASK DEPENDS ON`)
  * - `flag`: marker without required content (e.g. `CLOSED`)
+ * - `historical`: former syntax kept only to diagnose and convert old sources (`ENTITY`)
  *
  * @private Book language
  */
-export type CommitmentKind = 'instruction' | 'control' | 'repeatable-control' | 'flag';
+export type CommitmentKind = 'declaration' | 'instruction' | 'control' | 'repeatable-control' | 'flag' | 'historical';
 /**
  * Definition of one canonical commitment with its aliases.
  *
@@ -31,6 +33,8 @@ export type CommitmentDefinition = {
     readonly kind: CommitmentKind;
     /** Short description used by help, Expert and diagnostics. */
     readonly description: string;
+    /** Not a documented commitment: an unknown complete keyword preserved for round-tripping and diagnosed. */
+    readonly unknown?: boolean;
 };
 /**
  * Every recognized commitment.
@@ -39,14 +43,38 @@ export type CommitmentDefinition = {
  */
 export declare const COMMITMENTS: readonly CommitmentDefinition[];
 /**
- * Recognizes a commitment at the beginning of a line.
+ * The commitment kind a compound withdrawal names (`DELETE RULE` → `RULE`), if any.
  *
- * The keyword must be uppercase and complete: it is followed by whitespace or the end of the line.
+ * @private Book language
+ */
+export declare function withdrawnKeyword(written: string): string | undefined;
+/**
+ * A commitment keyword found at the beginning of a line.
+ *
+ * @private Book language
+ */
+export type KeywordMatch = {
+    /** Definition of the complete keyword (a synthetic `unknown` definition for undocumented keywords). */
+    readonly definition: CommitmentDefinition;
+    /** Keyword as written (complete uppercase word sequence). */
+    readonly written: string;
+    /** Content after the keyword on the same line (trimmed). */
+    readonly content: string;
+};
+/**
+ * Recognizes a commitment at the beginning of a line by the common boundary rule.
+ *
+ * The keyword is the maximal sequence of all-uppercase words at column zero, separated by spaces, with at least three
+ * letters in total. A word containing lowercase letters, digits, punctuation or a reference begins the content; once
+ * content begins, later uppercase words belong to it. The complete keyword is looked up as a whole: an unknown keyword
+ * is never shortened to a known prefix (`TASK SOMETHING` is not `TASK`).
+ *
+ * @private Book language
+ */
+export declare function matchCommitmentKeyword(line: string): KeywordMatch | undefined;
+/**
+ * Whether a line would start a commitment (writers escape such lines in literal content).
  *
  * @private Book language
  */
-export declare function matchCommitmentKeyword(line: string): {
-    definition: CommitmentDefinition;
-    written: string;
-    content: string;
-} | undefined;
+export declare function startsCommitment(line: string): boolean;

package/dist/book/commitments.js

@@ -4,8 +4,16 @@
  * @private Book language
  */
 export const COMMITMENTS = [
+    { keyword: 'AGENT', aliases: [], scope: 'agent', kind: 'declaration', description: 'Opening declaration of an agent: `AGENT <name>`.' },
+    { keyword: 'TASK', aliases: [], scope: 'task', kind: 'declaration', description: 'Opening declaration of a task: `TASK <name>`.' },
+    { keyword: 'CHAT', aliases: [], scope: 'chat', kind: 'declaration', description: 'Opening declaration of a chat: `CHAT <name>`.' },
+    { keyword: 'ENTITY', aliases: ['ENTITY AGENT', 'ENTITY TASK', 'ENTITY CHAT'], scope: 'any', kind: 'historical', description: 'Former kind declaration after a plain name line; convert with `ptbk migrate`.' },
+    { keyword: 'LINK', aliases: ['LINKS'], scope: 'any', kind: 'repeatable-control', description: 'Directed reference to another agent, task or chat (no scheduling or authority).' },
+    { keyword: 'CHAT MEMBER', aliases: [], scope: 'chat', kind: 'repeatable-control', description: 'Participant of a chat (`@User` and one agent, or two agents of a task).' },
+    { keyword: 'CHAT MESSAGE', aliases: [], scope: 'chat', kind: 'instruction', description: 'One durable message: `CHAT MESSAGE <sender> <timestamp>` followed by its text.' },
+    { keyword: 'CHAT STATUS', aliases: [], scope: 'chat', kind: 'control', description: '`open`, `waiting-for-user` or `resolved`.' },
     { keyword: 'PERSONA', aliases: ['PERSONAE'], scope: 'agent', kind: 'instruction', description: 'Role and identity of the agent.' },
-    { keyword: 'GOAL', aliases: ['GOALS'], scope: 'agent', kind: 'instruction', description: 'Lasting objective, also used for goal discovery.' },
+    { keyword: 'GOAL', aliases: ['GOALS'], scope: 'both', kind: 'instruction', description: "An agent's lasting objective (also used for goal discovery), or a task's bounded work and intended result." },
     { keyword: 'RULE', aliases: ['RULES'], scope: 'both', kind: 'instruction', description: 'Behavioral constraint (task rules apply only to that task).' },
     { keyword: 'KNOWLEDGE', aliases: [], scope: 'agent', kind: 'instruction', description: 'Inline knowledge or a reference to relevant material.' },
     { keyword: 'STYLE', aliases: ['STYLES'], scope: 'agent', kind: 'instruction', description: 'Style of communication or output.' },
@@ -22,11 +30,10 @@ export const COMMITMENTS = [
     { keyword: 'TEAM', aliases: [], scope: 'agent', kind: 'instruction', description: 'Whom the agent may consult and when.' },
     { keyword: 'OPEN', aliases: [], scope: 'agent', kind: 'instruction', description: 'Permits learning, optionally with natural-language limits.' },
     { keyword: 'CLOSED', aliases: [], scope: 'agent', kind: 'flag', description: 'Prohibits automatic learning changes.' },
-    { keyword: 'NOTE', aliases: ['NOTES', 'COMMENT', 'NONCE', 'TODO'], scope: 'both', kind: 'instruction', description: 'Non-executable commentary.' },
+    { keyword: 'NOTE', aliases: ['NOTES', 'COMMENT', 'NONCE', 'TODO'], scope: 'any', kind: 'instruction', description: 'Non-executable commentary.' },
     { keyword: 'DELETE', aliases: ['CANCEL', 'DISCARD', 'REMOVE'], scope: 'agent', kind: 'instruction', description: 'Withdraws an identified earlier commitment.' },
     { keyword: 'DICTIONARY', aliases: [], scope: 'agent', kind: 'instruction', description: 'Terminology for the role\'s work.' },
-    { keyword: 'TASK', aliases: [], scope: 'task', kind: 'control', description: 'Declares a task: `TASK <title>` on the first nonempty line.' },
-    { keyword: 'TASK ID', aliases: [], scope: 'task', kind: 'control', description: 'Stable reference key, distinct from the title.' },
+    { keyword: 'TASK ID', aliases: [], scope: 'task', kind: 'control', description: 'Legacy historical metadata; never identity (the task name is).' },
     { keyword: 'TASK AGENT', aliases: [], scope: 'task', kind: 'control', description: 'Responsible agent.' },
     { keyword: 'TASK HARNESS', aliases: [], scope: 'task', kind: 'control', description: 'Required execution harness.' },
     { keyword: 'TASK MODEL', aliases: [], scope: 'task', kind: 'control', description: 'Required model.' },
@@ -46,27 +53,64 @@ export const COMMITMENTS = [
 /**
  * Lookup from every accepted keyword spelling to its definition.
  */
-const KEYWORD_LOOKUP = new Map(COMMITMENTS.flatMap((definition) => [definition.keyword, ...definition.aliases].map((keyword) => [keyword, definition])));
+const KEYWORD_LOOKUP = new Map([
+    ...COMMITMENTS.flatMap((definition) => [definition.keyword, ...definition.aliases].map((keyword) => [keyword, definition])),
+    // `DELETE RULE …` is one complete keyword: the withdrawal names the kind of the commitment it withdraws.
+    ...COMMITMENTS.filter((definition) => definition.kind === 'instruction' && definition.keyword !== 'DELETE').flatMap((target) => ['DELETE', 'CANCEL', 'DISCARD', 'REMOVE'].flatMap((withdraw) => [target.keyword, ...target.aliases].map((keyword) => [`${withdraw} ${keyword}`, COMMITMENTS.find((definition) => definition.keyword === 'DELETE')]))),
+]);
 /**
- * All keyword spellings, longest first (so `TASK AGENT` wins over `TASK`).
+ * The commitment kind a compound withdrawal names (`DELETE RULE` → `RULE`), if any.
+ *
+ * @private Book language
+ */
+export function withdrawnKeyword(written) {
+    const [, ...rest] = written.trim().split(/\s+/);
+    if (!rest.length)
+        return undefined;
+    const target = KEYWORD_LOOKUP.get(rest.join(' '));
+    return target && target.keyword !== 'DELETE' ? target.keyword : undefined;
+}
+/**
+ * One all-uppercase word of a commitment keyword (letters only; digits, punctuation or lowercase begin content).
+ */
+const KEYWORD_WORD = /^\p{Lu}[\p{Lu}\p{M}]*$/u;
+/**
+ * Fewest letters a complete keyword needs (so `A`, `I` or `AI` starting prose never begin a commitment).
  */
-const KEYWORDS_LONGEST_FIRST = [...KEYWORD_LOOKUP.keys()].sort((a, b) => b.length - a.length);
+const MIN_KEYWORD_LETTERS = 3;
 /**
- * Recognizes a commitment at the beginning of a line.
+ * Recognizes a commitment at the beginning of a line by the common boundary rule.
  *
- * The keyword must be uppercase and complete: it is followed by whitespace or the end of the line.
+ * The keyword is the maximal sequence of all-uppercase words at column zero, separated by spaces, with at least three
+ * letters in total. A word containing lowercase letters, digits, punctuation or a reference begins the content; once
+ * content begins, later uppercase words belong to it. The complete keyword is looked up as a whole: an unknown keyword
+ * is never shortened to a known prefix (`TASK SOMETHING` is not `TASK`).
  *
  * @private Book language
  */
 export function matchCommitmentKeyword(line) {
-    for (const keyword of KEYWORDS_LONGEST_FIRST) {
-        if (!line.startsWith(keyword))
-            continue;
-        const rest = line.slice(keyword.length);
-        if (rest !== '' && !/^\s/.test(rest))
-            continue;
-        return { definition: KEYWORD_LOOKUP.get(keyword), written: keyword, content: rest.trim() };
+    if (!/^\p{Lu}/u.test(line))
+        return undefined;
+    const words = [];
+    let offset = 0;
+    for (const word of line.matchAll(/\S+/g)) {
+        if (!KEYWORD_WORD.test(word[0]))
+            break;
+        words.push(word[0]);
+        offset = word.index + word[0].length;
     }
-    return undefined;
+    const keyword = words.join(' ');
+    if (keyword.replace(/\s/g, '').length < MIN_KEYWORD_LETTERS)
+        return undefined;
+    const definition = KEYWORD_LOOKUP.get(keyword) ?? { keyword, aliases: [], scope: 'any', kind: 'instruction', description: 'Unknown commitment (preserved without effect).', unknown: true };
+    return { definition, written: line.slice(0, offset), content: line.slice(offset).trim() };
+}
+/**
+ * Whether a line would start a commitment (writers escape such lines in literal content).
+ *
+ * @private Book language
+ */
+export function startsCommitment(line) {
+    return matchCommitmentKeyword(line) !== undefined;
 }
 //# sourceMappingURL=commitments.js.map

package/dist/book/commitments.js.map

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

package/dist/book/convert.d.ts

@@ -0,0 +1,36 @@
+import { type EntityKind } from './parse.js';
+/**
+ * Conventional folder of a source, the documented context former syntax relied on for its kind.
+ *
+ * @private Book conversion
+ */
+export type LegacyLocation = 'agents' | 'tasks' | 'chats' | undefined;
+/**
+ * Outcome of converting one source.
+ *
+ * @private Book conversion
+ */
+export type BookConversion = {
+    readonly kind: 'unchanged';
+} | {
+    readonly kind: 'converted';
+    readonly entity: EntityKind;
+    readonly name: string;
+    readonly content: string;
+    readonly notes: readonly string[];
+} | {
+    readonly kind: 'blocked';
+    readonly reason: string;
+};
+/**
+ * Converts a Book in former syntax into the canonical form, preserving its name, content, links and history.
+ *
+ * Former syntax: a plain name line (kind from `ENTITY` or, as documented then, the conventional folder), `ENTITY`
+ * lines, a `TASK <name>` header followed by an introduction, and text after one-line controls. Descriptive text without
+ * an owner moves under GOAL (tasks), PERSONA (agents, where it was part of the role) or NOTE (chats); lines the new
+ * boundary rule would read as commitments are escaped literally. The name is kept exactly (no new date); an ambiguous
+ * kind or a name that cannot follow a keyword blocks the conversion instead of guessing.
+ *
+ * @private Book conversion
+ */
+export declare function convertLegacyBook(source: string, location: LegacyLocation): BookConversion;

package/dist/book/convert.js

@@ -0,0 +1,156 @@
+import { COMMITMENTS, matchCommitmentKeyword } from './commitments.js';
+import { fenceMarker, parseBook } from './parse.js';
+import { DECLARATION_KEYWORD, declarationName, renderCommitment } from './write.js';
+/**
+ * Keyword spellings the former parser recognized, longest first (it matched known keywords as prefixes).
+ */
+const FORMER_KEYWORDS = COMMITMENTS.filter((definition) => definition.kind !== 'declaration' || definition.keyword === 'TASK')
+    .flatMap((definition) => [definition.keyword, ...definition.aliases])
+    .sort((a, b) => b.length - a.length);
+/**
+ * How the former parser read a line: a known keyword followed by whitespace or the end of the line.
+ */
+function formerMatch(line) {
+    for (const keyword of FORMER_KEYWORDS) {
+        if (!line.startsWith(keyword))
+            continue;
+        const rest = line.slice(keyword.length);
+        if (rest !== '' && !/^\s/.test(rest))
+            continue;
+        return { keyword, content: rest.trim() };
+    }
+    return undefined;
+}
+/**
+ * Canonical keyword of a known spelling (alias resolved).
+ */
+function canonicalKeyword(written) {
+    return COMMITMENTS.find((definition) => definition.keyword === written || definition.aliases.includes(written))?.keyword ?? written;
+}
+/**
+ * Commitment that receives descriptive text without an owner in former syntax.
+ */
+const DESCRIPTION_KEYWORD = { task: 'GOAL', agent: 'PERSONA', chat: 'NOTE' };
+/**
+ * Converts a Book in former syntax into the canonical form, preserving its name, content, links and history.
+ *
+ * Former syntax: a plain name line (kind from `ENTITY` or, as documented then, the conventional folder), `ENTITY`
+ * lines, a `TASK <name>` header followed by an introduction, and text after one-line controls. Descriptive text without
+ * an owner moves under GOAL (tasks), PERSONA (agents, where it was part of the role) or NOTE (chats); lines the new
+ * boundary rule would read as commitments are escaped literally. The name is kept exactly (no new date); an ambiguous
+ * kind or a name that cannot follow a keyword blocks the conversion instead of guessing.
+ *
+ * @private Book conversion
+ */
+export function convertLegacyBook(source, location) {
+    const document = parseBook(source);
+    if (document.kind === 'empty')
+        return { kind: 'unchanged' };
+    const legacy = document.legacy;
+    const formerTaskHeader = !document.declaredKind && /^TASK\s/.test(document.lines[document.headerLine] ?? '');
+    if (!legacy && !formerTaskHeader)
+        return { kind: 'unchanged' };
+    if (legacy?.uppercaseName)
+        return { kind: 'blocked', reason: `the name "${document.name}" starts with an all-uppercase word, which cannot follow a declaration keyword; choose a representable spelling (e.g. "${declarationName(document.name)}") and edit the first line explicitly` };
+    // Kind: the canonical declaration, else ENTITY, else the documented folder convention.
+    const header = document.lines[document.headerLine];
+    const former = formerMatch(header);
+    let entity = document.declaredKind ?? (former?.keyword === 'TASK' ? 'task' : undefined);
+    if (legacy?.entity === 'conflict' || legacy?.entity === 'unsupported')
+        return { kind: 'blocked', reason: 'its ENTITY declarations are contradictory or unsupported; state the kind explicitly' };
+    if (legacy?.entity) {
+        if (entity && entity !== legacy.entity)
+            return { kind: 'blocked', reason: `its header declares a ${entity} but ENTITY says ${legacy.entity}` };
+        entity = legacy.entity;
+    }
+    const folderKind = location === 'agents' ? 'agent' : location === 'tasks' ? 'task' : location === 'chats' ? 'chat' : undefined;
+    if (!entity)
+        entity = folderKind;
+    if (!entity)
+        return { kind: 'blocked', reason: 'its kind is unknown (no ENTITY and not in agents/, tasks/ or chats/); start it with AGENT, TASK or CHAT explicitly' };
+    if (folderKind && legacy?.entity && folderKind !== legacy.entity)
+        return { kind: 'blocked', reason: `it declares a ${legacy.entity} but lies in ${location}/; move it or state the kind explicitly` };
+    const name = former?.keyword === 'TASK' && !document.declaredKind ? former.content : document.name;
+    if (!name)
+        return { kind: 'blocked', reason: 'it has no name' };
+    if (declarationName(name) !== name.replace(/\s+/g, ' ').trim())
+        return { kind: 'blocked', reason: `the name "${name}" needs an explicit spelling decision` };
+    // Re-read the body as the former parser did: only known keywords started commitments.
+    const notes = [];
+    const loose = [];
+    const body = [];
+    let fence;
+    let section;
+    let introduction = true;
+    const escapeContent = (line, message) => {
+        // Former message bodies already used the backslash escape; other content did not.
+        if (!message && line.startsWith('\\'))
+            return `\\${line}`;
+        if (!message && fenceMarker(line) === undefined && matchCommitmentKeyword(line))
+            return `\\${line}`;
+        if (message && !line.startsWith('\\') && matchCommitmentKeyword(line))
+            return `\\${line}`;
+        return line;
+    };
+    for (let index = document.headerLine + 1; index < document.lines.length; index++) {
+        const line = document.lines[index];
+        const marker = fenceMarker(line);
+        const match = fence || marker ? undefined : formerMatch(line);
+        if (fence) {
+            if (marker && marker[0] === fence[0] && marker.length >= fence.length && line.trim() === marker)
+                fence = undefined;
+        }
+        else if (marker)
+            fence = marker;
+        if (match) {
+            introduction = false;
+            const keyword = canonicalKeyword(match.keyword);
+            const definition = COMMITMENTS.find((item) => item.keyword === keyword);
+            const single = definition.kind === 'control' || definition.kind === 'repeatable-control' || definition.kind === 'flag' || definition.kind === 'historical';
+            section = { keyword, single, message: keyword === 'CHAT MESSAGE' };
+            if (keyword === 'ENTITY') {
+                notes.push('removed the redundant ENTITY declaration');
+                continue;
+            }
+            if (keyword === 'TASK') {
+                // A later legacy `TASK …` line never declared anything; keep its text as content.
+                loose.push(match.content);
+                continue;
+            }
+            const reread = matchCommitmentKeyword(line);
+            if (reread && !reread.definition.unknown && reread.definition.keyword === keyword && reread.content === match.content)
+                body.push(line);
+            else
+                body.push(...renderCommitment(match.keyword, match.content));
+            continue;
+        }
+        if (introduction || section?.single) {
+            if (line.trim() || loose.length)
+                loose.push(fence || marker ? line : line);
+            continue;
+        }
+        body.push(fence || marker ? line : escapeContent(line, Boolean(section?.message)));
+    }
+    while (loose.length && !loose[loose.length - 1].trim())
+        loose.pop();
+    const description = loose.join('\n').trim();
+    const lines = [`${DECLARATION_KEYWORD[entity]} ${name.replace(/\s+/g, ' ').trim()}`];
+    if (description) {
+        lines.push(...renderCommitment(DESCRIPTION_KEYWORD[entity], description));
+        notes.push(`moved descriptive text under ${DESCRIPTION_KEYWORD[entity]}`);
+    }
+    while (body.length && !body[0].trim())
+        body.shift();
+    if (body.length && entity !== 'chat' && description)
+        lines.push('');
+    lines.push(...body);
+    while (lines.length && !lines[lines.length - 1].trim())
+        lines.pop();
+    const content = `${lines.join(document.newline)}${document.newline}`;
+    const check = parseBook(content);
+    if (check.kind !== entity || check.name !== name.replace(/\s+/g, ' ').trim()) {
+        return { kind: 'blocked', reason: `the converted Book would not read back as the same ${entity} (${check.diagnostics.map((diagnostic) => diagnostic.message).join(' ')})` };
+    }
+    return { kind: 'converted', entity, name: check.name, content, notes };
+}
+//# sourceMappingURL=convert.js.map

package/dist/book/convert.js.map

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

package/dist/book/parse.d.ts

@@ -18,38 +18,66 @@ export type BookDiagnostic = {
  * @private Book language
  */
 export type BookCommitment = {
-    /** Canonical keyword of the commitment (alias resolved). */
+    /** Canonical keyword of the commitment (alias resolved; the complete written keyword when unknown). */
     readonly keyword: string;
     /** Keyword spelling written in the source. */
     readonly written: string;
-    /** Definition of the commitment. */
+    /** Definition of the commitment (`unknown` for undocumented keywords). */
     readonly definition: CommitmentDefinition;
     /** Content on the keyword's own line. */
     readonly value: string;
-    /** Full content including continuation lines (trimmed). */
+    /** Full content including continuation lines (trimmed; escaped literal lines unescaped). */
     readonly body: string;
-    /** Continuation lines only (trimmed). */
+    /** Continuation lines only (trimmed; escaped literal lines unescaped). */
     readonly continuation: string;
     /** 0-based index of the keyword line. */
     readonly startLine: number;
     /** 0-based index after the last continuation line. */
     readonly endLine: number;
 };
+/**
+ * The three project entity kinds a Book can define.
+ *
+ * @private Book language
+ */
+export type EntityKind = 'agent' | 'task' | 'chat';
+/**
+ * Details of a source written in a former syntax (plain name line, `ENTITY`, introduction text), recorded only to
+ * diagnose it and to prepare an explicitly requested conversion; it never makes the source a valid Book.
+ *
+ * @private Book language
+ */
+export type LegacySource = {
+    /** The first line is a plain name instead of an `AGENT|TASK|CHAT <name>` declaration. */
+    readonly plainHeader: boolean;
+    /** Kind stated by historical `ENTITY` lines (`conflict` when they disagree, `unsupported` for another value). */
+    readonly entity?: EntityKind | 'conflict' | 'unsupported';
+    /** The name starts with an all-uppercase word, so it cannot follow a keyword without a spelling decision. */
+    readonly uppercaseName?: boolean;
+    /** Text between the opening line and the first commitment (a former introduction), as 0-based line range. */
+    readonly introduction?: {
+        readonly start: number;
+        readonly end: number;
+        readonly text: string;
+    };
+};
 /**
  * A parsed Book document.
  *
  * @private Book language
  */
 export type BookDocument = {
-    /** Agent (name on first line), task (`TASK <title>`), empty or invalid document. */
-    readonly kind: 'agent' | 'task' | 'empty' | 'invalid';
-    /** Agent name or task title. */
+    /** Entity kind declared by the opening commitment; `invalid` without a valid declaration, `empty` for no text. */
+    readonly kind: EntityKind | 'empty' | 'invalid';
+    /** The entity's display name: the content of the opening declaration (or a legacy plain name line). */
     readonly name: string;
-    /** 0-based index of the identifying first nonempty line. */
+    /** Kind declared by the opening `AGENT`, `TASK` or `CHAT` commitment. */
+    readonly declaredKind?: EntityKind;
+    /** Former syntax found in the source (diagnosed; converted only by `ptbk migrate`). */
+    readonly legacy?: LegacySource;
+    /** 0-based index of the opening line. */
     readonly headerLine: number;
-    /** Natural text between the header and the first commitment (trimmed). */
-    readonly intro: string;
-    /** Commitments in source order. */
+    /** Commitments after the opening declaration, in source order. */
     readonly commitments: readonly BookCommitment[];
     /** Problems found while reading. */
     readonly diagnostics: readonly BookDiagnostic[];
@@ -59,9 +87,18 @@ export type BookDocument = {
     readonly newline: '\n' | '\r\n';
 };
 /**
- * Reads a Book source: identifies the document kind and its commitments.
+ * Detects a fence opener/closer (``` or ~~~).
+ *
+ * @private Book language
+ */
+export declare function fenceMarker(line: string): string | undefined;
+/**
+ * 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
  */