ptbk 0.119.0-17 → 0.119.0-21

package/dist/cli/commands/boilerplates.js

@@ -5,7 +5,10 @@ import { ensureDirectory, pathExists, toProjectRelative } from '../../common/fs.
 import { loadSettings, setting } from '../../project/config.js';
 import { commitPaths, inspectGit } from '../../project/git.js';
 import { newTaskPath } from '../../tasks/authoring.js';
-import { selectedProject, writableTasksDirectory } from '../common.js';
+import { generatedName } from '../../tasks/identity.js';
+import { parseBook } from '../../book/parse.js';
+import { normalizeAgentName } from '../../book/references.js';
+import { projectTakenNames, selectedProject, writableTasksDirectory } from '../common.js';
 import { flag, option } from '../context.js';
 /**
  * `ptbk generate-boilerplates`: unfinished, non-runnable placeholders (`@@@`) to fill in later.
@@ -24,7 +27,7 @@ export default async function generateBoilerplates(context) {
     if (files < 1 || sections < 1 || files > 100 || sections > 50)
         throw usageError('--count must be between 1 and 100 files and 1 to 50 sections.', 'generate-boilerplates');
     const templateName = option(context, 'template');
-    let template = 'TASK @@@\n\n@@@\n';
+    let template = 'TASK @@@\nGOAL @@@\n';
     if (templateName) {
         const path = join(tasksDirectory, 'templates', templateName.endsWith('.book') ? templateName : `${templateName}.book`);
         if (!(await pathExists(path)))
@@ -34,10 +37,18 @@ export default async function generateBoilerplates(context) {
     await ensureDirectory(tasksDirectory);
     const created = [];
     const timeZone = setting(settings, 'timezone');
+    const taken = await projectTakenNames(project, settings);
     for (let index = 0; index < files; index++) {
         if (sections === 1) {
             const path = await newTaskPath(tasksDirectory, `boilerplate ${index + 1}`, Date.now(), timeZone);
-            await writeFile(path, template.includes('@@@') ? template : `TASK @@@\n\n${template}`, { flag: 'wx' });
+            // Each placeholder gets its own generated name, so boilerplates never shadow each other.
+            const document = parseBook(template);
+            const base = document.kind === 'task' && document.name ? document.name : '@@@';
+            const name = generatedName(/@@@/.test(base) ? base : `@@@ ${base}`, { taken, timeZone });
+            taken.add(normalizeAgentName(name));
+            const lines = document.kind === 'task' ? [...document.lines] : ['', ...template.split(/\r?\n/)];
+            lines[document.kind === 'task' ? document.headerLine : 0] = `TASK ${name}`;
+            await writeFile(path, `${lines.join('\n').replace(/\n*$/, '')}\n`, { flag: 'wx' });
             created.push(path);
         }
         else {

package/dist/cli/commands/boilerplates.js.map

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

package/dist/cli/commands/chat.d.ts

@@ -0,0 +1,9 @@
+import { type CommandContext } from '../context.js';
+/**
+ * `ptbk chat`: directly open a new persistent conversation with one agent, reopen a named one, or list chats.
+ *
+ * No dashboard is required; Ctrl+C closes only this client (the service and the conversation stay).
+ *
+ * @private command
+ */
+export default function chat(context: CommandContext): Promise<number>;

package/dist/cli/commands/chat.js

