@pdpp/cli 0.1.0-beta.8 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -12
- package/package.json +2 -2
- package/src/collector/commands.js +5 -6
- package/src/collector/runner.js +3 -3
- package/src/index.js +3 -3
- package/src/package-info.d.ts +2 -2
- package/src/package-info.js +4 -2
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ Command-line tools for PDPP providers.
|
|
|
4
4
|
|
|
5
5
|
## Status
|
|
6
6
|
|
|
7
|
-
This package is the public npm home for the `pdpp` command. The
|
|
7
|
+
This package is the public npm home for the `pdpp` command. The CLI
|
|
8
8
|
supports four command namespaces:
|
|
9
9
|
|
|
10
10
|
- **`pdpp connect <provider-url>`** — delegated access: discovers provider
|
|
@@ -61,9 +61,9 @@ supports four command namespaces:
|
|
|
61
61
|
cannot run on its own. The runner ships separately as
|
|
62
62
|
`@pdpp/local-collector` and owns the `pdpp-local-collector` binary; `pdpp
|
|
63
63
|
collector ...` is a slim `@pdpp/cli` shim that resolves that package lazily.
|
|
64
|
-
Public onboarding should use `npx -y @pdpp/local-collector
|
|
65
|
-
`npm i -g @pdpp/local-collector
|
|
66
|
-
|
|
64
|
+
Public onboarding should use `npx -y @pdpp/local-collector ...` or
|
|
65
|
+
`npm i -g @pdpp/local-collector`, unless the operator intentionally wants
|
|
66
|
+
the `@pdpp/cli` shim.
|
|
67
67
|
|
|
68
68
|
- **`pdpp ref ...`** — reference operator diagnostics over `_ref` routes on a
|
|
69
69
|
running reference deployment. Current subcommands: `pdpp ref run timeline
|
|
@@ -75,12 +75,9 @@ supports four command namespaces:
|
|
|
75
75
|
|
|
76
76
|
```bash
|
|
77
77
|
# @pdpp/cli package, npx-launched pdpp binary
|
|
78
|
-
npx -y @pdpp/cli
|
|
78
|
+
npx -y @pdpp/cli --help
|
|
79
79
|
```
|
|
80
80
|
|
|
81
|
-
Use the `beta` dist-tag until PDPP intentionally enables stable `latest`
|
|
82
|
-
publication.
|
|
83
|
-
|
|
84
81
|
When working from this monorepo without installing or linking the binary, use
|
|
85
82
|
the workspace executable:
|
|
86
83
|
|
|
@@ -95,11 +92,11 @@ local workspace launcher.
|
|
|
95
92
|
The local collector runtime is a separate public package:
|
|
96
93
|
|
|
97
94
|
```bash
|
|
98
|
-
# @pdpp/local-collector
|
|
99
|
-
npx -y @pdpp/local-collector
|
|
95
|
+
# @pdpp/local-collector package, npx-launched pdpp-local-collector binary
|
|
96
|
+
npx -y @pdpp/local-collector advertise
|
|
100
97
|
|
|
101
|
-
# @pdpp/local-collector
|
|
102
|
-
npm i -g @pdpp/local-collector
|
|
98
|
+
# @pdpp/local-collector package, installs the pdpp-local-collector binary
|
|
99
|
+
npm i -g @pdpp/local-collector
|
|
103
100
|
pdpp-local-collector advertise
|
|
104
101
|
```
|
|
105
102
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pdpp/cli",
|
|
3
|
-
"version": "0.1.0
|
|
3
|
+
"version": "0.1.0",
|
|
4
4
|
"description": "Command-line tools for PDPP providers.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -44,6 +44,6 @@
|
|
|
44
44
|
"access": "public",
|
|
45
45
|
"provenance": false,
|
|
46
46
|
"registry": "https://registry.npmjs.org/",
|
|
47
|
-
"tag": "
|
|
47
|
+
"tag": "latest"
|
|
48
48
|
}
|
|
49
49
|
}
|
|
@@ -12,12 +12,11 @@ cannot run on its own. Runner-owned flags are documented by
|
|
|
12
12
|
Distribution:
|
|
13
13
|
The collector runtime ships in @pdpp/local-collector, a separate npm
|
|
14
14
|
package owned by the PDPP monorepo. @pdpp/cli stays slim and resolves
|
|
15
|
-
the runner lazily.
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
npx -y @pdpp/local-collector@beta advertise
|
|
15
|
+
the runner lazily. Install or run it from npm:
|
|
16
|
+
# @pdpp/local-collector package, installs pdpp-local-collector
|
|
17
|
+
npm i -g @pdpp/local-collector
|
|
18
|
+
# @pdpp/local-collector package, npx-launched pdpp-local-collector
|
|
19
|
+
npx -y @pdpp/local-collector advertise
|
|
21
20
|
See openspec/changes/publish-pdpp-local-collector/design.md.
|
|
22
21
|
|
|
23
22
|
Usage:
|
package/src/collector/runner.js
CHANGED
|
@@ -10,7 +10,7 @@ import { CollectorUsageError } from './errors.js';
|
|
|
10
10
|
* Resolve the published `@pdpp/local-collector` package, if installed.
|
|
11
11
|
*
|
|
12
12
|
* The shim prefers an installed `@pdpp/local-collector` so an operator who
|
|
13
|
-
* `npm i -g @pdpp/cli
|
|
13
|
+
* `npm i -g @pdpp/cli && npm i -g @pdpp/local-collector` can run
|
|
14
14
|
* `pdpp collector ...` without a monorepo checkout. Resolution is lazy —
|
|
15
15
|
* the CLI does NOT declare a runtime dependency on `@pdpp/local-collector`
|
|
16
16
|
* (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
|
|
|
108
108
|
*/
|
|
109
109
|
const RUNNER_MISSING_MESSAGE =
|
|
110
110
|
'pdpp collector requires @pdpp/local-collector. Install once with ' +
|
|
111
|
-
'"npm i -g @pdpp/local-collector
|
|
111
|
+
'"npm i -g @pdpp/local-collector" or run "npx -y @pdpp/local-collector ...". ' +
|
|
112
112
|
'See openspec/changes/publish-pdpp-local-collector/design.md.';
|
|
113
113
|
|
|
114
114
|
const TSX_MISSING_MESSAGE =
|
|
115
115
|
'Could not locate tsx alongside the collector runner. Install ' +
|
|
116
|
-
'@pdpp/local-collector with "npm i -g @pdpp/local-collector
|
|
116
|
+
'@pdpp/local-collector with "npm i -g @pdpp/local-collector" or run ' +
|
|
117
117
|
'"pnpm install" at the monorepo root.';
|
|
118
118
|
|
|
119
119
|
/**
|
package/src/index.js
CHANGED
|
@@ -54,9 +54,9 @@ Reference diagnostics (reference server only):
|
|
|
54
54
|
|
|
55
55
|
Notes:
|
|
56
56
|
Do not ask users for owner bearer tokens for routine delegated access.
|
|
57
|
-
"pdpp collector" is a thin @pdpp/cli shim. Install @pdpp/local-collector
|
|
58
|
-
once, or use "npx -y @pdpp/local-collector
|
|
59
|
-
collectors like Claude Code and Codex
|
|
57
|
+
"pdpp collector" is a thin @pdpp/cli shim. Install @pdpp/local-collector
|
|
58
|
+
once, or use "npx -y @pdpp/local-collector ..." directly, for filesystem
|
|
59
|
+
collectors like Claude Code and Codex.
|
|
60
60
|
"pdpp ref" commands require a running PDPP reference server and an owner session.
|
|
61
61
|
"pdpp ref login" caches an owner session in project-local .pdpp/ with mode 0600;
|
|
62
62
|
later "pdpp ref" commands use the cache when --owner-session and
|
package/src/package-info.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export const PDPP_CLI_PACKAGE_NAME: string;
|
|
2
2
|
export const PDPP_CLI_BIN_NAME: string;
|
|
3
|
-
export const PDPP_CLI_VERSION_POLICY: "
|
|
3
|
+
export const PDPP_CLI_VERSION_POLICY: "latest";
|
|
4
4
|
export const PDPP_CLI_PACKAGE_SPECIFIER: string;
|
|
5
5
|
export const PDPP_CLI_DEFAULT_CLIENT_ID: "pdpp_cli";
|
|
6
6
|
export const PDPP_CLI_NO_OWNER_TOKEN_POLICY: "owner_browser_approval_required";
|
|
@@ -10,7 +10,7 @@ export interface PdppCliPackageInfo {
|
|
|
10
10
|
packageSpecifier: string;
|
|
11
11
|
binName: string;
|
|
12
12
|
defaultClientId: "pdpp_cli";
|
|
13
|
-
versionPolicy: "
|
|
13
|
+
versionPolicy: "latest";
|
|
14
14
|
runCommand: string;
|
|
15
15
|
noOwnerToken: true;
|
|
16
16
|
noOwnerTokenPolicy: "owner_browser_approval_required";
|
package/src/package-info.js
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
export const PDPP_CLI_PACKAGE_NAME = '@pdpp/cli';
|
|
2
2
|
export const PDPP_CLI_BIN_NAME = 'pdpp';
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
// Single release channel: the published package rides npm's default `latest`
|
|
4
|
+
// dist-tag, so the advertised specifier is the plain package name.
|
|
5
|
+
export const PDPP_CLI_VERSION_POLICY = 'latest';
|
|
6
|
+
export const PDPP_CLI_PACKAGE_SPECIFIER = PDPP_CLI_PACKAGE_NAME;
|
|
5
7
|
export const PDPP_CLI_DEFAULT_CLIENT_ID = 'pdpp_cli';
|
|
6
8
|
export const PDPP_CLI_NO_OWNER_TOKEN_POLICY = 'owner_browser_approval_required';
|
|
7
9
|
|