@principles/pd-cli 1.74.0 → 1.76.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.
Files changed (38) hide show
  1. package/dist/commands/config-doctor.d.ts +3 -6
  2. package/dist/commands/config-doctor.d.ts.map +1 -1
  3. package/dist/commands/config-doctor.js +30 -31
  4. package/dist/commands/config-doctor.js.map +1 -1
  5. package/dist/commands/console.d.ts +18 -0
  6. package/dist/commands/console.d.ts.map +1 -1
  7. package/dist/commands/console.js +439 -0
  8. package/dist/commands/console.js.map +1 -1
  9. package/dist/commands/runtime-features.d.ts +23 -8
  10. package/dist/commands/runtime-features.d.ts.map +1 -1
  11. package/dist/commands/runtime-features.js +72 -31
  12. package/dist/commands/runtime-features.js.map +1 -1
  13. package/dist/index.js +51 -15
  14. package/dist/index.js.map +1 -1
  15. package/dist/services/config-doctor.d.ts +26 -66
  16. package/dist/services/config-doctor.d.ts.map +1 -1
  17. package/dist/services/config-doctor.js +197 -374
  18. package/dist/services/config-doctor.js.map +1 -1
  19. package/dist/services/console-launcher.d.ts +110 -0
  20. package/dist/services/console-launcher.d.ts.map +1 -0
  21. package/dist/services/console-launcher.js +282 -0
  22. package/dist/services/console-launcher.js.map +1 -0
  23. package/dist/services/pd-config-loader.d.ts +64 -0
  24. package/dist/services/pd-config-loader.d.ts.map +1 -0
  25. package/dist/services/pd-config-loader.js +156 -0
  26. package/dist/services/pd-config-loader.js.map +1 -0
  27. package/package.json +1 -1
  28. package/src/commands/config-doctor.ts +30 -30
  29. package/src/commands/console.ts +445 -1
  30. package/src/commands/runtime-features.ts +98 -44
  31. package/src/index.ts +55 -16
  32. package/src/services/config-doctor.ts +236 -425
  33. package/src/services/console-launcher.ts +373 -0
  34. package/src/services/pd-config-loader.ts +213 -0
  35. package/tests/commands/config-doctor.test.ts +207 -506
  36. package/tests/commands/console-open.test.ts +773 -0
  37. package/tests/commands/runtime-features.test.ts +220 -85
  38. package/tests/services/pd-config-loader.test.ts +479 -0
