@productbrain/cli 0.1.0-beta.1428 → 0.1.0-beta.14280

package/dist/lib/spineVerdictRead.js

@@ -0,0 +1,76 @@
+// GENERATED by scripts/generate-mcp-embedded-copies.mjs from kernel/quality/spineVerdictRead.ts.
+// DO NOT EDIT. Run `npm run mcp:embedded-copies` to regenerate.
+// Local runtime copy for the isolated connector build.
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function isStructural(value) {
+    if (!isRecord(value) || typeof value.passed !== 'boolean' || !isStringArray(value.missing) ||
+        !isRecord(value.duplicateSingletons) || !isStringArray(value.unconnectedStrategyIds) ||
+        (value.visionConnectedToPurpose !== null && typeof value.visionConnectedToPurpose !== 'boolean'))
+        return false;
+    for (const key of ['purpose', 'vision']) {
+        const ids = value.duplicateSingletons[key];
+        if (ids !== null && !isStringArray(ids))
+            return false;
+    }
+    for (const key of ['strategiesWithUnknownConnectivity', 'unconnectedObjectiveIds',
+        'objectivesWithUnknownConnectivity', 'unconnectedKeyResultIds', 'keyResultsWithUnknownConnectivity']) {
+        if (value[key] != null && !isStringArray(value[key]))
+            return false;
+    }
+    const stranded = value.strandedWorkPackages;
+    if (stranded != null && !(Array.isArray(stranded) && stranded.every((w) => isRecord(w) && typeof w.id === 'string' && isStringArray(w.pastTargetIds))))
+        return false;
+    return value.visionPurposeConnectivityTruncated === undefined || typeof value.visionPurposeConnectivityTruncated === 'boolean';
+}
+function isStrategy(value) {
+    if (!isRecord(value) || typeof value.entryId !== 'string' || !isRecord(value.refusal) ||
+        typeof value.refusal.hasRefusalSignal !== 'boolean')
+        return false;
+    return value.rogerMartin === null || (isRecord(value.rogerMartin) &&
+        typeof value.rogerMartin.isStrategicChoice === 'boolean' && typeof value.rogerMartin.reasoning === 'string');
+}
+function isStory(value) {
+    return value === null || (isRecord(value) && typeof value.passed === 'boolean' &&
+        (value.failedCriterion === null || typeof value.failedCriterion === 'string') &&
+        Array.isArray(value.criteria) && value.criteria.every((item) => isRecord(item) &&
+        typeof item.id === 'string' && typeof item.passed === 'boolean' && typeof item.reasoning === 'string'));
+}
+/** Branch on the original discriminant before touching optional graded data. */
+export function readSpineVerdict(value) {
+    if (!isRecord(value) || typeof value.noSpineEntries !== 'boolean')
+        return { kind: 'malformed' };
+    // Empty checks have no grade to consume. Historical rows may store structural:null.
+    if (value.noSpineEntries)
+        return { kind: 'empty' };
+    if (!isStructural(value.structural) || !Array.isArray(value.perStrategy) ||
+        !value.perStrategy.every(isStrategy) || !isStory(value.story))
+        return { kind: 'malformed' };
+    for (const key of ['strategiesTruncated', 'perStrategyEvaluationTruncated', 'objectivesTruncated', 'keyResultsTruncated', 'workPackagesTruncated']) {
+        if (value[key] !== undefined && typeof value[key] !== 'boolean')
+            return { kind: 'malformed' };
+    }
+    // Keep the original payload (including newer fields); validation never strips information.
+    return { kind: 'graded', verdict: value };
+}
+/** A capped membership read preserves positive evidence, never infers removals by absence.
+ *  PRRT_kwDORS4ils6iIj0V: `relationsChanged` is a KNOWN, detected connectivity change (a
+ *  part_of edge added or removed — computeSpineVerdictStaleness's relations-fingerprint
+ *  mismatch), never an "unknown" scan outcome — it must render as its own reason, not fall into
+ *  the generic unknown-count branch below (which is reserved for a genuinely unresolved case:
+ *  a pre-migration row with no fingerprint to compare, or a legacy-rule regrade). */
+export function describeSpineStaleness(changedMemberCount, membershipTruncated = false, relationsChanged = false) {
+    if (changedMemberCount > 0) {
+        const reason = `${membershipTruncated ? 'at least ' : ''}${changedMemberCount} entr${changedMemberCount === 1 ? 'y' : 'ies'} changed, joined or left the direction since this was checked`;
+        return reason + (membershipTruncated ? '; membership scan incomplete' : '');
+    }
+    if (relationsChanged) {
+        return 'a part_of or validates link changed since this check ran' + (membershipTruncated ? '; membership scan incomplete' : '');
+    }
+    return 'freshness could not be verified; the changed-entry count is unknown' + (membershipTruncated ? '; membership scan incomplete' : '');
+}
+//# sourceMappingURL=spineVerdictRead.js.map