@@ -0,0 +1,89 @@
+import { EXIT, PtbkError } from '../../common/errors.js';
+import { renderChatList, runChatClient } from '../../ui/chat-client.js';
+import { CANCELLED } from '../../ui/prompts.js';
+import { defaultChatAgent } from '../../chats/service.js';
+import { explicitChatAgent, openChatSource, pickChatAgent, waitForReply } from '../chats.js';
+import { printJson, readStdin, selectedProject } from '../common.js';
+import { flag, option } from '../context.js';
+/**
+ * Longest wait for the agent's reply in noninteractive use.
+ */
+const REPLY_WAIT_MS = 10 * 60_000;
+/**
+ * `ptbk chat`: directly open a new persistent conversation with one agent, reopen a named one, or list chats.
+ *
+ * No dashboard is required; Ctrl+C closes only this client (the service and the conversation stay).
+ *
+ * @private command
+ */
+export default async function chat(context) {
+    const { terminal } = context;
+    const project = await selectedProject(context);
+    let replyError;
+    const { source, service, local } = await openChatSource(context, project, { onReplyError: (error) => (replyError = error) });
+    if (flag(context, 'list')) {
+        const chats = await source.list();
+        if (flag(context, 'json'))
+            printJson(chats);
+        else
+            terminal.write(renderChatList(chats));
+        return EXIT.success;
+    }
+    let message = context.positionals.join(' ');
+    if (flag(context, 'stdin'))
+        message = (await readStdin()).replace(/\s+$/, '');
+    const open = option(context, 'open');
+    if (open !== undefined) {
+        const detail = await source.get(open);
+        if (terminal.interactive && !message && flag(context, 'json') !== true) {
+            await runChatClient(terminal, source, { kind: 'existing', name: detail.summary.name });
+            if (!service && local?.pendingReplies)
+                terminal.write(terminal.style.muted('Chat closed; saving the reply in progress before exiting (Ctrl+C abandons it, the service replies later).\n'));
+            return EXIT.success;
+        }
+        if (message) {
+            const sent = await source.send(detail.summary.name, message, detail.messages.length);
+            terminal.write(`Sent to {{${sent.name}}}${sent.commit ? ` (${sent.commit.slice(0, 8)})` : ''}.\n`);
+            return EXIT.success;
+        }
+        await source.read(detail.summary.name);
+        if (flag(context, 'json'))
+            printJson(detail);
+        else
+            terminal.write(`${detail.summary.name} (${detail.summary.status})\n${detail.messages.map((item) => `\n${item.sender} ${item.at}\n${item.text}${item.choices?.length ? `\n» ${item.choices.join('\n» ')}` : ''}`).join('\n')}\n`);
+        return EXIT.success;
+    }
+    const agents = await source.agents();
+    const agentOption = option(context, 'agent');
+    let agent;
+    if (agentOption)
+        agent = explicitChatAgent(agents, agentOption);
+    else if (terminal.interactive) {
+        const picked = await pickChatAgent(terminal, agents);
+        if (picked === CANCELLED) {
+            terminal.write('No chat was started.\n');
+            return EXIT.incomplete;
+        }
+        agent = picked;
+    }
+    else
+        agent = defaultChatAgent(agents);
+    const title = option(context, 'title');
+    if (terminal.interactive && !message) {
+        await runChatClient(terminal, source, { kind: 'new', agent, title });
+        if (!service && local?.pendingReplies)
+            terminal.write(terminal.style.muted('Chat closed; saving the reply in progress before exiting (Ctrl+C abandons it, the service replies later).\n'));
+        return EXIT.success;
+    }
+    if (!message)
+        throw new PtbkError('The first message is required without an interactive terminal.', { kind: 'usage', next: ['Pass it as an argument or use --stdin.'] });
+    const created = await source.create(agent.reference, message, title);
+    terminal.write(`Started the chat {{${created.name}}}${created.commit ? ` (${created.commit.slice(0, 8)})` : ''}.\n`);
+    const reply = await waitForReply(source, created.name, 1, REPLY_WAIT_MS, () => replyError);
+    if (reply)
+        terminal.write(`\n${reply.sender}:\n${reply.text}\n`);
+    else
+        terminal.write(`No reply yet${replyError ? `: ${replyError}` : ''}. Continue with \`ptbk chat --open "${created.name}"\`.\n`);
+    return EXIT.success;
+}
+//# sourceMappingURL=chat.js.map

package/dist/cli/commands/chat.js.map

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

package/dist/cli/commands/dashboard.d.ts

@@ -1,6 +1,8 @@
 import { type CommandContext } from '../context.js';
 /**
- * `ptbk dashboard`: attach a live view to the existing service (never starts or initializes anything).
+ * `ptbk dashboard`: attach a live view to the existing service (never starts or initializes anything); with
+ * `--global`, the host-wide overview of every running engine. A service of an incompatible ptbk version is shown by
+ * its own installation.
  *
  * @private command
  */

package/dist/cli/commands/dashboard.js

