@productbrain/cli 0.1.0-beta.984 → 0.1.0-beta.9860

package/dist/commands/entryPreflight.js

@@ -0,0 +1,48 @@
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { runCliCommand } from '../lib/runner.js';
+/**
+ * A reader must not have to guess whether a line stops acceptance, merely failed to complete, or
+ * is deferred to the write door. The MCP connector (packages/mcp-server/src/lib/
+ * createEntryPreviewResult.ts `formatPreflightCheck`) and the Page's EntryPreflight surface
+ * (`checkLabel`) hold their own copy of this rule; this package may not import from either. The
+ * three copies are NOT byte-identical (the Page's has a redundant extra branch) — what must hold
+ * is that all three map every (status, blocking) pair to the same string. That cross-surface
+ * invariant is enforced by packages/mcp-server/src/__tests__/create-entry-preview-result.test.ts,
+ * which reads the other two copies off disk.
+ */
+function formatPreflightCheck(check) {
+    if (check.status === 'missing' && check.blocking)
+        return `Blocked: ${check.message}`;
+    if (check.status === 'incomplete')
+        return `Unverified: ${check.message}`;
+    if (check.status === 'not_checked')
+        return `Checked later: ${check.message}`;
+    return check.message;
+}
+export async function runEntryPreflight(options) {
+    const links = options.link?.map((link) => {
+        const separator = link.indexOf(':');
+        const type = (separator < 0 ? options.linkType : link.slice(0, separator))?.trim();
+        const entryId = (separator < 0 ? link : link.slice(separator + 1)).trim();
+        if (!type || !entryId)
+            throw new CLIError('Use --link <type:entry-id>, or pair --link <entry-id> with --link-type <type>.', { code: ErrorCode.VALIDATION_FAILED, category: 'validation' });
+        return { entryId, type };
+    });
+    const config = await getConfigOrGuide(() => runEntryPreflight(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('chain.preflightEntry', {
+            collectionSlug: options.collection, canonicalKey: options.canonicalKey,
+            links,
+        }),
+        formatPretty: (value) => {
+            const result = value;
+            return [...result.checks.map(formatPreflightCheck),
+                ...(result.requiredFields.length ? [`Required information: ${result.requiredFields.join(', ')}.`] : []), result.notice].join('\n');
+        },
+    });
+}
+//# sourceMappingURL=entryPreflight.js.map

package/dist/commands/entryPreflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryPreflight.js","sourceRoot":"","sources":["../../src/commands/entryPreflight.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAAC,KAAkC;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC;IACrF,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,eAAe,KAAK,CAAC,OAAO,EAAE,CAAC;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7E,OAAO,KAAK,CAAC,OAAO,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA8B;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACnF,MAAM,OAAO,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1E,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,QAAQ,CAAC,gFAAgF,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3L,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,aAAa,CAAC;QACnB,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,CAAY,sBAAsB,EAAE;YACvD,cAAc,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY;YACtE,KAAK;SACL,CAAC;QACF,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,KAAkB,CAAC;YAClC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;gBACjD,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,yBAAyB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrI,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/commands/entryTick.d.ts

@@ -0,0 +1,8 @@
+interface EntryTickOptions {
+    entryId: string;
+    itemId: string;
+    undo?: boolean;
+}
+export declare function runEntryTick(options: EntryTickOptions): Promise<void>;
+export {};
+//# sourceMappingURL=entryTick.d.ts.map

package/dist/commands/entryTick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryTick.d.ts","sourceRoot":"","sources":["../../src/commands/entryTick.ts"],"names":[],"mappings":"AAgBA,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC3E"}

package/dist/commands/entryTick.js