@@ -1,12 +1,9 @@
1
1
  /**
2
2
  * pd config doctor — Discover and explain PD / OpenClaw configuration state.
3
3
  *
4
- * PRI-299 MVP UX:
5
- * - Reports workspace + OpenClaw config paths and existence
6
- * - Lists effective feature flags and enabled MVP channels
7
- * - Classifies provider/model/auth connectivity (healthy, auth_missing, rate_limit, etc.)
8
- * - Emits `reason` + `nextActions` for failures
9
- * - NEVER leaks tokens, env var values, or raw config bytes
4
+ * PRI-305: Cutover to .pd/config.yaml.
5
+ * - Feature flags and internal agent runtime bindings come from .pd/config.yaml
6
+ * - .pd/feature-flags.yaml and .state/workflows.yaml are no longer production inputs
10
7
  *
11
8
  * Usage:
12
9
  * pd config doctor [--workspace <path>] [--json]
@@ -1 +1 @@
1
- {"version":3,"file":"config-doctor.d.ts","sourceRoot":"","sources":["../../src/commands/config-doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAoGD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3E"}
1
+ {"version":3,"file":"config-doctor.d.ts","sourceRoot":"","sources":["../../src/commands/config-doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAuGD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3E"}
@@ -1,12 +1,9 @@
1
1
  /**
2
2
  * pd config doctor — Discover and explain PD / OpenClaw configuration state.
3
3
  *
4
- * PRI-299 MVP UX:
5
- * - Reports workspace + OpenClaw config paths and existence
6
- * - Lists effective feature flags and enabled MVP channels
7
- * - Classifies provider/model/auth connectivity (healthy, auth_missing, rate_limit, etc.)
8
- * - Emits `reason` + `nextActions` for failures
9
- * - NEVER leaks tokens, env var values, or raw config bytes
4
+ * PRI-305: Cutover to .pd/config.yaml.
5
+ * - Feature flags and internal agent runtime bindings come from .pd/config.yaml
6
+ * - .pd/feature-flags.yaml and .state/workflows.yaml are no longer production inputs
10
7
  *
11
8
  * Usage:
12
9
  * pd config doctor [--workspace <path>] [--json]
@@ -24,7 +21,8 @@ function formatTextOutput(output) {
24
21
  lines.push('PD config paths:');
25
22
  for (const [k, v] of Object.entries(output.pdConfigPaths)) {
26
23
  const exists = v.exists ? '[exists]' : '[missing]';
27
- lines.push(` ${k.padEnd(16)} ${exists.padEnd(10)} ${v.path}`);
24
+ const parseable = v.parseable === false ? ' [unparseable]' : '';
25
+ lines.push(` ${k.padEnd(16)} ${exists.padEnd(10)}${parseable} ${v.path}`);
28
26
  }
29
27
  lines.push('');
30
28
  lines.push('OpenClaw paths:');
@@ -42,6 +40,25 @@ function formatTextOutput(output) {
42
40
  lines.push(` warnings: ${output.featureFlags.warnings.length}`);
43
41
  }
44
42
  lines.push('');
43
+ lines.push('Internal agents:');
44
+ if (output.internalAgents.length === 0) {
45
+ lines.push(' (no internal agents diagnosed)');
46
+ }
47
+ else {
48
+ for (const agent of output.internalAgents) {
49
+ const readiness = agent.readiness.toUpperCase();
50
+ const enabledLabel = agent.enabled ? 'enabled' : 'disabled';
51
+ lines.push(` ${agent.name}: [${readiness}] (${enabledLabel})`);
52
+ lines.push(` profile: ${agent.runtimeProfileLabel} (${agent.runtimeProfileId})`);
53
+ if (agent.apiKeyEnv) {
54
+ const apiKeyState = agent.apiKeyPresent ? 'present' : 'absent';
55
+ lines.push(` apiKeyEnv: ${agent.apiKeyEnv} (${apiKeyState})`);
56
+ }
57
+ lines.push(` reason: ${agent.reason}`);
58
+ lines.push(` nextAction: ${agent.nextAction}`);
59
+ }
60
+ }
61
+ lines.push('');
45
62
  lines.push('Provider health:');
46
63
  if (output.providerHealth.length === 0) {
47
64
  lines.push(' (no providers discovered)');
@@ -49,11 +66,9 @@ function formatTextOutput(output) {
49
66
  else {
50
67
  for (const p of output.providerHealth) {
51
68
  const cls = p.classification.toUpperCase();
52
- const provider = p.provider ?? '(unset)';
53
- const model = p.model ?? '(unset)';
54
69
  const apiKeyEnv = p.apiKeyEnv ?? '(unset)';
55
70
  const apiKeyState = p.apiKeyPresent ? 'present' : 'absent';
56
- lines.push(` [${cls}] ${provider} / ${model}`);
71
+ lines.push(` [${cls}]`);
57
72
  lines.push(` apiKeyEnv: ${apiKeyEnv} (${apiKeyState})`);
58
73
  lines.push(` source: ${p.source}`);
59
74
  lines.push(` reason: ${p.reason}`);
@@ -61,29 +76,13 @@ function formatTextOutput(output) {
61
76
  }
62
77
  }
63
78
  lines.push('');
64
- lines.push('Internal agents:');
65
- if (output.internalAgents && output.internalAgents.correctionObserver) {
66
- const co = output.internalAgents.correctionObserver;
67
- const coStatus = co.status.toUpperCase();
68
- const coProvider = co.provider ?? '(unset)';
69
- const coModel = co.model ?? '(unset)';
70
- const coApiKeyEnv = co.apiKeyEnv ?? '(unset)';
71
- const coApiKeyState = co.apiKeyPresent ? 'present' : 'absent';
72
- lines.push(` correctionObserver: [${coStatus}]`);
73
- lines.push(` enabled: ${co.enabled}`);
74
- lines.push(` flagSource: ${co.flagSource}`);
75
- lines.push(` configSource:${co.configSource}`);
76
- if (co.provider || co.model) {
77
- lines.push(` provider: ${coProvider} / ${coModel}`);
79
+ if (output.legacyFilesDetected.length > 0) {
80
+ lines.push('Legacy files detected (not used for resolution):');
81
+ for (const f of output.legacyFilesDetected) {
82
+ lines.push(` [!] ${f}`);
78
83
  }
79
- lines.push(` apiKeyEnv: ${coApiKeyEnv} (${coApiKeyState})`);
80
- lines.push(` reason: ${co.reason}`);
81
- lines.push(` nextAction: ${co.nextAction}`);
82
- }
83
- else {
84
- lines.push(' (no internal agents diagnosed)');
84
+ lines.push('');
85
85
  }
86
- lines.push('');
87
86
  if (output.warnings.length > 0) {
88
87
  lines.push('Warnings:');
89
88
  for (const w of output.warnings) {
@@ -1 +1 @@
1
- {"version":3,"file":"config-doctor.js","sourceRoot":"","sources":["../../src/commands/config-doctor.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config-doctor.js","sourceRoot":"","sources":["../../src/commands/config-doctor.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,12 @@
1
+ interface ConsoleOpenOptions {
2
+ workspace?: string;
3
+ port?: string;
4
+ host?: string;
5
+ json?: boolean;
6
+ noAuth?: boolean;
7
+ /** Skip browser opening even in non-JSON mode. */
8
+ noBrowser?: boolean;
9
+ }
1
10
  interface ConsoleOptions {
2
11
  workspace?: string;
3
12
  port?: string;
@@ -5,5 +14,14 @@ interface ConsoleOptions {
5
14
  json?: boolean;
6
15
  }
7
16
  export declare function handleConsole(opts?: ConsoleOptions): Promise<void>;
17
+ /**
18
+ * Launch (or reuse) the PD Console with seed-friendly defaults:
19
+ * - Default port 3100; auto-falls back to next free port
20
+ * - Reuses an existing healthy Console if one is already running
21
+ * - Opens the system browser on success (skipped in --json)
22
+ * - Refuses non-loopback hosts
23
+ * - Emits structured reason+nextAction on every failure path
24
+ */
25
+ export declare function handleConsoleOpen(opts?: ConsoleOpenOptions): Promise<void>;
8
26
  export {};
9
27
  //# sourceMappingURL=console.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/commands/console.ts"],"names":[],"mappings":"AAKA,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AASD,wBAAsB,aAAa,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG5E"}
1
+ {"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/commands/console.ts"],"names":[],"mappings":"AAiBA,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AASD,wBAAsB,aAAa,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG5E;AAID;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwZpF"}
@@ -2,6 +2,10 @@ import * as path from 'path';
2
2
  import * as fs from 'fs';