@@ -1,15 +1,51 @@
-import { EXIT, PtbkError } from '../../common/errors.js';
+import { EXIT, PtbkError, usageError } from '../../common/errors.js';
+import { projectAt } from '../../project/workspace.js';
 import { lookupService } from '../../service/control.js';
 import { runDashboard } from '../../ui/dashboard.js';
+import { runGlobalDashboard } from '../../ui/global-dashboard.js';
 import { selectedProject } from '../common.js';
 import { flag } from '../context.js';
+import { delegateToEngine } from '../engine-delegation.js';
 import { controlSource } from '../sources.js';
 /**
- * `ptbk dashboard`: attach a live view to the existing service (never starts or initializes anything).
+ * `ptbk dashboard --global`: the host-wide live table of running engines, independent of the current directory. It
+ * never initializes or selects that directory, never starts a worker and never acquires a project lock; attaching
+ * opens the selected project's ordinary dashboard and returns to the table.
+ */
+async function globalDashboard(context) {
+    for (const name of ['path', 'tasks']) {
+        if (context.explicit.has(name))
+            throw usageError(`--global observes every project; --${name} would select one project.`, 'dashboard', 'Use `ptbk dashboard --path <dir>` for one project, or `ptbk dashboard --global` for all of them.');
+    }
+    const noQr = flag(context, 'qr') === false;
+    await runGlobalDashboard(context.terminal, async (row) => {
+        // Resolve the target from verified discovery information, never from the launch directory.
+        const project = projectAt(row.entry.projectRoot);
+        const lookup = await lookupService(project);
+        if (lookup.state !== 'running')
+            return `${row.entry.projectName} is no longer running${lookup.state === 'unreachable' ? ` (${lookup.reason})` : ''}; nothing was started.`;
+        if (lookup.record.instanceId !== row.entry.instanceId)
+            return `${row.entry.projectName} is now owned by another engine instance; select its new row to attach.`;
+        if (!lookup.engine.compatible) {
+            // Another engine version renders its own dashboard, so the view keeps that engine's version and shape.
+            await delegateToEngine(project, lookup, ['dashboard', '--path', project.root, ...(noQr ? ['--no-qr'] : [])], context.cwd, context.env);
+            return undefined;
+        }
+        await runDashboard(context.terminal, controlSource(lookup.client), { noQr });
+        return undefined;
+    }, context.env);
+    return EXIT.success;
+}
+/**
+ * `ptbk dashboard`: attach a live view to the existing service (never starts or initializes anything); with
+ * `--global`, the host-wide overview of every running engine. A service of an incompatible ptbk version is shown by
+ * its own installation.
  *
  * @private command
  */
 export default async function dashboard(context) {
+    if (flag(context, 'global'))
+        return await globalDashboard(context);
     const project = await selectedProject(context);
     const lookup = await lookupService(project);
     if (lookup.state === 'stopped') {
@@ -17,12 +53,14 @@ export default async function dashboard(context) {
             kind: 'not-found',
             project: project.root,
             effect: 'Nothing was started; the dashboard only attaches to an existing service.',
-            next: ['Start the agenda with `ptbk start`, then run `ptbk dashboard` again.'],
+            next: ['Start the agenda with `ptbk start`, then run `ptbk dashboard` again.', 'See every running project with `ptbk dashboard --global`.'],
         });
     }
     if (lookup.state === 'unreachable') {
         throw new PtbkError('The recorded ptbk service does not answer.', { kind: 'technical', project: project.root, reason: lookup.reason, next: ['Run `ptbk status` to inspect it, or `ptbk restart`.'] });
     }
+    if (!lookup.engine.compatible)
+        return await delegateToEngine(project, lookup, context.argv, context.cwd, context.env);
     await runDashboard(context.terminal, controlSource(lookup.client), { noQr: flag(context, 'qr') === false });
     return EXIT.success;
 }

