create-principles-disciple 1.145.18 → 1.145.19

package/README.md

@@ -46,8 +46,23 @@ npx create-principles-disciple --yes --workspace "/path/to/workspace" --json
 --non-interactive       Skip prompts
 --workspace <path>      Workspace directory
 --json                  Output result as JSON (implies non-interactive)
+--provider <name>       LLM provider for the pd.default runtime profile (openai/anthropic/deepseek)
+--api-key-env <name>    NAME of the env var holding your LLM API key. Requires --provider
+--model <id>            LLM model id (optional; the per-provider default applies when omitted)
+--base-url <url>        OpenAI-compatible custom endpoint (optional; env: PD_BASE_URL)
 ```
 
+## LLM runtime profile — required before the internal agents can run
+
+PD's internal agents (diagnostician, dreamer, scribe, artificer, signal collector) call the LLM
+provider **you** configure. PD ships no keys, stores no key values, and `--api-key-env` names an
+environment variable rather than carrying a secret.
+
+`--yes` without `--provider` installs in evidence-only mode: pain signals are captured and kept,
+but diagnosis does not run and no principle is proposed. The post-install summary says so, and at any
+later time `pd config doctor --workspace "<path>"` names the missing field. Full operator walkthrough:
+[`docs/runbooks/USER_GUIDE.md`](../../docs/runbooks/USER_GUIDE.md) — “Before You Start: Give PD an LLM”.
+
 ## Post-Install Verification
 
 The installer automatically verifies the installation during setup:

package/_release/product-identity.json

@@ -1,5 +1,5 @@
 {
   "schemaVersion": 1,
   "productVersion": "2.3.10",
-  "sourceCommit": "de6c5bd575e8135aab7bf0bc9f2d9c04e4754f7e"
+  "sourceCommit": "2eeb69dfb7bdfe0c72a291f4172809b64e70a855"
 }

package/console/dist/ui/i18n/en.json

@@ -1459,7 +1459,7 @@
             "configDisabled": "All agents are disabled.",
             "configErrors": "Configuration Errors",
             "internalAgents": "Internal Agents",
-            "internalAgentsDescription": "Each PD internal agent uses an OpenClaw runtime profile. Keys stay outside PD.",
+            "internalAgentsDescription": "Each PD internal agent runs on the runtime profile you configure — provider, model, and the name of the environment variable holding your API key. Keys stay outside PD.",
             "defaultRuntime": "Default Runtime",
             "defaultRuntimeDescription": "The default runtime profile for agents without explicit overrides.",
             "advancedDiagnostics": "Advanced Diagnostics",

package/console/dist/ui/i18n/zh-CN.json

@@ -1459,7 +1459,7 @@
             "configDisabled": "所有智能体已停用。",
             "configErrors": "配置错误",
             "internalAgents": "内部智能体",
-            "internalAgentsDescription": "每个 PD 内部智能体使用一个 OpenClaw 运行时配置。密钥留在 PD 之外。",
+            "internalAgentsDescription": "每个 PD 内部智能体都运行在您配置的运行时配置上——provider、model，以及存放 API Key 的环境变量名。密钥本身留在 PD 之外。",
             "defaultRuntime": "默认运行时",
             "defaultRuntimeDescription": "未设置显式覆盖的智能体使用的默认运行时配置。",
             "advancedDiagnostics": "高级诊断",

package/console/dist/ui/pages/control-center/ControlCenterPage.js

@@ -27,6 +27,14 @@ function validateSource(raw) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+// Overall readiness → the plain-language sentence shown under the internal-agents heading.
+const CONFIG_READINESS_KEY = {
+    ready: "pages.controlCenter.configReady",
+    needs_setup: "pages.controlCenter.configNeedsSetup",
+    not_ready: "pages.controlCenter.configNotReady",
+    unknown: "pages.controlCenter.configUnknown",
+    disabled: "pages.controlCenter.configDisabled",
+};
 function validateReadinessStatus(raw) {
     if (typeof raw !== "string")
         return null;
@@ -486,7 +494,9 @@ export function ControlCenterPage() {
     };
     const overallReadiness = computeOverallReadiness(diagnostics);
     const availableProfiles = catalogData?.profiles ?? configData.runtimeProfiles;
-    return (_jsx(PageShell, { children: _jsxs("div", { className: "animate-[pdFadeIn_400ms_ease-out]", children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.controlCenter.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.controlCenter.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.controlCenter.subtitle") }), _jsx(WorkflowDiagram, {}), _jsx(CompactStatusBar, { readiness: overallReadiness, agents: configData.agents }), _jsx(DesignGatePanel, {}), _jsxs("section", { className: "mt-8", "aria-labelledby": "section-agents", children: [_jsx(SectionTitle, { id: "section-agents", children: t("pages.controlCenter.internalAgents") }), _jsx("p", { className: "text-ink-3 text-[13px] leading-relaxed mb-3", children: t("pages.controlCenter.internalAgentsDescription") }), (() => {
+    return (_jsx(PageShell, { children: _jsxs("div", { className: "animate-[pdFadeIn_400ms_ease-out]", children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.controlCenter.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.controlCenter.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.controlCenter.subtitle") }), _jsx(WorkflowDiagram, {}), _jsx(CompactStatusBar, { readiness: overallReadiness, agents: configData.agents }), _jsx(DesignGatePanel, {}), _jsxs("section", { className: "mt-8", "aria-labelledby": "section-agents", children: [_jsx(SectionTitle, { id: "section-agents", children: t("pages.controlCenter.internalAgents") }), _jsx("p", { className: "text-ink-3 text-[13px] leading-relaxed mb-3", children: t("pages.controlCenter.internalAgentsDescription") }), _jsx("p", { className: overallReadiness === "ready"
+                                ? "text-ink-4 text-[13px] leading-relaxed mb-3"
+                                : "text-amber text-[13px] leading-relaxed mb-3", children: t(CONFIG_READINESS_KEY[overallReadiness]) }), (() => {
                             const { groups, unknown } = groupAgentsByDependency(configData.agents);
                             const locale = i18n.language.startsWith("en")
                                 ? "en"