package/dist/lib/spineVerdictRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spineVerdictRead.js","sourceRoot":"","sources":["../../src/lib/spineVerdictRead.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,gEAAgE;AAChE,uDAAuD;AAsDvD,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;QACzF,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,sBAAsB,CAAC;QACpF,CAAC,KAAK,CAAC,wBAAwB,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,wBAAwB,KAAK,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAChH,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IACvD,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,mCAAmC,EAAE,yBAAyB;QAChF,mCAAmC,EAAE,yBAAyB,EAAE,mCAAmC,CAAC,EAAE,CAAC;QACvG,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACpE,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,oBAAoB,CAAC;IAC5C,IAAI,QAAQ,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrK,OAAO,KAAK,CAAC,kCAAkC,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,kCAAkC,KAAK,SAAS,CAAC;AAChI,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QACpF,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnE,OAAO,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;QAChE,OAAO,KAAK,CAAC,WAAW,CAAC,iBAAiB,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,WAAW,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;AAC/G,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;QAC7E,CAAC,KAAK,CAAC,eAAe,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC;QAC7E,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7E,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAChG,oFAAoF;IACpF,IAAI,KAAK,CAAC,cAAc;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACnD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;QACvE,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC7F,KAAK,MAAM,GAAG,IAAI,CAAC,qBAAqB,EAAE,gCAAgC,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,uBAAuB,CAAC,EAAE,CAAC;QACpJ,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/F,CAAC;IACD,2FAA2F;IAC3F,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAsC,EAAE,CAAC;AAC5E,CAAC;AAGD;;;;;qFAKqF;AACrF,MAAM,UAAU,sBAAsB,CAAC,kBAA0B,EAAE,mBAAmB,GAAG,KAAK,EAAE,gBAAgB,GAAG,KAAK;IACvH,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,kBAAkB,QAAQ,kBAAkB,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,+DAA+D,CAAC;QAC3L,OAAO,MAAM,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,gBAAgB,EAAE,CAAC;QACtB,OAAO,0DAA0D,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjI,CAAC;IACD,OAAO,qEAAqE,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5I,CAAC"}

package/dist/lib/spinner.d.ts

@@ -6,6 +6,7 @@
  * - Non-TTY / quiet / json: silent (no output)
  * - On success: replaces spinner with success message
  * - On failure: replaces spinner with failure message, rethrows
