@productbrain/cli 0.1.0-beta.1398 → 0.1.0-beta.13982

package/dist/lib/upgrade-runner.js

@@ -1,8 +1,7 @@
-import { spawn } from 'node:child_process';
-import { basename, dirname } from 'node:path';
+import { execFileSync, spawn } from 'node:child_process';
+import { realpathSync } from 'node:fs';
+import { basename, dirname, sep } from 'node:path';
 import { CLIError, ErrorCode } from './errors.js';
-import { UPGRADE_COMMAND } from './constants.js';
-import { trackEvent } from './telemetry.js';
 import { writeUpgradePendingSentinel } from './update-check.js';
 function pathSegments(path) {
     const segments = [];
@@ -13,43 +12,78 @@ function pathSegments(path) {
     }
     return segments;
 }
-export function detectInstallChannel(execPath = process.execPath, env = process.env) {
-    const ua = env.npm_config_user_agent?.toLowerCase() ?? '';
-    if (ua.startsWith('pnpm'))
-        return 'pnpm';
-    if (ua.startsWith('yarn'))
-        return 'yarn';
-    if (ua.startsWith('bun'))
-        return 'bun';
-    if (ua.startsWith('npm'))
-        return 'npm';
-    const segments = pathSegments(execPath);
+/** The real path of the running pb script; a symlinked bin resolves to the package that holds it. */
+function runningPbPath() {
+    const script = process.argv[1] ?? '';
+    try {
+        return realpathSync(script);
+    }
+    catch {
+        return script;
+    }
+}
+/**
+ * TEN-3308: the installer is read from where pb itself lives, never from the node binary running it.
+ * A pb under Homebrew's prefix run by a proto or nvm node was upgraded into that node's prefix, so the
+ * old pb stayed first on PATH. An npm install also names its prefix, so the new pb replaces this one.
+ */
+export function detectPbInstall(pbPath = runningPbPath(), separator = sep, npmGlobalPrefix = readNpmGlobalPrefix) {
+    const segments = pathSegments(pbPath);
     if (segments.some((s) => s.includes('pnpm')))
-        return 'pnpm';
+        return { channel: 'pnpm' };
     if (segments.some((s) => s.includes('yarn')))
-        return 'yarn';
-    if (segments.some((s) => s.includes('bun')))
-        return 'bun';
-    if (segments.some((s) => s.includes('homebrew') || s === 'brew' || s === 'cellar'))
-        return 'brew';
-    if (segments.some((s) => s.includes('npm') || s === 'node_modules'))
-        return 'npm';
-    return 'unknown';
+        return { channel: 'yarn' };
+    if (segments.some((s) => s === '.bun' || s === 'bun'))
+        return { channel: 'bun' };
+    const marker = ['', 'node_modules', '@productbrain', 'cli', ''].join(separator);
+    const at = pbPath.indexOf(marker);
+    if (at < 0)
+        return { channel: 'unknown' };
+    // Only a global install gets --prefix (Reviewer F1 on #1937): a project-local pb or an npx cache
+    // also sits under node_modules, and `npm install -g --prefix <it>` would write bin/ and lib/ there.
+    // POSIX global installs live in <prefix>/lib/node_modules; on Windows <prefix>\node_modules, and
+    // that root counts only when it is npm's own global prefix. Anything else is the plain -g line.
+    const root = pbPath.slice(0, at);
+    if (separator === '/')
+        return root.endsWith('/lib') ? { channel: 'npm', prefix: root.slice(0, -'/lib'.length) } : { channel: 'unknown' };
+    const global = npmGlobalPrefix();
+    return global && global.toLowerCase() === root.toLowerCase() ? { channel: 'npm', prefix: root } : { channel: 'unknown' };
+}
+/** npm's global prefix, asked only on Windows where the path alone cannot tell a global install from a local one. */
+function readNpmGlobalPrefix() {
+    try {
+        return execFileSync('npm', ['prefix', '-g'], { encoding: 'utf8', shell: true, timeout: 10_000 }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * One shell word for the printed command (Codex P2 on #1937). The spawn passes an argv array and
+ * needs no quoting; the line a person or agent pastes does, or a prefix such as
+ * `C:\Users\Jane Doe\…` splits in two. Windows shells take double quotes, POSIX shells single quotes.
+ */
+export function shellWord(arg, platform = process.platform) {
+    if (/^[A-Za-z0-9_@%+=:,./-]+$/.test(arg))
+        return arg;
+    return platform === 'win32' ? `"${arg.replace(/"/g, '""')}"` : `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+/** The only builder of the display line: the same argv the spawn runs, each word quoted for a shell. */
+function upgradeCommand(channel, command, args, platform) {
+    return { channel, command, args, display: [command, ...args].map((a) => shellWord(a, platform)).join(' ') };
 }
-export function buildUpgradeCommand(channel, version) {
+export function buildUpgradeCommand({ channel, prefix }, version, platform = process.platform) {
     const spec = version ? `@productbrain/cli@${version}` : '@productbrain/cli@beta';
     switch (channel) {
         case 'pnpm':
-            return { channel, command: 'pnpm', args: ['add', '-g', spec], display: `pnpm add -g ${spec}` };
+            return upgradeCommand(channel, 'pnpm', ['add', '-g', spec], platform);
         case 'yarn':
-            return { channel, command: 'yarn', args: ['global', 'add', spec], display: `yarn global add ${spec}` };
+            return upgradeCommand(channel, 'yarn', ['global', 'add', spec], platform);
         case 'bun':
-            return { channel, command: 'bun', args: ['add', '-g', spec], display: `bun add -g ${spec}` };
-        case 'brew':
-            return { channel, command: 'brew', args: ['upgrade', 'productbrain'], display: 'brew upgrade productbrain' };
+            return upgradeCommand(channel, 'bun', ['add', '-g', spec], platform);
         case 'npm':
         case 'unknown':
-            return { channel, command: 'npm', args: ['install', '-g', spec], display: version ? `npm install -g ${spec}` : UPGRADE_COMMAND };
+            return upgradeCommand(channel, 'npm', ['install', '-g', ...(prefix ? ['--prefix', prefix] : []), spec], platform);
     }
 }
 function failureGuidance(message) {
@@ -62,10 +96,9 @@ function failureGuidance(message) {
     }
     return 'Run the displayed upgrade command manually, then retry pb doctor.';
 }
-export function spawnUpgrade(channel = detectInstallChannel(), options = {}) {
-    const spec = buildUpgradeCommand(channel, options.version);
+export function spawnUpgrade(install = detectPbInstall(), options = {}) {
+    const spec = buildUpgradeCommand(install, options.version);
     const output = [];
-    trackEvent('cli.upgrade.initiated', { channel: spec.channel });
     return new Promise((resolve, reject) => {
         const child = spawn(spec.command, spec.args, {
             env: options.env ?? process.env,
@@ -82,7 +115,6 @@ export function spawnUpgrade(channel = detectInstallChannel(), options = {}) {
         child.stderr?.on('data', emit);
         child.on('error', (err) => {
             const message = err.message || `Failed to spawn ${spec.display}`;
-            trackEvent('cli.upgrade.failed', { channel: spec.channel, reason: err.code ?? 'spawn_error' });
             reject(new CLIError(`Upgrade failed: ${message}`, {
                 code: ErrorCode.UPGRADE_FAILED,
                 category: 'internal',
@@ -93,7 +125,6 @@ export function spawnUpgrade(channel = detectInstallChannel(), options = {}) {
             const exitCode = code ?? 1;
             if (exitCode !== 0) {
                 const message = output.slice(-4).join('\n') || `${spec.display} exited with code ${exitCode}`;
-                trackEvent('cli.upgrade.failed', { channel: spec.channel, exitCode });
                 reject(new CLIError(`Upgrade failed: ${message}`, {
                     code: ErrorCode.UPGRADE_FAILED,
                     category: 'internal',
@@ -102,7 +133,6 @@ export function spawnUpgrade(channel = detectInstallChannel(), options = {}) {
                 return;
             }
             writeUpgradePendingSentinel(options.version);
-            trackEvent('cli.upgrade.succeeded', { channel: spec.channel });
             resolve({ channel: spec.channel, command: spec.display, exitCode, output });
         });
     });

package/dist/lib/upgrade-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade-runner.js","sourceRoot":"","sources":["../../src/lib/upgrade-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upgrade-runner.js","sourceRoot":"","sources":["../../src/lib/upgrade-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AA2BhE,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,IAAI,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qGAAqG;AACrG,SAAS,aAAa;IACpB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC;QAAC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,MAAM,CAAC;IAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAM,GAAG,aAAa,EAAE,EAAE,SAAS,GAAG,GAAG,EAAE,kBAAuC,mBAAmB;IACnI,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACzE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACzE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACjF,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChF,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC1C,iGAAiG;IACjG,oGAAoG;IACpG,iGAAiG;IACjG,gGAAgG;IAChG,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjC,IAAI,SAAS,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACzI,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,OAAO,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC3H,CAAC;AAED,qHAAqH;AACrH,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAClH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,WAA4B,OAAO,CAAC,QAAQ;IACjF,IAAI,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACrD,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACnG,CAAC;AAED,wGAAwG;AACxG,SAAS,cAAc,CAAC,OAAuB,EAAE,OAAe,EAAE,IAAc,EAAE,QAAyB;IACzG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC9G,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAa,EAAE,OAAgB,EAAE,WAA4B,OAAO,CAAC,QAAQ;IAChI,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC;IACjF,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QACxE,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5E,KAAK,KAAK;YACR,OAAO,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QACvE,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACpE,OAAO,yKAAyK,CAAC;IACnL,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACpH,OAAO,iHAAiH,CAAC;IAC3H,CAAC;IACD,OAAO,mEAAmE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,UAAqB,eAAe,EAAE,EACtC,UAA+B,EAAE;IAEjC,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;YAC3C,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;YAC/B,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE/B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,mBAAmB,IAAI,CAAC,OAAO,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,QAAQ,CAAC,mBAAmB,OAAO,EAAE,EAAE;gBAChD,IAAI,EAAE,SAAS,CAAC,cAAc;gBAC9B,QAAQ,EAAE,UAAU;gBACpB,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC;aACnC,CAAC,CAAC,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC;YAC3B,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,qBAAqB,QAAQ,EAAE,CAAC;gBAC9F,MAAM,CAAC,IAAI,QAAQ,CAAC,mBAAmB,OAAO,EAAE,EAAE;oBAChD,IAAI,EAAE,SAAS,CAAC,cAAc;oBAC9B,QAAQ,EAAE,UAAU;oBACpB,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC;iBACnC,CAAC,CAAC,CAAC;gBACJ,OAAO;YACT,CAAC;YACD,2BAA2B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/workPackageList.d.ts

@@ -0,0 +1,138 @@
+/** What orient adds to a row: the stored priority token (absent for No priority) and, on a team list only,
+ *  yours when the seat's role owns the package. */
+export type WorkPackageListMarks = {
+    priority?: string;
+    yours?: true;
+};
+/** Served only on a team list: the team's live packages, the live packages exactly one other team owns, and
+ *  the live packages with no owner or two or more (they belong to no team), so the three add up to the live total. */
+export type WorkPackageTeamCounts = {
+    team: number;
+    otherTeams: number;
+    noSingleOwner: number;
+};
+export declare const WORK_PACKAGE_LIST_WORDS: {
+    readonly yours: "[yours]";
+    /** Printed once under the heading when a row carries the mark, so a cold reader need not guess it (DEC-2445). */
+    readonly legend: "[yours] = a package your role owns";
+    readonly count: (shown: number, { team, otherTeams, noSingleOwner }: WorkPackageTeamCounts, allCommand: string) => string;
+    /** The command each surface names at the end of the count line: every live work package of the workspace, under listHeading. */
+    readonly allCommand: {
+        readonly cli: "pb brief confidence";
+        readonly mcp: "`context action=brief briefType=\"confidence\"`";
+    };
+    /** The heading of that command's list, so the count line and the list use one word. */
+    readonly listHeading: "Live work packages";
+    /** That list's last line when it stopped at its cap; the brief has no way to continue past it. */
+    readonly listStops: (cap: number) => string;
+    /** A tension linked to a row, named and with its id so a reader can open it; each surface adds its own indent. */
+    readonly tension: (t: {
+        entryId: string | null;
+        name: string;
+    }) => string;
+    readonly setOne: "Set one (urgent, high, medium or low):";
+    /** The command each surface prints after setOne, ending the line so it pastes whole; a live priority change asks one line of why (DEC-2418). */
+    readonly setCommand: {
+        readonly cli: "pb update <WP-ID> -f priority=high --change-reason \"<why>\"";
+        readonly mcp: "`entries action=update entryId=\"<WP-ID>\" data={\"priority\":\"high\"} changeReason=\"<why>\"`";
+    };
+};
+/** The level word a row is listed under: one of the five, No priority for anything else. */
+export declare function priorityWord(value: unknown): string;
+export type WorkPackageListSurface<R> = {
+    /** The row's own lines; `mark` is the yours mark with its leading space, or ''. */
+    row: (row: R, mark: string) => string[];
+    heading: (word: string) => string;
+    /** The surface's command from WORK_PACKAGE_LIST_WORDS.setCommand, printed after setOne. */
+    setCommand: string;
+    /** The surface's command from WORK_PACKAGE_LIST_WORDS.allCommand, ending the count line. */
+    allCommand: string;
+};
+/**
+ * Rows arrive in orient's order (priority first). With no counts (no team bound) and no priority on any
+ * row, the lines are exactly the rows: the list a session saw before priorities existed. A heading is
+ * printed for each level present once any row has a priority; a team list leads with the count line,
+ * the yours legend when a row is marked, and the Set one hint when none of its rows has a priority.
+ */
+export declare function workPackageListLines<R extends WorkPackageListMarks>(rows: readonly R[], counts: WorkPackageTeamCounts | undefined, surface: WorkPackageListSurface<R>): string[];
+/** One open task a role owns outside a live package (DEC-2459): the stored priority token (absent for No priority), in progress
+ *  only on that stage, no owner only on the Team Lead's list for a task no role owns, packageClosed when its only packages are closed. */
+export type OpenTaskRow = {
+    entryId: string;
+    name: string;
+    priority?: string;
+    inProgress?: true;
+    noOwner?: true;
+    packageClosed?: true;
+};
+/** The read's answer: the role, its rows in the one order (priority, stage, last updated), and whether the read stopped at
+ *  its cap; `cappedAt` is how many records it had read when it stopped. */
+export type OpenTaskList = {
+    role: {
+        entryId: string | null;
+        name: string;
+    };
+    rows: OpenTaskRow[];
+    capped: boolean;
+    cappedAt?: number;
+};
+/** What orient serves: the first `shown` rows of the read, and how many it found in all, so the cut note can count the rest. */
+export type OrientOpenTasks = OpenTaskList & {
+    total: number;
+};
+/** The surface a list prints on: it picks the command below. */
+export type OpenTaskSurface = 'cli' | 'mcp';
+/** The words of a role's open-task list (DEC-2459, shaped by Product Design 2026-10-30): orient and the tasks list alike. */
+export declare const OPEN_TASK_LIST_WORDS: {
+    readonly heading: (roleName: string) => string;
+    readonly separator: " · ";
+    readonly inProgress: "(in progress)";
+    readonly noOwner: "(no owner)";
+    /** After a task whose package parents are all done or archived, so the agent finishes it or closes it (Product Design 2026-10-30). */
+    readonly packageClosed: "(its package is closed)";
+    /** Orient shows at most this many rows; the cut note names the command for the rest. */
+    readonly shown: 5;
+    readonly more: (hidden: number, capped: boolean, allCommand: string) => string;
+    readonly allCommand: {
+        readonly cli: "pb tasks list";
+        readonly mcp: "`context action=tasks`";
+    };
+    readonly compact: (count: number, capped: boolean, roleName: string) => string;
+    /** Only for a read that was not cut: a capped read that found none prints its capped line instead, never this. */
+    readonly empty: (roleName: string) => string;
+    /** The tasks list's last line when another page follows. */
+    readonly nextPage: (command: string) => string;
+    /** Printed whenever the read stopped at its cap, so rows it never read are not taken for none (signed by Voice, 2026-10-30).
+     *  The read goes newest ownership first, so what it leaves out is what the role has owned longest. */
+    readonly capped: (records: number) => string;
+    /** The read's refusal when no role is named and the session acts in none; each surface adds noRole with its own command. */
+    readonly noSessionRole: "This session acts in no role.";
+    readonly noRole: (command: string) => string;
+    /** A cursor that is not a page number; the CLI refuses it rather than reading page 1. */
+    readonly badCursor: (value: string) => string;
+};
+/** Each surface's command with its role and cursor inputs, built from allCommand so it is spelled once. */
+export declare function openTaskCommand(surface: OpenTaskSurface, input?: {
+    role?: string;
+    cursor?: number;
+}): string;
+/** `<priority word> · <TASK-id> — <name>`, then the in-progress, no-owner and package-closed marks; each surface adds its own bullet. */
+export declare function openTaskRowText(row: OpenTaskRow): string;
+/** The rows under the heading: at most `shown` (all when absent), then the cut note when rows were left out, then the
+ *  capped line whenever the read stopped at its cap; the cut note's count then reads "n+", since rows past the cap were never read. */
+export declare function openTaskListLines(list: OpenTaskList, surface: {
+    bullet: string;
+    surface: OpenTaskSurface;
+    shown?: number;
+    total?: number;
+}): string[];
+/** Orient's section: nothing when the role owns none and the read was not cut (a cut read that found none still prints the heading
+ *  and its capped line, never silence); otherwise the heading, at most `shown` rows, the cut note and the capped line. */
+export declare function openTaskSectionLines(list: OrientOpenTasks | undefined, surface: {
+    heading: (text: string) => string;
+    bullet: string;
+    surface: OpenTaskSurface;
+}): string[];
+/** Orient's compact count, on the same guard as the section. */
+export declare function openTaskCompactLines(list: OrientOpenTasks | undefined): string[];
+//# sourceMappingURL=workPackageList.d.ts.map

package/dist/lib/workPackageList.d.ts.map

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

package/dist/lib/workPackageList.js

@@ -0,0 +1,139 @@
+// GENERATED by scripts/generate-mcp-embedded-copies.mjs from kernel/entries/workPackageList.ts.
+// DO NOT EDIT. Run `npm run mcp:embedded-copies` to regenerate.
+// Local runtime copy for the isolated connector build.
+/**
+ * The work-package list orient prints (DEC-2426, RULE-664): rows grouped under the level words in
+ * priority order, the yours mark and its legend, the count line with the command for every package, the
+ * tension lines and the Set one hint. Every word comes from here or from priority.ts (signed in DEC-2445);
+ * each surface renders its own row and heading and picks its commands from here. Beside it, a role's open tasks outside
+ * a package (DEC-2459): OPEN_TASK_LIST_WORDS and the rows orient and the tasks list print.
+ *
+ * Copied verbatim into both connector packages by scripts/generate-mcp-embedded-copies.mjs (the
+ * ./priority import rewritten to ./priority.js), since neither connector can import the kernel at runtime.
+ */
+import { NO_PRIORITY, PRIORITY_LEVELS, priorityOf } from './priority.js';
+/** What the command for every package prints, said after it so a cold reader trusts a command named for confidence (DEC-2445 amended 2026-10-30). */
+const ALL_COMMAND_SAYS = 'lists every live package';
+export const WORK_PACKAGE_LIST_WORDS = {
+    yours: '[yours]',
+    /** Printed once under the heading when a row carries the mark, so a cold reader need not guess it (DEC-2445). */
+    legend: '[yours] = a package your role owns',
+    count: (shown, { team, otherTeams, noSingleOwner }, allCommand) => `Showing ${shown} of your team's ${team} live package${team === 1 ? '' : 's'}; ${otherTeams} more in other teams`
+        + `${noSingleOwner > 0 ? `; ${noSingleOwner} more with no single owner` : ''}. All ${team + otherTeams + noSingleOwner}: ${allCommand} (${ALL_COMMAND_SAYS})`,
+    /** The command each surface names at the end of the count line: every live work package of the workspace, under listHeading. */
+    allCommand: {
+        cli: 'pb brief confidence',
+        mcp: '`context action=brief briefType="confidence"`',
+    },
+    /** The heading of that command's list, so the count line and the list use one word. */
+    listHeading: 'Live work packages',
+    /** That list's last line when it stopped at its cap; the brief has no way to continue past it. */
+    listStops: (cap) => `More than ${cap} live packages; the list stops here.`,
+    /** A tension linked to a row, named and with its id so a reader can open it; each surface adds its own indent. */
+    tension: (t) => `↳ tension${t.entryId ? ` ${t.entryId}` : ''}: ${t.name}`,
+    setOne: 'Set one (urgent, high, medium or low):',
+    /** The command each surface prints after setOne, ending the line so it pastes whole; a live priority change asks one line of why (DEC-2418). */
+    setCommand: {
+        cli: 'pb update <WP-ID> -f priority=high --change-reason "<why>"',
+        mcp: '`entries action=update entryId="<WP-ID>" data={"priority":"high"} changeReason="<why>"`',
+    },
+};
+/** The level word a row is listed under: one of the five, No priority for anything else. */
+export function priorityWord(value) {
+    const token = priorityOf(value);
+    return token ? PRIORITY_LEVELS[token].word : NO_PRIORITY.word;
+}
+/**
+ * Rows arrive in orient's order (priority first). With no counts (no team bound) and no priority on any
+ * row, the lines are exactly the rows: the list a session saw before priorities existed. A heading is
+ * printed for each level present once any row has a priority; a team list leads with the count line,
+ * the yours legend when a row is marked, and the Set one hint when none of its rows has a priority.
+ */
+export function workPackageListLines(rows, counts, surface) {
+    const lines = [];
+    const anyPriority = rows.some((row) => priorityOf(row.priority) !== null);
+    // TASK-1496: with nothing live there is no count line, so no command is named for a list that is empty.
+    if (counts && counts.team + counts.otherTeams + counts.noSingleOwner > 0)
+        lines.push(WORK_PACKAGE_LIST_WORDS.count(rows.length, counts, surface.allCommand));
+    if (rows.some((row) => row.yours))
+        lines.push(WORK_PACKAGE_LIST_WORDS.legend);
+    if (counts && rows.length > 0 && !anyPriority)
+        lines.push(`${WORK_PACKAGE_LIST_WORDS.setOne} ${surface.setCommand}`);
+    let level;
+    for (const row of rows) {
+        const word = priorityWord(row.priority);
+        if (anyPriority && word !== level)
+            lines.push(surface.heading(word));
+        level = word;
+        lines.push(...surface.row(row, row.yours ? ` ${WORK_PACKAGE_LIST_WORDS.yours}` : ''));
+    }
+    return lines;
+}
+/** The words of a role's open-task list (DEC-2459, shaped by Product Design 2026-10-30): orient and the tasks list alike. */
+export const OPEN_TASK_LIST_WORDS = {
+    heading: (roleName) => `${roleName}'s open tasks, not in a live package`,
+    separator: ' · ',
+    inProgress: '(in progress)',
+    noOwner: '(no owner)',
+    /** After a task whose package parents are all done or archived, so the agent finishes it or closes it (Product Design 2026-10-30). */
+    packageClosed: '(its package is closed)',
+    /** Orient shows at most this many rows; the cut note names the command for the rest. */
+    shown: 5,
+    more: (hidden, capped, allCommand) => `${hidden}${capped ? '+' : ''} more: ${allCommand}`,
+    allCommand: { cli: 'pb tasks list', mcp: '`context action=tasks`' },
+    compact: (count, capped, roleName) => `${count}${capped ? '+' : ''} open task(s) of ${roleName}, not in a live package`,
+    /** Only for a read that was not cut: a capped read that found none prints its capped line instead, never this. */
+    empty: (roleName) => `${roleName} has no open tasks outside a live package.`,
+    /** The tasks list's last line when another page follows. */
+    nextPage: (command) => `More: ${command}`,
+    /** Printed whenever the read stopped at its cap, so rows it never read are not taken for none (signed by Voice, 2026-10-30).
+     *  The read goes newest ownership first, so what it leaves out is what the role has owned longest. */
+    capped: (records) => `Read stopped at ${records} records; the tasks this role has owned longest are not listed.`,
+    /** The read's refusal when no role is named and the session acts in none; each surface adds noRole with its own command. */
+    noSessionRole: 'This session acts in no role.',
+    noRole: (command) => `Name the role: ${command}`,
+    /** A cursor that is not a page number; the CLI refuses it rather than reading page 1. */
+    badCursor: (value) => `Cursor ${value} is not a page number. Use the number the last page printed.`,
+};
+/** Each surface's command with its role and cursor inputs, built from allCommand so it is spelled once. */
+export function openTaskCommand(surface, input = {}) {
+    if (surface === 'cli') {
+        return `${OPEN_TASK_LIST_WORDS.allCommand.cli}${input.role ? ` --role ${input.role}` : ''}${input.cursor !== undefined ? ` --cursor ${input.cursor}` : ''}`;
+    }
+    const bare = OPEN_TASK_LIST_WORDS.allCommand.mcp.slice(1, -1); // the command inside its backticks
+    return `${bare}${input.role ? ` roleId=${input.role}` : ''}${input.cursor !== undefined ? ` cursor=${input.cursor}` : ''}`;
+}
+/** `<priority word> · <TASK-id> — <name>`, then the in-progress, no-owner and package-closed marks; each surface adds its own bullet. */
+export function openTaskRowText(row) {
+    const w = OPEN_TASK_LIST_WORDS;
+    const marks = [row.inProgress && w.inProgress, row.noOwner && w.noOwner, row.packageClosed && w.packageClosed].filter(Boolean);
+    return `${priorityWord(row.priority)}${w.separator}${row.entryId} — ${row.name}${marks.map((m) => ` ${m}`).join('')}`;
+}
+/** The rows under the heading: at most `shown` (all when absent), then the cut note when rows were left out, then the
+ *  capped line whenever the read stopped at its cap; the cut note's count then reads "n+", since rows past the cap were never read. */
+export function openTaskListLines(list, surface) {
+    const shown = Math.min(surface.shown ?? list.rows.length, list.rows.length);
+    const total = surface.total ?? list.rows.length; // orient passes the read's total, since it serves only the first rows
+    const lines = list.rows.slice(0, shown).map((row) => `${surface.bullet}${openTaskRowText(row)}`);
+    const allCommand = surface.surface === 'cli' ? OPEN_TASK_LIST_WORDS.allCommand.cli : OPEN_TASK_LIST_WORDS.allCommand.mcp;
+    if (total > shown)
+        lines.push(OPEN_TASK_LIST_WORDS.more(total - shown, list.capped, allCommand));
+    if (list.capped)
+        lines.push(OPEN_TASK_LIST_WORDS.capped(list.cappedAt ?? total));
+    return lines;
+}
+/** Orient's section: nothing when the role owns none and the read was not cut (a cut read that found none still prints the heading
+ *  and its capped line, never silence); otherwise the heading, at most `shown` rows, the cut note and the capped line. */
+export function openTaskSectionLines(list, surface) {
+    if (!list || (list.total === 0 && !list.capped))
+        return [];
+    const rows = openTaskListLines(list, { bullet: surface.bullet, surface: surface.surface, shown: OPEN_TASK_LIST_WORDS.shown, total: list.total });
+    return [surface.heading(OPEN_TASK_LIST_WORDS.heading(list.role.name)), ...rows];
+}
+/** Orient's compact count, on the same guard as the section. */
+export function openTaskCompactLines(list) {
+    if (!list || (list.total === 0 && !list.capped))
+        return [];
+    return [OPEN_TASK_LIST_WORDS.compact(list.total, list.capped, list.role.name)];
+}
+//# sourceMappingURL=workPackageList.js.map

package/dist/lib/workPackageList.js.map

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

package/dist/lib/workspace-probe.d.ts

@@ -12,8 +12,17 @@
  * Uses resolveWorkspace (registered in http.ts) rather than orient, which is
  * not exposed on the HTTP gateway — orient is MCP-server-only.
  */
+/** DEC-2226: the binding of a key bound to one role, as the gateway reports it (absent on a person key). */
+export type KeyBinding = {
+    name: string;
+    roleName: string;
+    roleRef: string | null;
+    delegatedBy: string | null;
+    line: string;
+};
 export declare function probeWorkspace(): Promise<{
     name: string;
     entryCount?: number;
+    key?: KeyBinding;
 } | null>;
 //# sourceMappingURL=workspace-probe.d.ts.map

package/dist/lib/workspace-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-probe.d.ts","sourceRoot":"","sources":["../../src/lib/workspace-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAQ5F"}
+{"version":3,"file":"workspace-probe.d.ts","sourceRoot":"","sources":["../../src/lib/workspace-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,4GAA4G;AAC5G,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9H,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,CAQ9G"}

package/dist/lib/workspace-probe.js

@@ -6,19 +6,12 @@
  * workspace info on success, null on any failure (network, auth, offline).
  */
 import { kernelCall } from './client.js';
-/**
- * Attempt to detect workspace connectivity via a lightweight API call.
- * Returns workspace info on success, null on any failure.
- *
- * Uses resolveWorkspace (registered in http.ts) rather than orient, which is
- * not exposed on the HTTP gateway — orient is MCP-server-only.
- */
 export async function probeWorkspace() {
     try {
         const result = await kernelCall('resolveWorkspace', {});
         if (!result)
             return null;
-        return { name: result.name || 'unknown' };
+        return { name: result.name || 'unknown', ...(result.key ? { key: result.key } : {}) };
     }
     catch {
         return null;

package/dist/lib/workspace-probe.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-probe.js","sourceRoot":"","sources":["../../src/lib/workspace-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAA0C,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACjG,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"workspace-probe.js","sourceRoot":"","sources":["../../src/lib/workspace-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAYzC,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAA4D,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACnH,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}