package/dist/cli/commands/dashboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/cli/commands/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAuB,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,SAAS,CAAC,OAAuB;IAC3D,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,8CAA8C,EAAE;YAChE,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,MAAM,EAAE,0EAA0E;YAClF,IAAI,EAAE,CAAC,sEAAsE,CAAC;SACjF,CAAC,CAAC;IACP,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,qDAAqD,CAAC,EAAE,CAAC,CAAC;IAC1M,CAAC;IACD,MAAM,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC5G,OAAO,IAAI,CAAC,OAAO,CAAC;AACxB,CAAC"}
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/cli/commands/dashboard.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/find.js

@@ -4,9 +4,8 @@ import { toProjectRelative } from '../../common/fs.js';
 import { loadSettings, setting } from '../../project/config.js';
 import { commitPaths, inspectGit, listProjectFiles } from '../../project/git.js';
 import { newTaskPath, renderTaskBook } from '../../tasks/authoring.js';
-import { generateTaskId } from '../../tasks/identity.js';
 import { readTaskQueue } from '../../tasks/sources.js';
-import { printJson, selectedProject, writableTasksDirectory } from '../common.js';
+import { generatedTaskName, printJson, selectedProject, writableTasksDirectory } from '../common.js';
 import { flag, option } from '../context.js';
 /**
  * `ptbk find-unwritten`: tasks still containing the `@@@` placeholder (read-only).
@@ -59,23 +58,22 @@ export async function findRefactorCandidates(context) {
     if (flag(context, 'create-tasks') && top.length) {
         const tasksDirectory = await writableTasksDirectory(context, project, settings);
         const created = [];
-        const ids = [];
+        const names = [];
         for (const candidate of top) {
             const path = await newTaskPath(tasksDirectory, `refactor ${candidate.path}`, Date.now(), setting(settings, 'timezone'));
-            const id = generateTaskId(`refactor ${candidate.path}`);
+            const title = await generatedTaskName(project, settings, `Refactor ${candidate.path}`, names);
             await writeFile(path, renderTaskBook({
-                title: `Refactor ${candidate.path}`,
+                title,
                 description: `\`${candidate.path}\` has ${candidate.lines} lines. Split it into cohesive, well-named units without changing behavior; keep tests passing.`,
-                id,
                 commitments: ['TASK PRIORITY 0', 'TASK ORIGIN refactor candidate'],
             }), { flag: 'wx' });
             created.push(path);
-            ids.push(id);
+            names.push(title);
         }
         const gitInfo = await inspectGit(project.root);
         const commit = flag(context, 'commit') ?? setting(settings, 'execution.commit');
         if (commit && gitInfo.state === 'repository')
-            await commitPaths({ projectRoot: project.root, repositoryRoot: gitInfo.root, paths: created, subject: `Add ${created.length} refactoring task(s)`, trailers: { 'Task-ID': ids }, temporaryDirectory: project.runtime.temporary, env: context.env });
+            await commitPaths({ projectRoot: project.root, repositoryRoot: gitInfo.root, paths: created, subject: `Add ${created.length} refactoring task(s)`, trailers: { 'Task-Name': names }, temporaryDirectory: project.runtime.temporary, env: context.env });
         context.terminal.write(`Created ${created.length} refactoring task(s).\n`);
     }
     if (flag(context, 'json'))

package/dist/cli/commands/find.js.map

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

package/dist/cli/commands/fix.js

@@ -5,10 +5,9 @@ import { ensureDirectory } from '../../common/fs.js';
 import { runCheck, validateCheckCommand } from '../../project/checks.js';
 import { loadSettings, setting } from '../../project/config.js';
 import { newTaskPath, renderTaskBook } from '../../tasks/authoring.js';
-import { generateTaskId } from '../../tasks/identity.js';
 import { lookupService } from '../../service/control.js';
 import { ServiceHost } from '../../service/host.js';
-import { selectedProject, settingOverrides, tasksOverride, writableTasksDirectory } from '../common.js';
+import { generatedTaskName, selectedProject, settingOverrides, tasksOverride, writableTasksDirectory } from '../common.js';
 import { flag, option } from '../context.js';
 /**
  * `ptbk fix`: run the project check; repair only failing validation (never the ordinary queue).
@@ -41,15 +40,14 @@ export default async function fix(context) {
     await ensureDirectory(tasksDirectory);
     const taskPath = await newTaskPath(tasksDirectory, 'repair failing project check', Date.now(), setting(settings, 'timezone'));
     const agent = option(context, 'agent') ?? setting(settings, 'routing.defaultAgent');
-    const commitments = [`TASK AGENT ${agent.startsWith('@') || agent.startsWith('{') ? agent : `{${agent}}`}`, 'TASK ORIGIN maintenance: failing project check'];
+    const commitments = [`TASK AGENT ${agent.startsWith('@') || agent.startsWith('{') ? agent : `{{${agent}}}`}`, 'TASK ORIGIN maintenance: failing project check'];
     if (option(context, 'harness'))
         commitments.push(`TASK HARNESS ${option(context, 'harness')}`);
     if (option(context, 'model'))
         commitments.push(`TASK MODEL ${option(context, 'model')}`);
     await writeFile(taskPath, renderTaskBook({
-        title: 'Repair the failing project check',
+        title: await generatedTaskName(project, settings, 'Repair the failing project check'),
         description: `The project check \`${check}\` fails (exit ${String(result.exitCode)}). Fix the underlying defects without weakening validation: do not delete assertions, disable rules, lower thresholds or skip checks.\n\nCheck output (tail):\n\n\`\`\`\n${result.output.slice(-6000)}\n\`\`\``,
-        id: generateTaskId('repair failing project check'),
         commitments,
     }), { flag: 'wx' });
     const harness = option(context, 'harness') ?? setting(settings, 'routing.harness') ?? Object.entries(settings.harnesses).find(([, value]) => value.enabled)?.[0];
@@ -63,7 +61,7 @@ export default async function fix(context) {
         tasksDirectory: tasksOverride(context),
         persistent: null,
         allowTunnelInstall: false,
-        run: { selection: { agent: agent.startsWith('@') || agent.startsWith('{') ? agent : `{${agent}}`, harness, model: option(context, 'model') } },
+        run: { selection: { agent: agent.startsWith('@') || agent.startsWith('{') ? agent : `{{${agent}}}`, harness, model: option(context, 'model') } },
         onEvent: (text, level) => terminal.write(`${clockTime()} ${level === 'info' ? '' : `${level.toUpperCase()}: `}${text}\n`),
     });
     await host.start();

package/dist/cli/commands/fix.js.map

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

package/dist/cli/commands/init.d.ts

@@ -16,7 +16,6 @@ export type InitResult = {
     readonly commit?: string;
     /** The ordinary Expert bootstrap task created by this run. */
     readonly firstTask?: {
-        readonly id: string;
         readonly title: string;
         readonly path: string;
     };