3
3
  import { spawn } from 'child_process';
4
4
  import { resolveWorkspaceDir } from '../resolve-workspace.js';
5
+ import { planConsoleLaunch, openBrowser, isLoopbackHost, normalizeLoopbackHost, probeConsoleHealth, } from '../services/console-launcher.js';
6
+ function sleep(ms) {
7
+ return new Promise((res) => setTimeout(res, ms));
8
+ }
5
9
  function getConsoleDir() {
6
10
  const homeDir = process.env.HOME || process.env.USERPROFILE;
7
11
  if (!homeDir)
@@ -111,4 +115,439 @@ export async function handleConsole(opts = {}) {
111
115
  process.on('SIGINT', cleanup);
112
116
  process.on('SIGTERM', cleanup);
113
117
  }
118
+ // ─── Seed-friendly launcher (pd console open) — PRI-300 ─────────────────────
119
+ /**
120
+ * Launch (or reuse) the PD Console with seed-friendly defaults:
121
+ * - Default port 3100; auto-falls back to next free port
122
+ * - Reuses an existing healthy Console if one is already running
123
+ * - Opens the system browser on success (skipped in --json)
124
+ * - Refuses non-loopback hosts
125
+ * - Emits structured reason+nextAction on every failure path
126
+ */
127
+ export async function handleConsoleOpen(opts = {}) {
128
+ // 1) Loopback safety (ERR-049: refuse non-loopback) — check FIRST so we
129
+ // never reveal runtime information about non-loopback hosts and refuse before workspace resolution.
130
+ const rawHost = opts.host ?? '127.0.0.1';
131
+ // Normalize IPv6 bracket notation: [::1] → ::1 (ERR-049)
132
+ const host = normalizeLoopbackHost(rawHost);
133
+ if (!isLoopbackHost(host)) {
134
+ const result = {
135
+ status: 'refused',
136
+ url: '',
137
+ port: 0,
138
+ host,
139
+ workspaceDir: '',
140
+ reused: false,
141
+ browserOpened: false,
142
+ reason: `Non-loopback host refused: '${host}'. Console binds to loopback only.`,
143
+ nextAction: 'Use the default (127.0.0.1) or "localhost". Do not pass --host 0.0.0.0 or a LAN address.',
144
+ };
145
+ if (opts.json) {
146
+ console.log(JSON.stringify(result, null, 2));
147
+ }
148
+ else {
149
+ console.error(`error: ${result.reason}`);
150
+ console.error(`next: ${result.nextAction}`);
151
+ }
152
+ process.exit(1);
153
+ return;
154
+ }
155
+ // 2) Resolve workspace (ERR-040: fail loud if missing)
156
+ let workspaceDir;
157
+ try {
158
+ workspaceDir = opts.workspace ? path.resolve(opts.workspace) : resolveWorkspaceDir();
159
+ }
160
+ catch (err) {
161
+ const message = err instanceof Error ? err.message : String(err);
162
+ const result = {
163
+ status: 'failed',
164
+ url: '',
165
+ port: 0,
166
+ host,
167
+ workspaceDir: '',
168
+ reused: false,
169
+ browserOpened: false,
170
+ reason: 'workspace_missing',
171
+ nextAction: 'Pass --workspace <path>, set PD_WORKSPACE_DIR, or run from within an initialized workspace.',
172
+ };
173
+ if (opts.json) {
174
+ console.log(JSON.stringify({ ...result, message }, null, 2));
175
+ }
176
+ else {
177
+ console.error(`error: ${message}`);
178
+ console.error(`next: ${result.nextAction}`);
179
+ }
180
+ process.exit(1);
181
+ return;
182
+ }
183
+ // 3) Strict port parsing
184
+ let preferredPort = 3100;
185
+ if (opts.port !== undefined) {
186
+ if (!/^\d+$/.test(opts.port)) {
187
+ const result = {
188
+ status: 'failed',
189
+ url: '',
190
+ port: 0,
191
+ host,
192
+ workspaceDir,
193
+ reused: false,
194
+ browserOpened: false,
195
+ reason: `Invalid --port: '${opts.port}'. Must be an integer 1..65535.`,
196
+ nextAction: 'Use --port 3100 (default) or another valid port number.',
197
+ };
198
+ if (opts.json) {
199
+ console.log(JSON.stringify(result, null, 2));
200
+ }
201
+ else {
202
+ console.error(`error: ${result.reason}`);
203
+ console.error(`next: ${result.nextAction}`);
204
+ }
205
+ process.exit(1);
206
+ return;
207
+ }
208
+ preferredPort = Number(opts.port);
209
+ if (preferredPort < 1 || preferredPort > 65535) {
210
+ const result = {
211
+ status: 'failed',
212
+ url: '',
213
+ port: 0,
214
+ host,
215
+ workspaceDir,
216
+ reused: false,
217
+ browserOpened: false,
218
+ reason: `Invalid --port: '${opts.port}'. Must be an integer 1..65535.`,
219
+ nextAction: 'Use --port 3100 (default) or another valid port number.',
220
+ };
221
+ if (opts.json) {
222
+ console.log(JSON.stringify(result, null, 2));
223
+ }
224
+ else {
225
+ console.error(`error: ${result.reason}`);
226
+ console.error(`next: ${result.nextAction}`);
227
+ }
228
+ process.exit(1);
229
+ return;
230
+ }
231
+ }
232
+ // 3) Check that the console runtime is installed (ERR-040: fail loud if missing)
233
+ const consoleDir = getConsoleDir();
234
+ if (!consoleDir) {
235
+ const result = {
236
+ status: 'failed',
237
+ url: '',
238
+ port: 0,
239
+ host: '127.0.0.1',
240
+ workspaceDir,
241
+ reused: false,
242
+ browserOpened: false,
243
+ reason: 'console_runtime_not_installed',
244
+ nextAction: 'Run: npx create-principles-disciple',
245
+ };
246
+ if (opts.json) {
247
+ console.log(JSON.stringify(result, null, 2));
248
+ }
249
+ else {
250
+ console.error(`error: ${result.reason}`);
251
+ console.error(`next: ${result.nextAction}`);
252
+ }
253
+ process.exit(1);
254
+ return;
255
+ }
256
+ const serverEntry = path.join(consoleDir, 'dist', 'server.js');
257
+ if (!fs.existsSync(serverEntry)) {
258
+ const result = {
259
+ status: 'failed',
260
+ url: '',
261
+ port: 0,
262
+ host: '127.0.0.1',
263
+ workspaceDir,
264
+ reused: false,
265
+ browserOpened: false,
266
+ reason: 'console_server_entry_missing',
267
+ nextAction: `Re-run installer: npx create-principles-disciple (expected ${serverEntry})`,
268
+ };
269
+ if (opts.json) {
270
+ console.log(JSON.stringify(result, null, 2));
271
+ }
272
+ else {
273
+ console.error(`error: ${result.reason}`);
274
+ console.error(`next: ${result.nextAction}`);
275
+ }
276
+ process.exit(1);
277
+ return;
278
+ }
279
+ // 4) Read auth token for health probes (PD_CONSOLE_TOKEN)
280
+ const token = process.env.PD_CONSOLE_TOKEN;
281
+ // 5) Plan the launch (reuse or fresh bind)
282
+ let plan;
283
+ try {
284
+ plan = await planConsoleLaunch({ workspaceDir, preferredPort, host, token });
285
+ }
286
+ catch (err) {
287
+ const message = err instanceof Error ? err.message : String(err);
288
+ const result = {
289
+ status: 'failed',
290
+ url: '',
291
+ port: preferredPort,
292
+ host,
293
+ workspaceDir,
294
+ reused: false,
295
+ browserOpened: false,
296
+ reason: 'launch_plan_error',
297
+ nextAction: 'Inspect logs and retry.',
298
+ };
299
+ if (opts.json) {
300
+ console.log(JSON.stringify({ ...result, message }, null, 2));
301
+ }
302
+ else {
303
+ console.error(`error: launch plan failed: ${message}`);
304
+ }
305
+ process.exit(1);
306
+ return;
307
+ }
308
+ if (plan.status === 'refused') {
309
+ const result = {
310
+ status: 'refused',
311
+ url: '',
312
+ port: plan.port,
313
+ host: plan.host,
314
+ workspaceDir,
315
+ reused: false,
316
+ browserOpened: false,
317
+ reason: plan.reason,
318
+ nextAction: plan.nextAction,
319
+ };
320
+ if (opts.json) {
321
+ console.log(JSON.stringify(result, null, 2));
322
+ }
323
+ else {
324
+ console.error(`error: ${result.reason}`);
325
+ console.error(`next: ${result.nextAction}`);
326
+ }
327
+ process.exit(1);
328
+ return;
329
+ }
330
+ if (plan.status === 'reused') {
331
+ // Existing console — verify health one more time (already healthy from plan, but be safe)
332
+ const health = await probeConsoleHealth({ host: plan.host, port: plan.port, token });
333
+ if (!health.healthy) {
334
+ const result = {
335
+ status: 'failed',
336
+ url: '',
337
+ port: plan.port,
338
+ host: plan.host,
339
+ workspaceDir,
340
+ reused: false,
341
+ browserOpened: false,
342
+ reason: `port_in_use_by_non_console: ${health.reason ?? 'health probe failed'}`,
343
+ nextAction: 'Stop the conflicting process, or use --port <free> to bind a different port.',
344
+ };
345
+ if (opts.json) {
346
+ console.log(JSON.stringify(result, null, 2));
347
+ }
348
+ else {
349
+ console.error(`error: ${result.reason}`);
350
+ console.error(`next: ${result.nextAction}`);
351
+ }
352
+ process.exit(1);
353
+ return;
354
+ }
355
+ // Reused path — do not spawn. Optionally open browser.
356
+ let browserOpened = false;
357
+ let browserWarning;
358
+ if (!opts.json && !opts.noBrowser) {
359
+ const result = await openBrowser(plan.url);
360
+ browserOpened = result.opened;
361
+ if (!result.opened) {
362
+ browserWarning = result.reason;
363
+ }
364
+ }
365
+ const out = {
366
+ status: 'reused',
367
+ url: plan.url,
368
+ port: plan.port,
369
+ host: plan.host,
370
+ workspaceDir,
371
+ reused: true,
372
+ browserOpened,
373
+ nextAction: browserOpened
374
+ ? 'Browser opened to the running Console.'
375
+ : `Open ${plan.url} in your browser to access the Console.`,
376
+ };
377
+ if (browserWarning)
378
+ out.reason = `browser_open_failed: ${browserWarning}`;
379
+ if (opts.json) {
380
+ console.log(JSON.stringify(out, null, 2));
381
+ }
382
+ else {
383
+ console.log(`Reusing existing Console at ${plan.url}`);
384
+ if (browserOpened) {
385
+ console.log('Browser opened.');
386
+ }
387
+ else if (browserWarning) {
388
+ console.log(`Browser not opened: ${browserWarning}`);
389
+ console.log(out.nextAction);
390
+ }
391
+ else {
392
+ console.log(out.nextAction);
393
+ }
394
+ }
395
+ return;
396
+ }
397
+ // 5) Fresh spawn path
398
+ const args = [serverEntry, '--workspace', workspaceDir, '--port', String(plan.port), '--host', plan.host];
399
+ if (opts.noAuth)
400
+ args.push('--no-auth');
401
+ const child = spawn(process.execPath, args, {
402
+ stdio: opts.json ? 'pipe' : 'inherit',
403
+ env: { ...process.env },
404
+ });
405
+ let resolved = false;
406
+ const resolveOnce = (fn) => {
407
+ if (resolved)
408
+ return;
409
+ resolved = true;
410
+ fn();
411
+ };
412
+ const cleanup = () => {
413
+ resolveOnce(() => {
414
+ try {
415
+ child.kill('SIGTERM');
416
+ }
417
+ catch { /* ignore */ }
418
+ process.exit(0);
419
+ });
420
+ };
421
+ child.on('error', (err) => {
422
+ resolveOnce(() => {
423
+ const result = {
424
+ status: 'failed',
425
+ url: '',
426
+ port: plan.port,
427
+ host: plan.host,
428
+ workspaceDir,
429
+ reused: false,
430
+ browserOpened: false,
431
+ reason: `console_spawn_failed: ${err.message}`,
432
+ nextAction: 'Check Node.js and package path configuration.',
433
+ };
434
+ if (opts.json) {
435
+ console.log(JSON.stringify(result, null, 2));
436
+ }
437
+ else {
438
+ console.error(`error: ${result.reason}`);
439
+ }
440
+ try {
441
+ child.kill('SIGTERM');
442
+ }
443
+ catch { /* ignore */ }
444
+ process.exit(1);
445
+ });
446
+ });
447
+ process.on('SIGINT', cleanup);
448
+ process.on('SIGTERM', cleanup);
449
+ // 7) Wait for console ready (bounded poll)
450
+ const readyDeadline = Date.now() + 15_000;
451
+ let ready = false;
452
+ while (Date.now() < readyDeadline) {
453
+ if (child.exitCode !== null)
454
+ break;
455
+ const h = await probeConsoleHealth({ host: plan.host, port: plan.port, timeoutMs: 1000, token });
456
+ if (h.healthy) {
457
+ ready = true;
458
+ break;
459
+ }
460
+ await sleep(250);
461
+ }
462
+ if (child.exitCode !== null && child.exitCode !== 0) {
463
+ const result = {
464
+ status: 'failed',
465
+ url: '',
466
+ port: plan.port,
467
+ host: plan.host,
468
+ workspaceDir,
469
+ reused: false,
470
+ browserOpened: false,
471
+ reason: `console_exited_with_code_${child.exitCode}`,
472
+ nextAction: 'Check console logs above. Re-run: npx create-principles-disciple',
473
+ };
474
+ if (opts.json) {
475
+ console.log(JSON.stringify(result, null, 2));
476
+ }
477
+ else {
478
+ console.error(`error: ${result.reason}`);
479
+ }
480
+ process.exit(typeof child.exitCode === 'number' ? child.exitCode : 1);
481
+ return;
482
+ }
483
+ if (!ready) {
484
+ // Clean up: kill the orphan child
485
+ try {
486
+ child.kill('SIGTERM');
487
+ }
488
+ catch { /* ignore */ }
489
+ const result = {
490
+ status: 'failed',
491
+ url: '',
492
+ port: plan.port,
493
+ host: plan.host,
494
+ workspaceDir,
495
+ reused: false,
496
+ browserOpened: false,
497
+ reason: 'console_health_check_timeout',
498
+ nextAction: 'Increase timeout, free system resources, or re-run: npx create-principles-disciple',
499
+ };
500
+ if (opts.json) {
501
+ console.log(JSON.stringify(result, null, 2));
502
+ }
503
+ else {
504
+ console.error(`error: ${result.reason}`);
505
+ console.error(`next: ${result.nextAction}`);
506
+ }
507
+ process.exit(1);
508
+ return;
509
+ }
510
+ // 7) Console is ready → optionally open browser, emit result, then keep child running
511
+ let browserOpened = false;
512
+ let browserWarning;
513
+ if (!opts.json && !opts.noBrowser) {
514
+ const r = await openBrowser(plan.url);
515
+ browserOpened = r.opened;
516
+ if (!r.opened)
517
+ browserWarning = r.reason;
518
+ }
519
+ const out = {
520
+ status: 'started',
521
+ url: plan.url,
522
+ port: plan.port,
523
+ host: plan.host,
524
+ workspaceDir,
525
+ reused: false,
526
+ browserOpened,
527
+ nextAction: browserOpened
528
+ ? 'Browser opened to the Console. Press Ctrl+C to stop.'
529
+ : `Open ${plan.url} in your browser. Press Ctrl+C to stop.`,
530
+ };
531
+ if (plan.reason)
532
+ out.reason = plan.reason;
533
+ if (browserWarning) {
534
+ out.reason = out.reason ? `${out.reason}; browser_open_failed: ${browserWarning}` : `browser_open_failed: ${browserWarning}`;
535
+ }
536
+ if (opts.json) {
537
+ // Single JSON object on stdout, then keep child attached.
538
+ console.log(JSON.stringify(out, null, 2));
539
+ }
540
+ else {
541
+ console.log(`\nConsole ready: ${plan.url}`);
542
+ console.log(`Workspace: ${workspaceDir}`);
543
+ if (plan.reason)
544
+ console.log(`Note: ${plan.reason}`);
545
+ if (browserOpened) {
546
+ console.log('Browser opened. Press Ctrl+C to stop.');
547
+ }
548
+ else {
549
+ console.log(`Open ${plan.url} in your browser. Press Ctrl+C to stop.`);
550
+ }
551
+ }
552
+ }
114
553
  //# sourceMappingURL=console.js.map