@productbrain/cli 0.1.0-beta.9 → 0.1.0-beta.9000

package/dist/commands/constellation.js

@@ -6,20 +6,25 @@
  * ARCH-25 (orient view model pattern), DEC-99 (ALLOWED_RELATION_TYPES as SSOT)
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand } from '../lib/runner.js';
 import { formatConstellation } from '../formatters/constellation.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
 export async function runConstellation(options) {
     const config = await getConfigOrGuide(() => runConstellation(options));
     if (!config)
         return;
     await runCliCommand({
-        fn: () => mcpCall('chain.getConstellation', {
+        fn: () => kernelCall('chain.getConstellation', {
             entryId: options.entryId,
         }),
         formatPretty: (result) => {
             if (!result?.entry) {
-                throw new Error(`Entry "${options.entryId}" not found.`);
+                throw new CLIError(`Entry "${options.entryId}" not found.`, {
+                    code: ErrorCode.VALIDATION_FAILED,
+                    category: 'validation',
+                    guidance: 'Check the entry ID and try again. Use `pb search` to find entries.',
+                });
             }
             return formatConstellation(result);
         },

package/dist/commands/constellation.js.map

@@ -1 +1 @@
-{"version":3,"file":"constellation.js","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA4B,MAAM,gCAAgC,CAAC;AAE/F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAsB;QACvC,EAAE,EAAE,GAAG,EAAE,CACP,OAAO,CAAsB,wBAAwB,EAAE;YACrD,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"constellation.js","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,mBAAmB,EAA4B,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAsB;QACvC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAAqD,wBAAwB,EAAE;YACvF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACnB,MAAM,IAAI,QAAQ,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,EAAE;oBAC1D,IAAI,EAAE,SAAS,CAAC,iBAAiB;oBACjC,QAAQ,EAAE,YAAY;oBACtB,QAAQ,EAAE,oEAAoE;iBAC/E,CAAC,CAAC;YACL,CAAC;YACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5E"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5E"}

package/dist/commands/context.js

@@ -4,21 +4,26 @@
  * Previously: pipe-friendly via process.stdout.isTTY — now delegated to runner.
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand, isJsonMode } from '../lib/runner.js';
 import { formatContext } from '../formatters/context.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
 export async function runContext(options) {
     const config = await getConfigOrGuide(() => runContext(options));
     if (!config)
         return;
     await runCliCommand({
-        fn: () => mcpCall('chain.gatherContext', {
+        fn: () => kernelCall('chain.gatherContext', {
             entryId: options.entryId,
             maxHops: 2,
         }),
         formatPretty: (result) => {
             if (!result?.root) {
-                throw new Error(`Entry "${options.entryId}" not found.`);
+                throw new CLIError(`Entry "${options.entryId}" not found.`, {
+                    code: ErrorCode.VALIDATION_FAILED,
+                    category: 'validation',
+                    guidance: 'Check the entry ID and try again. Use `pb search` to find entries.',
+                });
             }
             // In pretty mode, use tty: true for rich terminal output
             return formatContext(result, { tty: !isJsonMode() });

package/dist/commands/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA4B;IAC3D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAgB;QACjC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAgB,qBAAqB,EAAE;YACtD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,CAAC;SACX,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;YAC3D,CAAC;YACD,yDAAyD;YACzD,OAAO,aAAa,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA4B;IAC3D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAgB;QACjC,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,CAAkD,qBAAqB,EAAE;YAC3F,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,CAAC;SACX,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,QAAQ,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,EAAE;oBAC1D,IAAI,EAAE,SAAS,CAAC,iBAAiB;oBACjC,QAAQ,EAAE,YAAY;oBACtB,QAAQ,EAAE,oEAAoE;iBAC/E,CAAC,CAAC;YACL,CAAC;YACD,yDAAyD;YACzD,OAAO,aAAa,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/cross-cut.d.ts

@@ -0,0 +1,11 @@
+/**
+ * pb cross-cut --type <relation-type> — structural aggregation across the workspace.
+ * BET-239 Slice 3: cross-cutting relation view.
+ *
+ * Shows all relations of a given type grouped by source collection.
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+export declare function runCrossCut(options: {
+    type: string;
+}): Promise<void>;
+//# sourceMappingURL=cross-cut.d.ts.map

package/dist/commands/cross-cut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-cut.d.ts","sourceRoot":"","sources":["../../src/commands/cross-cut.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,wBAAsB,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1E"}

package/dist/commands/cross-cut.js

@@ -0,0 +1,23 @@
+/**
+ * pb cross-cut --type <relation-type> — structural aggregation across the workspace.
+ * BET-239 Slice 3: cross-cutting relation view.
+ *
+ * Shows all relations of a given type grouped by source collection.
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatCrossCut } from '../formatters/cross-cut.js';
+export async function runCrossCut(options) {
+    const config = await getConfigOrGuide(() => runCrossCut(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('chain.structuralAggregation', {
+            relationType: options.type,
+        }),
+        formatPretty: (result) => formatCrossCut(result, options.type),
+    });
+}
+//# sourceMappingURL=cross-cut.js.map

package/dist/commands/cross-cut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-cut.js","sourceRoot":"","sources":["../../src/commands/cross-cut.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,cAAc,EAAuB,MAAM,4BAA4B,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAyB;IACzD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAiB;QAClC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAA0D,6BAA6B,EAAE;YACjG,YAAY,EAAE,OAAO,CAAC,IAAI;SAC3B,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/digest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * pb digest --since <ISO or 7d> — read-only, plain-English brief over a run's pending
+ * drafts, grouped into narrative themes with a founder-decisions vs agent-fixes split
+ * (TASK-130, WP-702). No accept surface — nothing here writes to the Chain.
+ *
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+/**
+ * Accepts an ISO 8601 timestamp OR a short duration (numeric + h/d suffix). Returns a ms-epoch
+ * window start, or null when neither shape matches (checked BEFORE `Date.parse` ever runs, so a
+ * loose-but-parseable free-text string like "September 1" is rejected, not silently accepted).
+ */
+export declare function parseSince(input: string): number | null;
+export declare function runDigest(options: {
+    since: string;
+}): Promise<void>;
+//# sourceMappingURL=digest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/commands/digest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvD;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBzE"}

package/dist/commands/digest.js

@@ -0,0 +1,58 @@
+/**
+ * pb digest --since <ISO or 7d> — read-only, plain-English brief over a run's pending
+ * drafts, grouped into narrative themes with a founder-decisions vs agent-fixes split
+ * (TASK-130, WP-702). No accept surface — nothing here writes to the Chain.
+ *
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatDigest } from '../formatters/digest.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+/** `<n>h` or `<n>d` — same shorthand `pb changes --since` uses. */
+const DURATION_RE = /^(\d+)(h|d)$/i;
+/**
+ * Strict ISO 8601 date/datetime shape (PR #1122 round 1 review, P1): `Date.parse` is a
+ * notoriously loose parser (V8 happily accepts free-text like "September 1" or a bare "1" as a
+ * relative/implicit date) — accepting anything it parses let a typo silently resolve to some
+ * unintended timestamp instead of failing with guidance. Requires a full `YYYY-MM-DD`, optionally
+ * followed by a time (`Thh:mm`, seconds/fraction, and a `Z` or `±hh:mm` offset all optional).
+ */
+const ISO_8601_RE = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/;
+/**
+ * Accepts an ISO 8601 timestamp OR a short duration (numeric + h/d suffix). Returns a ms-epoch
+ * window start, or null when neither shape matches (checked BEFORE `Date.parse` ever runs, so a
+ * loose-but-parseable free-text string like "September 1" is rejected, not silently accepted).
+ */
+export function parseSince(input) {
+    const durationMatch = input.match(DURATION_RE);
+    if (durationMatch) {
+        const value = parseInt(durationMatch[1], 10);
+        const unit = durationMatch[2].toLowerCase();
+        const durationMs = unit === 'h' ? value * 3_600_000 : value * 86_400_000;
+        return Date.now() - durationMs;
+    }
+    if (!ISO_8601_RE.test(input))
+        return null;
+    const parsed = Date.parse(input);
+    return Number.isNaN(parsed) ? null : parsed;
+}
+export async function runDigest(options) {
+    const config = await getConfigOrGuide(() => runDigest(options));
+    if (!config)
+        return;
+    const since = parseSince(options.since);
+    if (since === null) {
+        throw new CLIError(`Invalid --since value: '${options.since}'.`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: `Use an ISO 8601 timestamp (e.g. '2026-09-17T00:00:00Z') or a short duration (1h, 6h, 1d, 7d, 30d).`,
+        });
+    }
+    await runCliCommand({
+        fn: () => kernelCall('chain.runDigest', { since }),
+        formatPretty: (result) => formatDigest(result, options.since),
+    });
+}
+//# sourceMappingURL=digest.js.map

package/dist/commands/digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/commands/digest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,EAAqB,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,mEAAmE;AACnE,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,yEAAyE,CAAC;AAE9F;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC;QACzE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA0B;IACxD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,QAAQ,CAChB,2BAA2B,OAAO,CAAC,KAAK,IAAI,EAC5C;YACE,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,oGAAoG;SAC/G,CACF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,CAAe;QAChC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAA8C,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC;QACvF,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC"}

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

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

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

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

package/dist/commands/digest.test.js

@@ -0,0 +1,36 @@
+/**
+ * TASK-130 (WP-702) — `pb digest --since` parsing tests. PR #1122 round 1 review (P1):
+ * `Date.parse` is a loose parser (V8 accepts free-text like "September 1" and even a bare "1"
+ * as some implicit date) — `parseSince` must reject anything outside the `<n>d`/`<n>h`
+ * duration shape or a strict ISO 8601 shape, never silently resolve a typo to a timestamp.
+ */
+import { describe, expect, it } from 'vitest';
+import { parseSince } from './digest.js';
+describe('parseSince', () => {
+    it('accepts a duration shorthand', () => {
+        const before = Date.now();
+        const result = parseSince('7d');
+        expect(result).not.toBeNull();
+        expect(result).toBeLessThanOrEqual(before);
+        expect(result).toBeGreaterThan(before - 8 * 86_400_000);
+    });
+    it('accepts a strict ISO 8601 timestamp', () => {
+        expect(parseSince('2026-09-17T00:00:00Z')).toBe(Date.parse('2026-09-17T00:00:00Z'));
+    });
+    it('accepts a bare ISO 8601 date (no time)', () => {
+        expect(parseSince('2026-09-17')).toBe(Date.parse('2026-09-17'));
+    });
+    it('rejects a bare number — not a duration (no h/d suffix), not an ISO date', () => {
+        expect(parseSince('1')).toBeNull();
+    });
+    it('rejects free-text that Date.parse would otherwise loosely accept', () => {
+        expect(parseSince('September 1')).toBeNull();
+    });
+    it('rejects an empty string', () => {
+        expect(parseSince('')).toBeNull();
+    });
+    it('rejects garbage', () => {
+        expect(parseSince('not-a-date')).toBeNull();
+    });
+});
+//# sourceMappingURL=digest.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest.test.js","sourceRoot":"","sources":["../../src/commands/digest.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/direction.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+export declare function runDirectionList(options: {
+    all?: boolean;
+}): Promise<void>;
+export declare function runDirectionRefresh(): Promise<void>;
+export declare function runDirectionDefer(entryId: string, options: {
+    reason: string;
+}): Promise<void>;
+export declare function createDirectionCommand(): Command;
+//# sourceMappingURL=direction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../src/commands/direction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhF;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnG;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAkBhD"}

package/dist/commands/direction.js

@@ -0,0 +1,79 @@
+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 { formatDirectionList, formatDirectionRefresh, formatDirectionDefer, } from '../formatters/direction.js';
+/**
+ * `pb direction` — the upward direction trace, first strategy-level signal for bets (WP-582 B1,
+ * FEAT-1403, advisory only). Structurally mirrors packages/cli/src/commands/conflicts.ts: `list`
+ * is a plain read (kernelCall, no session); `refresh`/`defer` are session-attributed writes
+ * (kernelCallWithSession), same shape as conflicts' resolve verb.
+ */
+function requireDirectionSession() {
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` before refreshing or deferring a direction-trace finding.',
+        });
+    }
+    return session;
+}
+export async function runDirectionList(options) {
+    const config = await getConfigOrGuide(() => runDirectionList(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('direction.list', {}),
+        formatPretty: (value) => formatDirectionList(value, { all: options.all }),
+    });
+}
+export async function runDirectionRefresh() {
+    const config = await getConfigOrGuide(() => runDirectionRefresh());
+    if (!config)
+        return;
+    requireDirectionSession();
+    await runCliCommand({
+        fn: () => kernelCallWithSession('direction.refresh', {}),
+        formatPretty: (value) => formatDirectionRefresh(value),
+    });
+}
+export async function runDirectionDefer(entryId, options) {
+    const config = await getConfigOrGuide(() => runDirectionDefer(entryId, options));
+    if (!config)
+        return;
+    if (!options.reason || options.reason.trim().length === 0) {
+        throw new CLIError('`--reason` is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb direction defer <work-package-id> --reason "<why deferring>"',
+        });
+    }
+    requireDirectionSession();
+    await runCliCommand({
+        fn: () => kernelCallWithSession('direction.defer', {
+            entryId,
+            reason: options.reason,
+        }),
+        formatPretty: (value) => formatDirectionDefer(value),
+    });
+}
+export function createDirectionCommand() {
+    const command = new Command('direction').description('The upward direction trace — first strategy-level signal for work packages (advisory, WP-582)');
+    command.command('list')
+        .description('Read the latest direction-trace snapshot (top 5 challenged work packages, most-recently-updated first)')
+        .option('--all', 'Show every challenged work package, not just the top 5')
+        .action(runDirectionList);
+    command.command('refresh')
+        .description('Recompute the workspace-wide direction trace and store a fresh snapshot')
+        .action(runDirectionRefresh);
+    command.command('defer <work-package-id>')
+        .description('Record a bounded, logged deferral for a challenged work package (never an ack, never auto-related)')
+        .requiredOption('--reason <reason>', 'Why this work package is being deferred')
+        .action(runDirectionDefer);
+    return command;
+}
+//# sourceMappingURL=direction.js.map

package/dist/commands/direction.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * pb doctor — health check for CLI configuration and connectivity.
+ *
+ * Runs a series of diagnostic checks (config file, API key, environment,
+ * server reachability, Node version, CLI version) and prints a summary.
+ * Does NOT require an active session — this is a diagnostic tool.
+ *
+ * --fix: auto-repair common configuration issues.
+ * --dry-run: preview what --fix would do without changing anything.
+ *
+ * WP-301 Slice 2 (base), WP-302 Slice 3 (--fix / --dry-run).
+ */
+export interface DoctorOptions {
+    fix?: boolean;
+    dryRun?: boolean;
+}
+export declare function runDoctor(opts?: DoctorOptions): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwUH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4FvE"}