@pdpp/cli 0.1.0-beta.3 → 0.1.0-beta.4

package/README.md

@@ -20,9 +20,9 @@ supports three command namespaces:
   cannot run on its own. The runner ships separately as
   `@pdpp/local-collector` and owns the `pdpp-local-collector` binary; `pdpp
   collector ...` is a slim `@pdpp/cli` shim that resolves that package lazily.
-  Public onboarding should use `npx -y @pdpp/local-collector ...` or
-  `npm i -g @pdpp/local-collector` unless the operator intentionally wants the
-  `@pdpp/cli` shim.
+  Public onboarding should use `npx -y @pdpp/local-collector@beta ...` or
+  `npm i -g @pdpp/local-collector@beta` until the package is promoted from beta
+  to latest, unless the operator intentionally wants the `@pdpp/cli` shim.
 
 - **`pdpp ref ...`** — reference operator diagnostics over `_ref` routes on a
   running reference deployment. Current subcommands: `pdpp ref run timeline
@@ -54,11 +54,11 @@ local workspace launcher.
 The local collector runtime is a separate public package:
 
 ```bash
-# @pdpp/local-collector package, npx-launched pdpp-local-collector binary
-npx -y @pdpp/local-collector advertise
+# @pdpp/local-collector@beta package, npx-launched pdpp-local-collector binary
+npx -y @pdpp/local-collector@beta advertise
 
-# @pdpp/local-collector package, installs the pdpp-local-collector binary
-npm i -g @pdpp/local-collector
+# @pdpp/local-collector@beta package, installs the pdpp-local-collector binary
+npm i -g @pdpp/local-collector@beta
 pdpp-local-collector advertise
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdpp/cli",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.4",
   "description": "Command-line tools for PDPP providers.",
   "type": "module",
   "bin": {

package/src/collector/commands.js

@@ -12,11 +12,12 @@ cannot run on its own. Runner-owned flags are documented by
 Distribution:
   The collector runtime ships in @pdpp/local-collector, a separate npm
   package owned by the PDPP monorepo. @pdpp/cli stays slim and resolves
-  the runner lazily:
-    # @pdpp/local-collector package, installs pdpp-local-collector
-    npm i -g @pdpp/local-collector
-    # @pdpp/local-collector package, npx-launched pdpp-local-collector
-    npx -y @pdpp/local-collector advertise
+  the runner lazily. Until the package is promoted from beta to latest,
+  install or run the beta dist-tag explicitly:
+    # @pdpp/local-collector@beta package, installs pdpp-local-collector
+    npm i -g @pdpp/local-collector@beta
+    # @pdpp/local-collector@beta package, npx-launched pdpp-local-collector
+    npx -y @pdpp/local-collector@beta advertise
   See openspec/changes/publish-pdpp-local-collector/design.md.
 
 Usage:

package/src/collector/runner.js

@@ -10,7 +10,7 @@ import { CollectorUsageError } from './errors.js';
  * Resolve the published `@pdpp/local-collector` package, if installed.
  *
  * The shim prefers an installed `@pdpp/local-collector` so an operator who
- * `npm i -g @pdpp/cli && npm i -g @pdpp/local-collector` can run
+ * `npm i -g @pdpp/cli@beta && npm i -g @pdpp/local-collector@beta` can run
  * `pdpp collector ...` without a monorepo checkout. Resolution is lazy —
  * the CLI does NOT declare a runtime dependency on `@pdpp/local-collector`
  * (per `publish-pdpp-local-collector` task 4.4); a missing package is
@@ -108,12 +108,12 @@ export function resolveTsxBinary(startDir = dirname(fileURLToPath(import.meta.ur
  */
 const RUNNER_MISSING_MESSAGE =
   'pdpp collector requires @pdpp/local-collector. Install once with ' +
-  '"npm i -g @pdpp/local-collector" or run "npx -y @pdpp/local-collector ...". ' +
+  '"npm i -g @pdpp/local-collector@beta" or run "npx -y @pdpp/local-collector@beta ...". ' +
   'See openspec/changes/publish-pdpp-local-collector/design.md.';
 
 const TSX_MISSING_MESSAGE =
   'Could not locate tsx alongside the collector runner. Install ' +
-  '@pdpp/local-collector with "npm i -g @pdpp/local-collector" or run ' +
+  '@pdpp/local-collector with "npm i -g @pdpp/local-collector@beta" or run ' +
   '"pnpm install" at the monorepo root.';
 
 /**

package/src/index.js

@@ -38,9 +38,9 @@ Reference diagnostics (reference server only):
 
 Notes:
   Do not ask users for owner bearer tokens for routine delegated access.
-  "pdpp collector" is a thin @pdpp/cli shim. Install @pdpp/local-collector
-  once, or use "npx -y @pdpp/local-collector ..." directly, for filesystem
-  collectors like Claude Code and Codex.
+  "pdpp collector" is a thin @pdpp/cli shim. Install @pdpp/local-collector@beta
+  once, or use "npx -y @pdpp/local-collector@beta ..." directly, for filesystem
+  collectors like Claude Code and Codex until the package is promoted to latest.
   "pdpp ref" commands require a running PDPP reference server and an owner session.
   "pdpp ref login" caches an owner session in project-local .pdpp/ with mode 0600;
   later "pdpp ref" commands use the cache when --owner-session and