+ * - Overlapping calls share one line, so parallel calls (pb get's chunks, orient beside its Bound scope read) print one
  *
  * Uses raw ANSI escape codes to stay consistent with style.ts (no @clack dependency).
  */
@@ -14,6 +15,8 @@
  *
  * In interactive TTY mode, a spinner appears after 200ms (avoids flicker for
  * fast operations). In non-TTY / quiet / JSON mode, the function runs silently.
+ * Calls that overlap share one line (TASK-1639): it shows the first call's label, its success line prints once when the
+ * last call ends, and a failure ends it at once with the failing call's own label. A joiner's own successMessage is not shown.
  *
  * @param label - Text shown next to the spinner (e.g. "Loading orient data")
  * @param fn - The async operation to run

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

@@ -1 +1 @@
-{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC,CAAC,CAAC,CA4CZ"}
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmDH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/lib/spinner.js

@@ -6,23 +6,60 @@
  * - Non-TTY / quiet / json: silent (no output)
  * - On success: replaces spinner with success message
  * - On failure: replaces spinner with failure message, rethrows
+ * - Overlapping calls share one line, so parallel calls (pb get's chunks, orient beside its Bound scope read) print one
  *
  * Uses raw ANSI escape codes to stay consistent with style.ts (no @clack dependency).
  */
-import { isQuietMode, isJsonMode } from './runner.js';
+import { isQuietMode, isJsonMode, areSpinnersSilenced } from './runner.js';
 import { green, red, icons } from './style.js';
 const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 const FRAME_INTERVAL_MS = 80;
 const DELAYED_START_MS = 200;
 /** Returns true if spinner output should be suppressed. */
 function isSilent() {
-    return !process.stdout.isTTY || isQuietMode() || isJsonMode();
+    return !process.stdout.isTTY || isQuietMode() || isJsonMode() || areSpinnersSilenced();
+}
+let active = null;
+const write = (text) => {
+    // Clear line and write
+    process.stderr.write(`\r\x1b[K${text}`);
+};
+/** Join the active spinner, or start one: its frames appear after 200ms, which avoids a flash for fast operations. */
+function join(label, successMessage) {
+    if (active && !active.done) {
+        active.calls += 1;
+        return active;
+    }
+    const spinner = { label, successMessage, calls: 1, started: false, done: false };
+    let frameIndex = 0;
+    spinner.delay = setTimeout(() => {
+        spinner.started = true;
+        spinner.interval = setInterval(() => {
+            write(`${SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length]} ${spinner.label}`);
+            frameIndex++;
+        }, FRAME_INTERVAL_MS);
+    }, DELAYED_START_MS);
+    active = spinner;
+    return spinner;
+}
+/** Stop the line and print its last word once; the calls still joined to it end silently. */
+function finish(spinner, line) {
+    clearTimeout(spinner.delay);
+    if (spinner.interval)
+        clearInterval(spinner.interval);
+    if (spinner.started)
+        write(line);
+    spinner.done = true;
+    if (active === spinner)
+        active = null;
 }
 /**
  * Run an async function with a contextual spinner.
  *
  * In interactive TTY mode, a spinner appears after 200ms (avoids flicker for
  * fast operations). In non-TTY / quiet / JSON mode, the function runs silently.
+ * Calls that overlap share one line (TASK-1639): it shows the first call's label, its success line prints once when the
+ * last call ends, and a failure ends it at once with the failing call's own label. A joiner's own successMessage is not shown.
  *
  * @param label - Text shown next to the spinner (e.g. "Loading orient data")
  * @param fn - The async operation to run
@@ -35,41 +72,18 @@ export async function withSpinner(label, fn, options) {
     if (isSilent()) {
         return fn();
     }
-    let frameIndex = 0;
-    let spinnerInterval;
-    let started = false;
-    const write = (text) => {
-        // Clear line and write
-        process.stderr.write(`\r\x1b[K${text}`);
-    };
-    const startSpinner = () => {
-        started = true;
-        spinnerInterval = setInterval(() => {
-            const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
-            write(`${frame} ${label}`);
-            frameIndex++;
-        }, FRAME_INTERVAL_MS);
-    };
-    // Delayed start — avoids spinner flash for fast operations
-    const delayTimer = setTimeout(startSpinner, DELAYED_START_MS);
+    const spinner = join(label, options?.successMessage);
     try {
         const result = await fn();
-        clearTimeout(delayTimer);
-        if (spinnerInterval)
-            clearInterval(spinnerInterval);
-        if (started) {
-            const msg = options?.successMessage || label;
-            write(`${green(icons.pass)} ${msg}\n`);
-        }
+        spinner.calls -= 1;
+        if (!spinner.done && spinner.calls === 0)
+            finish(spinner, `${green(icons.pass)} ${spinner.successMessage || spinner.label}\n`);
         return result;
     }
     catch (err) {
-        clearTimeout(delayTimer);
-        if (spinnerInterval)
-            clearInterval(spinnerInterval);
-        if (started) {
-            write(`${red(icons.fail)} ${label} \u2014 failed\n`);
-        }
+        spinner.calls -= 1;
+        if (!spinner.done)
+            finish(spinner, `${red(icons.fail)} ${label} \u2014 failed\n`); // the failing call names itself
         throw err;
     }
 }

package/dist/lib/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1E,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,2DAA2D;AAC3D,SAAS,QAAQ;IACf,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,WAAW,EAAE,IAAI,UAAU,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,EAAoB,EACpB,OAAqC;IAErC,yCAAyC;IACzC,IAAI,QAAQ,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,eAA2D,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;QAC7B,uBAAuB;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,OAAO,GAAG,IAAI,CAAC;QACf,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACjE,KAAK,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;YAC3B,UAAU,EAAE,CAAC;QACf,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,2DAA2D;IAC3D,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,IAAI,eAAe;YAAE,aAAa,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;YAC7C,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,IAAI,eAAe;YAAE,aAAa,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"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"}

package/dist/lib/spinner.test.js

@@ -5,7 +5,7 @@
  * Tests run in a non-TTY environment (vitest), so the spinner is always silent.
  * This validates the critical contract: withSpinner is transparent in non-TTY mode.
  */
-import { describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
 import { withSpinner } from './spinner.js';
 describe('withSpinner', () => {
     it('returns the function result in non-TTY mode', async () => {
@@ -36,4 +36,47 @@ describe('withSpinner', () => {
         expect(elapsed).toBeLessThan(100);
     });
 });
+// TASK-1639: on a terminal, calls that overlap share one line, whatever their number.
+describe('withSpinner on a terminal', () => {
+    const wasTty = process.stdout.isTTY;
+    const onTerminal = () => {
+        let stderr = '';
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => { stderr += String(chunk); return true; });
+        return () => stderr;
+    };
+    const slow = (value, ms) => new Promise((resolve) => setTimeout(() => resolve(value), ms));
+    afterEach(() => { Object.defineProperty(process.stdout, 'isTTY', { value: wasTty, configurable: true }); vi.restoreAllMocks(); });
+    it('overlapping calls paint one line with the first label and print its success line once, when the last ends', async () => {
+        const stderr = onTerminal();
+        const results = await Promise.all([withSpinner('Reading', () => slow(1, 300)), withSpinner('Other', () => slow(2, 400)), withSpinner('Third', () => slow(3, 250))]);
+        expect(results).toEqual([1, 2, 3]);
+        const ended = stderr().split('\n').filter((line) => line.includes('✓'));
+        expect(ended).toHaveLength(1);
+        expect(ended[0]).toContain('Reading');
+        expect(stderr()).not.toContain('Other');
+    });
+    it('a failure ends the shared line once with the failure line, and the calls still running end silently', async () => {
+        const stderr = onTerminal();
+        const failing = withSpinner('Reading', async () => { await slow(0, 250); throw new Error('network failure'); });
+        const running = withSpinner('Other', () => slow(2, 400));
+        await expect(failing).rejects.toThrow('network failure');
+        expect(await running).toBe(2);
+        expect(stderr().split('\n').filter((line) => line.includes('✓') || line.includes('failed'))).toEqual([expect.stringContaining('Reading — failed')]);
+    });
+    it('a joined call that fails names itself on the failure line, and the first call still resolves', async () => {
+        const stderr = onTerminal();
+        const overview = withSpinner('Loading workspace overview', () => slow('view', 400));
+        const read = withSpinner('Running pb get', async () => { await slow(0, 250); throw new Error('read failed'); });
+        await expect(read).rejects.toThrow('read failed');
+        expect(await overview).toBe('view');
+        expect(stderr().split('\n').filter((line) => line.includes('\u2713') || line.includes('failed'))).toEqual([expect.stringContaining('Running pb get \u2014 failed')]);
+    });
+    it('a call after the line ended starts a line of its own', async () => {
+        const stderr = onTerminal();
+        await withSpinner('First', () => slow(1, 250));
+        await withSpinner('Second', () => slow(2, 250));
+        expect(stderr().split('\n').filter((line) => line.includes('✓'))).toEqual([expect.stringContaining('First'), expect.stringContaining('Second')]);
+    });
+});
 //# sourceMappingURL=spinner.test.js.map

package/dist/lib/spinner.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.test.js","sourceRoot":"","sources":["../../src/lib/spinner.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,MAAM,CACV,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAChC,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,SAAS,EACT,KAAK,IAAI,EAAE,CAAC,MAAM,EAClB,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,8DAA8D;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnC,uDAAuD;QACvD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"spinner.test.js","sourceRoot":"","sources":["../../src/lib/spinner.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/startup-signals.d.ts

@@ -0,0 +1,12 @@
+export interface CliStartupSignals {
+    changedPaths?: string[];
+    branchName?: string;
+    worktreeName?: string;
+}
+/**
+ * Collect the CLI's best-effort startup signal bundle for THIS invocation's cwd. Every field is
+ * omitted (not empty-stringed) when unavailable, matching the server validator's `v.optional`
+ * contract (`startupResolutionSignalsValidator`) — an absent key, not a fabricated empty one.
+ */
+export declare function collectCliStartupSignals(cwd?: string): CliStartupSignals;
+//# sourceMappingURL=startup-signals.d.ts.map

package/dist/lib/startup-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-signals.d.ts","sourceRoot":"","sources":["../../src/lib/startup-signals.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAmGD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,CAgCvF"}

package/dist/lib/startup-signals.js

@@ -0,0 +1,173 @@
+/**
+ * WP-486 Slice 1 (FEAT-1371) — CLI-side collection of the startup signals `pb orient --task`
+ * forwards as `changedPaths`, `branchName`, `worktreeName`.
+ *
+ * D1d (WP-754/TASK-204): originally collected to feed the server's `resolveStartupDomain`
+ * (deleted along with domain resolution — D1b/D1c). The sole surviving consumer is
+ * `context.served` activation telemetry (`convex/lib/contextServedInput.ts`'s `changedPaths` and
+ * the `branchNamePresent`/`worktreeNamePresent` presence booleans) — an unrelated purpose this
+ * module's output happens to satisfy unchanged, so it stays.
+ *
+ * Best-effort, fail-open: git absence, a non-repo cwd, or any shell error yields an empty signal
+ * set (never thrown), so a missing/broken git never blocks orient.
+ *
+ * `reviewedArtifactRefs` is deliberately NOT collected here — no CLI source exists (no "artifacts
+ * reviewed this session" tracking), per WP-486 spec §5 exclusions. Server-side sanitization
+ * (`convex/agentKnowledge/startupResolutionSignals.ts`) re-validates and caps every field this
+ * module produces — this collector does the best-effort gather; the server remains the trust
+ * boundary.
+ *
+ * `pb orient --task` is a per-task hot path (every orient call), so this collector reads git only:
+ * no `.productbrain` doc reads and no `gh` subprocess for "PR #N" refs. (The `pb handshake`
+ * deriver that did those reads, once per session-start/close, was deleted with the command in
+ * #1912.) `changedPaths` is the two-source
+ * union (dirty worktree + committed branch delta vs `origin/main`) — see
+ * `collectCliStartupSignals` below — because the spec's own Slice 1 text (WP-B §4) names "git diff
+ * against the worktree's base" as the source, not merely `git status`; PR-review (Codex, PR #369)
+ * caught that the first cut only covered the dirty-worktree half.
+ */
+import { execSync } from 'node:child_process';
+import { basename } from 'node:path';
+const GIT_TIMEOUT_MS = 3_000;
+const CHANGED_PATHS_CAP = 25;
+/** `origin/main` is the worktree's base per Product-OS's one-repo-one-remote convention
+ *  (constitution §2/§3). */
+const BASE_REF = 'origin/main';
+function runGit(cwd, command) {
+    try {
+        const value = execSync(command, {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: GIT_TIMEOUT_MS,
+        }).trim();
+        return value.length > 0 ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Like `runGit`, but for `git status --porcelain`: does NOT `.trim()` the raw output. Porcelain
+ * v1's fixed-width status prefix (two status chars + one space) commonly STARTS with a space
+ * (unstaged-modified is `" M"`, unstaged-deleted is `" D"`); a blanket `.trim()` on the whole
+ * multi-line blob strips exactly that leading space off the FIRST line only, off-by-one-shifting
+ * `parseChangedPaths`'s positional `slice(3)` for that one entry (e.g. `" M convex/x.ts"` →
+ * trimmed → `"M convex/x.ts"` → sliced wrong → `"onvex/x.ts"`). Trims only the trailing newline.
+ */
+function runGitStatusRaw(cwd, command) {
+    try {
+        const value = execSync(command, {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: GIT_TIMEOUT_MS,
+        }).replace(/\r?\n$/, '');
+        return value.length > 0 ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parse `git status --porcelain --untracked-files=all` output into a flat list of changed paths.
+ * `--untracked-files=all` (not the porcelain default `normal`) is REQUIRED: the default mode
+ * collapses a wholly-untracked directory to one entry (`?? src/routes/new-feature/`), losing the
+ * filename/extension evidence the (now-deleted) domain path-glob rules used to key on; `all`
+ * expands it to individual files (`?? src/routes/new-feature/page.svelte`) — reproduced live and
+ * confirmed by PR review (Codex, PR #369) against `git status -h`'s documented
+ * `--untracked-files=<mode>`.
+ *
+ * Rename lines (`R  old -> new`) keep only the new path — consumers of this list (now
+ * `context.served` telemetry) care about the CURRENT file location, not its history. The leading
+ * two-character status code + one
+ * space (porcelain v1's fixed-width prefix) is stripped positionally rather than by
+ * regex-splitting on whitespace, so a path containing spaces survives intact. Callers MUST pass
+ * the UNTRIMMED output (`runGitStatusRaw`, not `runGit`) — see that function's doc for why a
+ * blanket outer trim breaks this positional slice on the first line.
+ */
+function parseChangedPaths(porcelainOutput) {
+    const paths = [];
+    for (const line of porcelainOutput.split(/\r?\n/)) {
+        if (line.length <= 3)
+            continue;
+        let entry = line.slice(3).trim();
+        if (!entry)
+            continue;
+        const renameSep = entry.indexOf(' -> ');
+        if (renameSep !== -1)
+            entry = entry.slice(renameSep + 4).trim();
+        // Porcelain quotes paths containing unusual characters in double quotes — strip them.
+        if (entry.startsWith('"') && entry.endsWith('"'))
+            entry = entry.slice(1, -1);
+        if (entry)
+            paths.push(entry);
+    }
+    return paths;
+}
+/**
+ * Parse `git diff --name-only -z` output — NUL-separated, bare paths, no status prefix. `-z` is
+ * REQUIRED on the caller's git invocation: it disables path quoting outright (regardless of
+ * `core.quotePath`), so a non-ASCII filename (e.g. `café.txt`) that porcelain would otherwise
+ * octal-escape into a quoted string (`"caf\303\251.txt"`) instead comes through as raw UTF-8
+ * bytes — no unescaping needed here, unlike `parseChangedPaths`'s newline-delimited quote strip.
+ */
+function parseNameOnlyPaths(diffOutput) {
+    return diffOutput.split('\0').map((entry) => entry.trim()).filter(Boolean);
+}
+/**
+ * Union two path lists, de-duped, order-stable (first-seen wins), capped at
+ * `CHANGED_PATHS_CAP`. The dirty-worktree and branch-delta lists overlap heavily in the common
+ * case (a file both dirty AND already differing from base), so de-dup keeps the cap from being
+ * spent on repeats.
+ */
+function unionCapped(a, b) {
+    const seen = new Set();
+    const out = [];
+    for (const p of [...a, ...b]) {
+        if (seen.has(p))
+            continue;
+        seen.add(p);
+        out.push(p);
+        if (out.length >= CHANGED_PATHS_CAP)
+            break;
+    }
+    return out;
+}
+/**
+ * Collect the CLI's best-effort startup signal bundle for THIS invocation's cwd. Every field is
+ * omitted (not empty-stringed) when unavailable, matching the server validator's `v.optional`
+ * contract (`startupResolutionSignalsValidator`) — an absent key, not a fabricated empty one.
+ */
+export function collectCliStartupSignals(cwd = process.cwd()) {
+    const signals = {};
+    // Two sources, unioned (the module doc says why PR-diff and local-doc reads stay out of this
+    // hot path):
+    //   1. Dirty worktree (local changes not yet in git) — what the ORIGINAL cut covered.
+    //   2. Committed branch delta vs BASE_REF — a builder mid-lane with a clean, committed
+    //      worktree (the normal `pb orient --task` re-orientation case) otherwise contributes
+    //      NO changedPaths at all, even though the branch differs meaningfully from main. Spec
+    //      text (WP-B §4) names "git diff against the worktree's base" as the source — this closes
+    //      the gap between that text and the first cut's git-status-only implementation (PR #369
+    //      review, Codex).
+    const statusRaw = runGitStatusRaw(cwd, 'git status --porcelain --untracked-files=all');
+    const dirtyPaths = statusRaw ? parseChangedPaths(statusRaw) : [];
+    let branchPaths = [];
+    const mergeBase = runGit(cwd, `git merge-base HEAD ${BASE_REF}`);
+    if (mergeBase) {
+        const branchDiffRaw = runGit(cwd, `git diff --name-only -z ${mergeBase} HEAD`);
+        if (branchDiffRaw)
+            branchPaths = parseNameOnlyPaths(branchDiffRaw);
+    }
+    const allPaths = unionCapped(dirtyPaths, branchPaths);
+    if (allPaths.length > 0)
+        signals.changedPaths = allPaths;
+    const branch = runGit(cwd, 'git branch --show-current');
+    if (branch)
+        signals.branchName = branch;
+    const toplevel = runGit(cwd, 'git rev-parse --show-toplevel');
+    if (toplevel)
+        signals.worktreeName = basename(toplevel);
+    return signals;
+}
+//# sourceMappingURL=startup-signals.js.map

package/dist/lib/startup-signals.js.map

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

package/dist/lib/startup-signals.test.d.ts

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

package/dist/lib/startup-signals.test.d.ts.map

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