@@ -0,0 +1,43 @@
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCallWithSession } from '../lib/client.js';
+import { readSession } from '../lib/session.js';
+import { runCliCommand } from '../lib/runner.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+export async function runEntryTick(options) {
+    const config = await getConfigOrGuide(() => runEntryTick(options));
+    if (!config)
+        return;
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` first. Write access requires a tracked session.',
+        });
+    }
+    const entryId = options.entryId.trim();
+    const itemId = options.itemId.trim();
+    if (!entryId || !itemId) {
+        throw new CLIError('Entry ID and item ID are required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb entry tick <entry-id> <item-id> [--undo]',
+        });
+    }
+    const done = !options.undo;
+    await runCliCommand({
+        fn: async () => {
+            const result = await kernelCallWithSession('chain.tickChecklistItem', {
+                entryId,
+                itemId,
+                done,
+                sessionId: session.sessionId,
+            });
+            return { entryId, itemId, done: result.done, changed: result.changed };
+        },
+        formatPretty: (data) => data.changed
+            ? `${data.entryId}: Done-when item ${data.itemId} ${data.done ? 'ticked' : 'unticked'} (not an edit).`
+            : `${data.entryId}: Done-when item ${data.itemId} was already ${data.done ? 'ticked' : 'unticked'}.`,
+    });
+}
+//# sourceMappingURL=entryTick.js.map

package/dist/commands/entryTick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryTick.js","sourceRoot":"","sources":["../../src/commands/entryTick.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE;YACvC,IAAI,EAAE,SAAS,CAAC,gBAAgB;YAChC,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,wEAAwE;SACnF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAAC,oCAAoC,EAAE;YACvD,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,oDAAoD;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,MAAM,aAAa,CAAuE;QACxF,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAsD,yBAAyB,EAAE;gBACzH,OAAO;gBACP,MAAM;gBACN,IAAI;gBACJ,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACzE,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO;YAClC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,oBAAoB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,iBAAiB;YACtG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,oBAAoB,IAAI,CAAC,MAAM,gBAAgB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,GAAG;KACvG,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/feedback.d.ts

@@ -0,0 +1,36 @@
+import { Command } from 'commander';
+export declare function runFeedbackSubmit(message: string, options: {
+    category: string;
+    command?: string;
+}): Promise<void>;
+/**
+ * WP-494 §5 (TEN-2742): the own-workspace read-back — the default verb. Calls
+ * `feedback.listOwn` for EVERY caller (no vendor gate, no triage session): it's a member
+ * query, so a read-scoped key passes; the gateway force-injects the credential's own
+ * `workspaceId` regardless of anything sent here. Default view spans ALL statuses
+ * (including `screening`) so nothing silently disappears from the submitter's own view.
+ */
+export declare function runFeedbackList(options: {
+    status?: string;
+    limit: string;
+    cursor?: string;
+}): Promise<void>;
+/**
+ * WP-494 §5 (TEN-2742): the vendor cross-workspace triage queue — takes over `list`'s old
+ * behavior verbatim, including the triage-session gate and every existing filter.
+ */
+export declare function runFeedbackQueue(options: {
+    status: string;
+    category?: string;
+    groupId?: string;
+    workspaceId?: string;
+    since?: string;
+    before?: string;
+    limit: string;
+    cursor?: string;
+}): Promise<void>;
+export declare function runFeedbackNote(feedbackId: string, note: string): Promise<void>;
+export declare function runFeedbackGroup(groupId: string, feedbackIds: string[]): Promise<void>;
+export declare function runFeedbackStatus(feedbackId: string, status: string): Promise<void>;
+export declare function createFeedbackCommand(): Command;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/commands/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/commands/feedback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAavH;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjD,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5I,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrF;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5F;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzF;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAyC/C"}

package/dist/commands/feedback.js

@@ -0,0 +1,174 @@
+import { Command } from 'commander';
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall, kernelCallWithSession } from '../lib/client.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { runCliCommand } from '../lib/runner.js';
+import { readSession } from '../lib/session.js';
+import { formatFeedbackList, formatFeedbackMutation } from '../formatters/feedback.js';
+/**
+ * Client-side gate for the vendor triage verbs — `pb feedback queue`, `note`, `group`,
+ * `status` (WP-494 §5 verb-rename sweep: this gate moved from `list` to `queue`). `list`
+ * (own-workspace read-back via `feedback.listOwn`) is a member query and deliberately
+ * carries NO gate here — the server enforces everything.
+ */
+function requireTriageSession() {
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` before triaging the vendor feedback queue.',
+        });
+    }
+    return session;
+}
+export async function runFeedbackSubmit(message, options) {
+    const config = await getConfigOrGuide(() => runFeedbackSubmit(message, options));
+    if (!config)
+        return;
+    const session = readSession();
+    await runCliCommand({
+        fn: () => kernelCall('feedback.submit', {
+            category: options.category,
+            message,
+            ...(session ? { sessionId: session.sessionId } : {}),
+            context: options.command ? { command: options.command, client: 'pb-cli' } : { client: 'pb-cli' },
+        }),
+        formatPretty: (value) => formatFeedbackMutation(value, 'submit'),
+    });
+}
+/**
+ * WP-494 §5 (TEN-2742): the own-workspace read-back — the default verb. Calls
+ * `feedback.listOwn` for EVERY caller (no vendor gate, no triage session): it's a member
+ * query, so a read-scoped key passes; the gateway force-injects the credential's own
+ * `workspaceId` regardless of anything sent here. Default view spans ALL statuses
+ * (including `screening`) so nothing silently disappears from the submitter's own view.
+ */
+export async function runFeedbackList(options) {
+    const config = await getConfigOrGuide(() => runFeedbackList(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        // cursor ?? null: always request the paged shape so the pretty footer can print the
+        // ready-to-run next-page command.
+        // WP-584 correction A: the notice acknowledgement ("you actually looked") used to be a
+        // second, fire-and-forget `notices.markSeen` call from HERE — a client-side courtesy call
+        // that only the CLI ever made (MCP and a raw API caller never cleared a notice). The
+        // acknowledgement now happens at the AKI gateway itself the moment it successfully serves
+        // `feedback.listOwn` (convex/http.ts's `acknowledgesNoticeSource`), so this stays a plain,
+        // single read.
+        fn: () => kernelCall('feedback.listOwn', {
+            status: options.status,
+            limit: Number(options.limit),
+            cursor: options.cursor ?? null,
+        }),
+        formatPretty: (value) => formatFeedbackList(value, {
+            status: options.status,
+            limit: options.limit,
+        }, 'list'),
+    });
+}
+/**
+ * WP-494 §5 (TEN-2742): the vendor cross-workspace triage queue — takes over `list`'s old
+ * behavior verbatim, including the triage-session gate and every existing filter.
+ */
+export async function runFeedbackQueue(options) {
+    const config = await getConfigOrGuide(() => runFeedbackQueue(options));
+    if (!config)
+        return;
+    const session = requireTriageSession();
+    await runCliCommand({
+        // cursor ?? null: always request the paged shape so the pretty footer can print the
+        // ready-to-run next-page command — `--before` stays a time-window filter, never the pager.
+        fn: () => kernelCallWithSession('feedback.list', {
+            sessionId: session.sessionId,
+            status: options.status,
+            category: options.category,
+            groupId: options.groupId,
+            workspaceId: options.workspaceId,
+            since: options.since ? Number(options.since) : undefined,
+            before: options.before ? Number(options.before) : undefined,
+            limit: Number(options.limit),
+            cursor: options.cursor ?? null,
+        }),
+        formatPretty: (value) => formatFeedbackList(value, {
+            status: options.status,
+            category: options.category,
+            groupId: options.groupId,
+            workspaceId: options.workspaceId,
+            since: options.since,
+            before: options.before,
+            limit: options.limit,
+        }, 'queue'),
+    });
+}
+export async function runFeedbackNote(feedbackId, note) {
+    const config = await getConfigOrGuide(() => runFeedbackNote(feedbackId, note));
+    if (!config)
+        return;
+    const session = requireTriageSession();
+    await runCliCommand({
+        fn: () => kernelCallWithSession('feedback.note', { sessionId: session.sessionId, feedbackId, note }),
+        formatPretty: (value) => formatFeedbackMutation(value, 'note'),
+    });
+}
+export async function runFeedbackGroup(groupId, feedbackIds) {
+    const config = await getConfigOrGuide(() => runFeedbackGroup(groupId, feedbackIds));
+    if (!config)
+        return;
+    const session = requireTriageSession();
+    await runCliCommand({
+        fn: async () => {
+            if (feedbackIds.length > 100)
+                throw new Error('Feedback grouping accepts at most 100 rows.');
+            return kernelCallWithSession('feedback.group', { sessionId: session.sessionId, feedbackIds, groupId: groupId === 'clear' ? null : groupId });
+        },
+        formatPretty: (value) => formatFeedbackMutation(value, 'group'),
+    });
+}
+export async function runFeedbackStatus(feedbackId, status) {
+    const config = await getConfigOrGuide(() => runFeedbackStatus(feedbackId, status));
+    if (!config)
+        return;
+    const session = requireTriageSession();
+    await runCliCommand({
+        fn: () => kernelCallWithSession('feedback.status', { sessionId: session.sessionId, feedbackId, status }),
+        formatPretty: (value) => formatFeedbackMutation(value, 'status'),
+    });
+}
+export function createFeedbackCommand() {
+    const command = new Command('feedback').description("Submit product feedback, read back your workspace's own feedback, or triage the vendor queue");
+    command.command('submit <message>')
+        .description('Send product feedback: describe how pb behaved, not your workspace content (no entry ids, names or topics). Works with read-only API keys and no active session')
+        .option('-c, --category <category>', 'bug, friction, idea, praise, or other', 'other')
+        .option('--command <command>', 'Command context (values are removed server-side)')
+        .action(runFeedbackSubmit);
+    command.command('list')
+        .description("List your workspace's own feedback (all statuses)")
+        .option('--status <status>', 'Status filter (default: all statuses)')
+        .option('--limit <count>', 'Maximum rows', '50')
+        .option('--cursor <token>', 'Pagination cursor from the previous page (printed in its footer)')
+        .action(runFeedbackList);
+    command.command('queue')
+        .description('Triage the vendor feedback queue (system admins only)')
+        .option('--status <status>', 'Queue status', 'new')
+        .option('--category <category>', 'Category filter')
+        .option('--group-id <id>', 'Group filter')
+        .option('--workspace-id <id>', 'Workspace filter')
+        .option('--since <millis>', 'Created-at window lower bound (inclusive) in epoch milliseconds')
+        .option('--before <millis>', 'Created-at window upper bound (exclusive) in epoch milliseconds — a time-window filter, not the pager')
+        .option('--limit <count>', 'Maximum rows', '50')
+        .option('--cursor <token>', 'Pagination cursor from the previous page (printed in its footer)')
+        .action(runFeedbackQueue);
+    command.command('note <feedback-id> <note>')
+        .description('Attach or replace a vendor triage note')
+        .action(runFeedbackNote);
+    command.command('group <group-id> <feedback-ids...>')
+        .description('Place up to 100 feedback items in a flat vendor group; use "clear" to ungroup')
+        .action(runFeedbackGroup);
+    command.command('status <feedback-id> <status>')
+        .description('Set new, triaged, planned, resolved, or dismissed')
+        .action(runFeedbackStatus);
+    return command;
+}
+//# sourceMappingURL=feedback.js.map

