@pdpp/local-collector 0.7.5 → 0.7.7

package/dist/local-collector/bin/pdpp-local-collector.js

@@ -99,10 +99,12 @@ Subcommands:
           [--queue <path>]
           [--connection-id <id>]
           [--source-instance-id <id>]
+          [--profile <name>]        Optional profile name under the collector profile dir.
   doctor                          Print local durable outbox operator diagnostics as JSON.
           [--queue <path>]
           [--connection-id <id>]
           [--source-instance-id <id>]
+          [--profile <name>]        Optional profile name under the collector profile dir.
   retry-dead-letters              Requeue local dead-letter outbox rows.
           [--queue <path>]
           [--connection-id <id>]
@@ -162,9 +164,10 @@ async function main() {
         return;
     }
     if (options.command === "status" || options.command === "doctor") {
-        const status = inspectLocalOutboxStatus(options);
+        const inspectOptions = resolveInspectionOptions(options);
+        const status = inspectLocalOutboxStatus(inspectOptions);
         if (options.command === "doctor") {
-            const errorSummary = readLocalOutboxDeadLetterErrorSummary(options);
+            const errorSummary = readLocalOutboxDeadLetterErrorSummary(inspectOptions);
             process.stdout.write(`${JSON.stringify(buildLocalOutboxDoctor(status, errorSummary), null, 2)}\n`);
             return;
         }
@@ -667,6 +670,30 @@ function resolveRecoveryOptions(options) {
         profileSource: "configured_queue",
     };
 }
+export function resolveInspectionOptions(options) {
+    const sourceInstanceId = options.sourceInstanceId?.trim();
+    if (!sourceInstanceId || options.explicitOptions?.has("--queue") === true) {
+        return options;
+    }
+    const lookup = findLocalCollectorProfiles({
+        profileName: options.profile ?? null,
+        sourceInstanceId,
+    });
+    if (lookup.matches.length > 1) {
+        throw new CollectorUsageError(`${options.command} found ${lookup.matches.length} local collector profiles for source_instance_id '${sourceInstanceId}'. ` +
+            "Pass --profile <name> to disambiguate.");
+    }
+    if (lookup.matches.length === 1) {
+        return applyProfileEnv(options, lookup.matches[0]);
+    }
+    const configuredQueue = options.queuePath !== DEFAULT_QUEUE_PATH || Boolean(process.env.PDPP_COLLECTOR_QUEUE?.trim());
+    if (!configuredQueue) {
+        throw new CollectorUsageError(`${options.command} could not find a local collector profile for source_instance_id '${sourceInstanceId}'. ` +
+            "Run this on the collector host after enrollment, pass --profile <name>, or set PDPP_COLLECTOR_QUEUE/--queue explicitly. " +
+            "Refusing to inspect the package default queue because it is often unrelated to the enrolled collector.");
+    }
+    return options;
+}
 function hasDeadLetters(status) {
     return status.outbox.counts.dead_letter > 0;
 }

package/dist/polyfill-connectors/src/collector-build-info.js

@@ -1,8 +1,8 @@
 const COLLECTOR_BUILD_SOURCE_SENTINEL = "source";
 const COLLECTOR_BUILD_INFO = {
-    builtAt: "2026-06-17T15:26:17.796Z",
-    revision: "9d555d87a3b7",
-    version: "0.7.5",
+    builtAt: "2026-06-17T16:27:39.528Z",
+    revision: "6603ca9f72be",
+    version: "0.7.7",
 };
 function buildAgentVersion(info = COLLECTOR_BUILD_INFO) {
     return `${info.version}+${info.revision}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdpp/local-collector",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "Publishable local collector runtime for PDPP: filesystem-class connectors (Claude Code, Codex) plus the device-exporter ingest client.",
   "type": "module",
   "private": false,