package/dist/cli/commands/init.js

@@ -1,9 +1,11 @@
 import { readFile, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
 import { dirname, join, relative, resolve, sep } from 'node:path';
 import { EXIT, PtbkError, errorMessage, usageError } from '../../common/errors.js';
 import { ensureDirectory, isDirectory, pathExists, toProjectRelative } from '../../common/fs.js';
 import { ENGINE_VERSION } from '../../common/version.js';
+import { describeBrowserProfile, userChromeProfile } from '../../browser/browser.js';
+import { BookIndex } from '../../project/books.js';
+import { generatedName } from '../../tasks/identity.js';
 import { checkCandidates, validateCheckCommand } from '../../project/checks.js';
 import { enabledHarnesses, getPath, loadSettings, readProjectConfigFile, setting, updateProjectConfig } from '../../project/config.js';
 import { INITIAL_ASSETS, INITIAL_SPECIFICATION, bootstrapTask, sampleReadme } from '../../project/defaults.js';
@@ -19,7 +21,6 @@ import { checkHarnessVersion, installHarness, loginHarness, updateHarness } from
 import { lookupService } from '../../service/control.js';
 import { launchDaemon } from '../../service/launcher.js';
 import { newTaskPath, renderTaskBook } from '../../tasks/authoring.js';
-import { generateTaskId } from '../../tasks/identity.js';
 import { wrap } from '../../ui/ansi.js';
 import { materializeAttachments, isImagePath } from '../../ui/attachments.js';
 import { celebrate } from '../../ui/celebration.js';
@@ -28,6 +29,7 @@ import { CANCELLED, composeRich, confirm, inputLine, selectMany, selectOne, togg
 import { symbols } from '../../ui/terminal.js';
 import { readStdin, settingOverrides, tasksOverride, validateCombinations } from '../common.js';
 import { flag, option } from '../context.js';
+import { liveSnapshot } from '../service-view.js';
 /**
  * Raised when the user abandons the wizard (Ctrl+C); completed steps are kept, nothing further is applied.
  */
@@ -51,16 +53,6 @@ function answered(value) {
         throw wasInterrupted() ? new WizardCancelled('cancelled') : new WizardBack('back');
     return value;
 }
-/**
- * Default Chrome user-data directory of this platform.
- */
-function defaultChromeProfile() {
-    if (process.platform === 'darwin')
-        return join(homedir(), 'Library', 'Application Support', 'Google', 'Chrome');
-    if (process.platform === 'win32')
-        return join(process.env.LOCALAPPDATA ?? join(homedir(), 'AppData', 'Local'), 'Google', 'Chrome', 'User Data');
-    return join(homedir(), '.config', 'google-chrome');
-}
 /**
  * Titles of the user-facing steps.
  */
@@ -441,22 +433,28 @@ export async function initializeProject(context, options = {}) {
             shown.add('browser');
             const choice = answered(await selectOne(terminal, {
                 frame: frame('browser', 'agents share one browser for websites'),
-                question: 'Which browser profile should agents share for websites in this project?',
+                question: 'Which browser profile should agents use for websites in this project?',
                 choices: [
-                    { value: 'isolated', label: 'Isolated project profile', description: 'persistent profile in .ptbk/, separate from your browser' },
-                    { value: 'other', label: 'Another existing profile', description: 'e.g. a profile shared by several projects' },
-                    { value: 'user', label: 'Your Chrome profile', description: 'reuses your logged-in sessions' },
+                    { value: 'global', label: 'Dedicated Promptbook profile', description: 'a separate Promptbook-only profile, reused by your other projects (one project at a time); not your Chrome profile' },
+                    { value: 'isolated', label: 'Isolated project profile', description: 'only this project, stored in .ptbk/ (Git-ignored)' },
+                    { value: 'user', label: 'Your Chrome profile', description: 'reuses your logged-in sessions; agents act as you' },
+                    { value: 'custom', label: 'Custom profile path', description: 'another existing browser profile directory' },
                 ],
-                defaultValue: 'isolated',
+                defaultValue: 'global',
             }));
-            if (choice === 'other')
-                state.browserProfile = answered(await inputLine(terminal, { frame: frame('browser'), question: 'Path of the browser profile directory:' }));
+            if (choice === 'custom') {
+                state.browserProfile = answered(await inputLine(terminal, {
+                    frame: frame('browser'),
+                    question: 'Path of the existing browser profile directory:',
+                    validate: (value) => (!value.trim() ? 'Enter a path.' : ['global', 'isolated', 'user'].includes(value.trim()) ? 'Choose that option instead of typing its name.' : undefined),
+                })).trim();
+            }
             else if (choice === 'user') {
-                const ok = answered(await confirm(terminal, { frame: frame('browser'), question: `Agents will act with every session in ${defaultChromeProfile()}, and their actions affect that profile. Use it?`, defaultYes: false }));
-                state.browserProfile = ok ? defaultChromeProfile() : 'isolated';
+                const ok = answered(await confirm(terminal, { frame: frame('browser'), question: `Agents will act with every session in ${userChromeProfile()} and their actions affect that profile; Chrome must be closed while they use it. Use it?`, defaultYes: false }));
+                state.browserProfile = ok ? 'user' : 'global';
             }
             else
-                state.browserProfile = 'isolated';
+                state.browserProfile = choice;
             state.browserMode = answered(await selectOne(terminal, {
                 frame: frame('browser'),
                 question: 'Browser visibility:',
@@ -466,7 +464,7 @@ export async function initializeProject(context, options = {}) {
                 ],
                 defaultValue: state.browserMode ?? 'headless',
             }));
-            answers.set('browser', `Browser: ${state.browserProfile === 'isolated' ? 'isolated project profile' : state.browserProfile}, ${state.browserMode}`);
+            answers.set('browser', `Browser: ${describeBrowserProfile(state.browserProfile ?? 'global')}, ${state.browserMode}`);
         },
         // 7. Trace recording and Git inclusion (three explicit project choices).
         traces: async () => {
@@ -489,7 +487,7 @@ export async function initializeProject(context, options = {}) {
             state.traces = answered(await toggleList(terminal, {
                 frame: frame('traces', 'every task keeps its own audit trail'),
                 question: 'Traces: how should task evidence be kept?',
-                intro: 'Each task records its harness output, events and (when enabled) browser video in traces/<task-id>/, linked to its commits by Task-ID. Traces can contain project data and page content; sign-in steps are not recorded.',
+                intro: 'Each task records its harness output, events and (when enabled) browser video in traces/<task-file-basename>/, linked to its commits by the Task-Name trailer. Traces can contain project data and page content; sign-in steps are not recorded.',
                 toggles: [
                     { key: 'commit', label: 'Commit traces to Git', description: 'include each task’s traces in its result commit (shared with everyone who can read the repository); otherwise traces stay local and the whole traces/ folder is ignored' },
                     { key: 'ignoreVideos', label: 'Ignore trace videos in Git', description: 'keep browser videos local even when traces are committed (videos are large and may show sensitive pages)' },
@@ -755,10 +753,11 @@ export async function initializeProject(context, options = {}) {
     const traceIgnore = await ensureTraceIgnoreRules(root, savedPolicy && configBefore?.raw.traces ? savedPolicy : tracePolicy);
     if (traceIgnore)
         createdPaths.push(traceIgnore);
-    for (const path of await ensureCoreAgents(root, agentsDirectory))
-        createdPaths.push(path);
+    // Default roles first: a missing Chatter's initial TEAM covers the completed role set.
     for (const path of await ensureDefaultRoles(root, agentsDirectory))
         createdPaths.push(path);
+    for (const path of await ensureCoreAgents(root, agentsDirectory))
+        createdPaths.push(path);
     for (const path of await ensureTemplates(root, tasksDirectory))
         createdPaths.push(path);
     await ensureDirectory(join(root, tasksDirectory));
@@ -834,7 +833,7 @@ export async function initializeProject(context, options = {}) {
     if (state.saveCheck !== undefined)
         settingsChanges['execution.check'] = state.saveCheck;
     if (!rawConfig.browser || option(context, 'browser-profile') !== undefined)
-        settingsChanges['browser.profile'] = state.browserProfile ?? 'isolated';
+        settingsChanges['browser.profile'] = state.browserProfile ?? 'global';
     if (!rawConfig.browser || option(context, 'browser-mode') !== undefined)
         settingsChanges['browser.mode'] = state.browserMode ?? 'headless';
     for (const [key, value] of [
@@ -859,21 +858,22 @@ export async function initializeProject(context, options = {}) {
     const marker = ((await readProjectConfigFile(project)).raw.initialized ?? {});
     let firstTask;
     const tasksRoot = join(root, tasksDirectory);
-    if (newPurpose && !marker.starterTask && !(await hasFirstTask({ root, tasksDirectory, timeZone, knownIds: [] }))) {
+    if (newPurpose && !marker.starterTask && !(await hasFirstTask({ root, tasksDirectory, timeZone }))) {
         const blank = blankIntent(state.intent?.segments ?? []);
         const specification = join(root, INITIAL_SPECIFICATION);
         const draftPath = await newTaskPath(tasksRoot, blank ? 'review initialized project' : 'transform project', Date.now(), timeZone);
         const link = relative(dirname(draftPath), specification).split(sep).join('/');
         const content = bootstrapTask({ blank, specificationLink: link });
-        const id = generateTaskId(blank ? 'readiness review' : 'bootstrap');
-        await writeFile(draftPath, renderTaskBook({ title: content.title, description: content.description, id, commitments: ['TASK AGENT @Expert', 'TASK ORIGIN initialization'] }), { flag: 'wx' });
+        // A generated name: the readable title plus creation date/time, distinct from every Book of the project.
+        const title = generatedName(content.title, { taken: (await BookIndex.load(root, { agents: agentsDirectory, tasks: tasksDirectory })).names(), timeZone });
+        await writeFile(draftPath, renderTaskBook({ title, description: content.description, commitments: ['TASK AGENT @Expert', 'TASK ORIGIN initialization'] }), { flag: 'wx' });
         createdPaths.push(draftPath);
-        firstTask = { id, title: content.title, path: draftPath };
+        firstTask = { title, path: draftPath };
     }
     const effectiveInstallation = installation === 'existing' ? (marker.installation ?? 'local') : installation;
     if (firstTask || !marker.engineVersion || marker.installation !== effectiveInstallation) {
         const raw = (await readProjectConfigFile(project)).raw;
-        raw.initialized = { ...raw.initialized, engineVersion: marker.engineVersion ?? ENGINE_VERSION, ...(firstTask ? { starterTask: firstTask.id } : {}), installation: effectiveInstallation };
+        raw.initialized = { ...raw.initialized, engineVersion: marker.engineVersion ?? ENGINE_VERSION, ...(firstTask ? { starterTask: firstTask.title } : {}), installation: effectiveInstallation };
         await writeFile(project.configPath, `${JSON.stringify(raw, null, 4)}\n`);
         createdPaths.push(project.configPath);
     }
@@ -893,7 +893,7 @@ export async function initializeProject(context, options = {}) {
                     repositoryRoot: repository.repositoryRoot,
                     paths: uniquePaths,
                     subject: configBefore ? 'Update project setup' : 'Initialize project',
-                    trailers: { 'Task-ID': firstTask ? [firstTask.id] : [] },
+                    trailers: { 'Task-Name': firstTask ? [firstTask.title] : [] },
                     temporaryDirectory: project.runtime.temporary,
                     env: context.env,
                 });
@@ -940,16 +940,16 @@ async function startService(context, project) {
         const overrides = settingOverrides(context);
         const existing = await lookupService(project);
         if (existing.state === 'running') {
-            return { kind: 'reused', snapshot: await existing.client.request('snapshot'), note: `The ${existing.record.mode} service (PID ${existing.record.pid}) was already running and keeps its configuration.` };
+            return { kind: 'reused', snapshot: await liveSnapshot(project, existing), note: `The ${existing.record.mode} service (PID ${existing.record.pid}) was already running and keeps its configuration.` };
         }
         const settings = await loadSettings(project, { env: context.env, cli: overrides });
         const persistent = setting(settings, 'service.persist');
         const launched = await launchDaemon(project, { cli: overrides, tasksDirectory: tasksOverride(context), persistent, env: context.env });
-        let snapshot = await launched.lookup.client.request('snapshot');
+        let snapshot = await liveSnapshot(project, launched.lookup);
         const deadline = Date.now() + 10_000;
-        while (snapshot.service.state === 'starting' && Date.now() < deadline) {
+        while (snapshot.phase === 'starting' && Date.now() < deadline) {
             await new Promise((resolvePromise) => setTimeout(resolvePromise, 300));
-            snapshot = await launched.lookup.client.request('snapshot');
+            snapshot = await liveSnapshot(project, launched.lookup);
         }
         return { kind: launched.started ? 'started' : 'reused', snapshot, note: launched.persistence?.note ?? (persistent ? undefined : 'Restart persistence is disabled (--no-persist).') };
     }
@@ -988,7 +988,7 @@ function renderInitSummary(context, input) {
         : ready
             ? [['ptbk start', service?.kind === 'failed' ? 'start the service after fixing the problem above' : 'start the agenda in the background']]
             : [['ptbk init', 'resume setup after resolving the items above']];
-    const first = result.firstTask ? `${result.firstTask.title} → Expert (Task-ID ${result.firstTask.id}, ${toProjectRelative(root, result.firstTask.path)})` : undefined;
+    const first = result.firstTask ? `{{${result.firstTask.title}}} → Expert (${toProjectRelative(root, result.firstTask.path)})` : undefined;
     const headline = !ready ? 'Setup incomplete' : running ? 'Project ready · agenda running' : 'Setup complete · service not running';
     if (!terminal.pretty) {
         const lines = [`${headline}: ${root} (ptbk ${ENGINE_VERSION})`];