package/dist/commands/feedback.js.map

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

package/dist/commands/feedback.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=feedback.test.d.ts.map

package/dist/commands/feedback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.test.d.ts","sourceRoot":"","sources":["../../src/commands/feedback.test.ts"],"names":[],"mappings":""}

package/dist/commands/feedback.test.js

@@ -0,0 +1,110 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { getConfigOrGuide, kernelCall, kernelCallWithSession, readSession, runCliCommand } = vi.hoisted(() => ({
+    getConfigOrGuide: vi.fn(),
+    kernelCall: vi.fn(),
+    kernelCallWithSession: vi.fn(),
+    readSession: vi.fn(),
+    runCliCommand: vi.fn(async ({ fn }) => fn()),
+}));
+vi.mock('../lib/config.js', () => ({ getConfigOrGuide }));
+vi.mock('../lib/client.js', () => ({ kernelCall, kernelCallWithSession }));
+vi.mock('../lib/runner.js', () => ({ runCliCommand }));
+vi.mock('../lib/session.js', () => ({ readSession }));
+import { createFeedbackCommand, runFeedbackGroup, runFeedbackList, runFeedbackQueue, runFeedbackSubmit } from './feedback.js';
+describe('pb feedback command surface', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        getConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://example.test' });
+        kernelCall.mockResolvedValue({ id: 'feedback-1', status: 'new' });
+        kernelCallWithSession.mockResolvedValue([]);
+        readSession.mockReturnValue(null);
+    });
+    it('exposes the complete resource lifecycle from help metadata (WP-494 §5: list + queue split)', () => {
+        const command = createFeedbackCommand();
+        expect(command.commands.map((item) => item.name())).toEqual(['submit', 'list', 'queue', 'note', 'group', 'status']);
+        // TEN-4590: the content hint sits on the submit door itself, not only at session start.
+        expect(command.commands.find((item) => item.name() === 'submit')?.description()).toBe('Send product feedback: describe how pb behaved, not your workspace content (no entry ids, names or topics). Works with read-only API keys and no active session');
+        expect(command.commands.find((item) => item.name() === 'list')?.description()).toContain('own feedback');
+        expect(command.commands.find((item) => item.name() === 'queue')?.description()).toContain('vendor');
+        expect(command.commands.find((item) => item.name() === 'group')?.description()).toContain('100');
+    });
+    it('retries the original submission after guided first-run authentication', async () => {
+        getConfigOrGuide
+            .mockImplementationOnce(async (retry) => { await retry(); return null; })
+            .mockResolvedValueOnce({ apiKey: 'pb_sk_test', siteUrl: 'https://example.test' });
+        await runFeedbackSubmit('first-run feedback', { category: 'friction' });
+        expect(kernelCall).toHaveBeenCalledOnce();
+        expect(kernelCall).toHaveBeenCalledWith('feedback.submit', expect.objectContaining({ message: 'first-run feedback' }));
+    });
+    it('parses the Commander submit surface and forwards its category', async () => {
+        const command = createFeedbackCommand();
+        command.exitOverride();
+        await command.parseAsync(['submit', 'parsed feedback', '--category', 'idea'], { from: 'user' });
+        expect(kernelCall).toHaveBeenCalledWith('feedback.submit', expect.objectContaining({
+            message: 'parsed feedback', category: 'idea',
+        }));
+    });
+    it('attaches an active session to submit without requiring one', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        await runFeedbackSubmit('contextual feedback', { category: 'idea' });
+        expect(kernelCall).toHaveBeenCalledWith('feedback.submit', expect.objectContaining({ sessionId: 'session-1' }));
+    });
+    it('list hits feedback.listOwn for every caller, with NO session required (WP-494 §5)', async () => {
+        kernelCall.mockResolvedValue([]);
+        await runFeedbackList({ limit: '50' });
+        expect(kernelCall).toHaveBeenCalledWith('feedback.listOwn', expect.objectContaining({ limit: 50 }));
+        // No triage-session gate: readSession was never even consulted for a gate check.
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+        // Still works identically WITH an active session present (it's simply irrelevant to listOwn).
+        kernelCall.mockClear();
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        await runFeedbackList({ limit: '50' });
+        expect(kernelCall).toHaveBeenCalledWith('feedback.listOwn', expect.objectContaining({ limit: 50 }));
+    });
+    it('list forwards the optional --status filter, defaulting to all statuses, and the cursor pager', async () => {
+        await runFeedbackList({ limit: '50' });
+        expect(kernelCall).toHaveBeenCalledWith('feedback.listOwn', { status: undefined, limit: 50, cursor: null });
+        kernelCall.mockClear();
+        await runFeedbackList({ status: 'screening', limit: '10', cursor: 'cursor-token-1' });
+        expect(kernelCall).toHaveBeenCalledWith('feedback.listOwn', { status: 'screening', limit: 10, cursor: 'cursor-token-1' });
+    });
+    it('list is a plain read — no client-side acknowledgement call (WP-584 correction A: the gateway stamps the notice cursor itself on a successful serve, never a per-connector client call)', async () => {
+        kernelCall.mockResolvedValue([]);
+        await runFeedbackList({ limit: '50' });
+        expect(kernelCall).toHaveBeenCalledWith('feedback.listOwn', expect.any(Object));
+        expect(kernelCall).toHaveBeenCalledTimes(1);
+    });
+    it('queue requires and forwards the active session for vendor triage (list\'s old behavior, verbatim)', async () => {
+        await expect(runFeedbackQueue({ status: 'new', limit: '50' })).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        await runFeedbackQueue({ status: 'new', limit: '50' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('feedback.list', expect.objectContaining({ sessionId: 'session-1' }));
+    });
+    it('parses and forwards queue\'s --since/--before window filters and the --cursor pager', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        const command = createFeedbackCommand();
+        command.exitOverride();
+        await command.parseAsync(['queue', '--since', '100', '--before', '1700000000000'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('feedback.list', expect.objectContaining({
+            since: 100, before: 1_700_000_000_000,
+        }));
+        // Omitted flag stays omitted — never sent as NaN/0.
+        kernelCallWithSession.mockClear();
+        await runFeedbackQueue({ status: 'new', limit: '50' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('feedback.list', expect.objectContaining({ before: undefined }));
+        // No --cursor: the paged shape is still requested (cursor: null) so the pretty
+        // footer can print the ready-to-run next-page command (Codex P2, PR #372).
+        expect(kernelCallWithSession).toHaveBeenCalledWith('feedback.list', expect.objectContaining({ cursor: null }));
+        // --cursor forwards the previous page's continueCursor verbatim.
+        kernelCallWithSession.mockClear();
+        await command.parseAsync(['queue', '--cursor', 'cursor-token-1'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('feedback.list', expect.objectContaining({ cursor: 'cursor-token-1' }));
+    });
+    it('rejects oversized grouping before making a gateway call', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        await expect(runFeedbackGroup('group-1', Array.from({ length: 101 }, (_, index) => `f${index}`)))
+            .rejects.toThrow(/at most 100/);
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=feedback.test.js.map

package/dist/commands/feedback.test.js.map

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

package/dist/commands/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/commands/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBlF"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/commands/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBlF"}

package/dist/commands/fields.js

@@ -19,7 +19,7 @@ export async function runFields(options) {
                 throw new CLIError(`Collection '${options.collectionSlug}' not found.`, {
                     code: ErrorCode.VALIDATION_FAILED,
                     category: 'validation',
-                    guidance: `Run 'pb fields' with a valid collection slug (e.g. bets, decisions, tensions).`,
+                    guidance: `Run 'pb fields' with a valid collection slug (e.g. work-packages, decisions, tensions).`,
                 });
             }
             return result;

package/dist/commands/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/commands/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAA+B,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAmC;IACjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAyB;QAC1C,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,2BAA2B,EAC3B,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,CACjC,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,QAAQ,CAChB,eAAe,OAAO,CAAC,cAAc,cAAc,EACnD;oBACE,IAAI,EAAE,SAAS,CAAC,iBAAiB;oBACjC,QAAQ,EAAE,YAAY;oBACtB,QAAQ,EAAE,gFAAgF;iBAC3F,CACF,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/commands/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAA+B,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAmC;IACjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAyB;QAC1C,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,2BAA2B,EAC3B,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,CACjC,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,QAAQ,CAChB,eAAe,OAAO,CAAC,cAAc,cAAc,EACnD;oBACE,IAAI,EAAE,SAAS,CAAC,iBAAiB;oBACjC,QAAQ,EAAE,YAAY;oBACtB,QAAQ,EAAE,yFAAyF;iBACpG,CACF,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/files.d.ts

@@ -0,0 +1,26 @@
+import { type ClassifiedFile, type Exposure } from '../lib/productbrain-files.js';
+export interface FilesResult {
+    workspace: string | null;
+    root: string | null;
+    git: boolean;
+    files: ClassifiedFile[];
+    exposures: Exposure[];
+    fix?: {
+        added: string[];
+        skipped: string[];
+        refused?: string;
+        dryRun?: boolean;
+        trackedExposed?: string[];
+        stillExposed?: string[];
+    };
+}
+export declare function resolveFiles(opts: {
+    fix: boolean;
+    dryRun: boolean;
+}): Promise<FilesResult>;
+export declare function formatFilesPretty(d: FilesResult): string;
+export declare function runFiles(opts: {
+    fix?: boolean;
+    dryRun?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=files.d.ts.map

package/dist/commands/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/commands/files.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EAAE,KAAK,QAAQ,EACnC,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACtI;AAUD,wBAAsB,YAAY,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAmEhG;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAsDxD;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF"}