@principles/pd-cli 1.74.0 → 1.76.0

package/dist/services/config-doctor.d.ts

@@ -1,10 +1,16 @@
 /**
- * PD Config Doctor — discovers and explains PD / OpenClaw configuration state.
+ * pd config doctor — Discover and explain PD / OpenClaw configuration state.
+ *
+ * PRI-305: Cutover to .pd/config.yaml.
+ *   - Feature flags and internal agent runtime bindings come from .pd/config.yaml
+ *   - .pd/feature-flags.yaml and .state/workflows.yaml are no longer production inputs
+ *   - Legacy files are detected and reported as warnings
  *
  * PRI-299 MVP UX: provides a single, read-only view of:
  *   - PD workspace config paths (with existence checks)
  *   - OpenClaw config paths (with existence checks)
- *   - Effective feature flags
+ *   - Effective feature flags from .pd/config.yaml
+ *   - Internal agent runtime binding readiness from .pd/config.yaml
  *   - Provider/model/auth status (classified)
  *
  * Constraints:
@@ -13,24 +19,21 @@
  *   - Missing/malformed config produces a structured warning, never a crash.
  *   - Failures include `reason` and `nextAction` for operator guidance.
  */
-export type DoctorClassification = 'healthy' | 'config_missing' | 'auth_missing' | 'rate_limit' | 'unavailable' | 'parse_failure' | 'unknown';
+export type DoctorClassification = 'healthy' | 'config_missing' | 'auth_missing' | 'needs_probe' | 'rate_limit' | 'unavailable' | 'parse_failure' | 'unknown';
 export type DoctorStatus = 'ok' | 'degraded' | 'failed';
 export interface ConfigPathEntry {
     path: string;
     exists: boolean;
-    /** Optional structural check (file is parseable JSON/YAML, etc.) */
     parseable?: boolean;
 }
 export interface ProviderHealthEntry {
     provider: string | null;
     model: string | null;
     apiKeyEnv: string | null;
-    /** True if the env var name is non-empty and the env var is set. */
     apiKeyPresent: boolean;
     classification: DoctorClassification;
     reason: string;
     nextAction: string;
-    /** Source of the discovered config (e.g., 'workflows.yaml', 'cli_flag', 'default'). */
     source: string;
 }
 export interface FeatureFlagSummary {
@@ -40,14 +43,26 @@ export interface FeatureFlagSummary {
     disabledFlags: string[];
     warnings: string[];
 }
+export interface InternalAgentDiagnostics {
+    name: string;
+    enabled: boolean;
+    runtimeProfileId: string;
+    runtimeProfileLabel: string;
+    readiness: 'ready' | 'not_ready' | 'needs_setup' | 'disabled' | 'unknown';
+    provider: string | null;
+    model: string | null;
+    apiKeyEnv: string | null;
+    apiKeyPresent: boolean;
+    reason: string;
+    nextAction: string;
+}
 export interface DoctorOutput {
     status: DoctorStatus;
     workspaceDir: string;
     pdConfigPaths: {
         workspaceDir: ConfigPathEntry;
         pdDir: ConfigPathEntry;
-        featureFlags: ConfigPathEntry;
-        workflowsYaml: ConfigPathEntry;
+        configYaml: ConfigPathEntry;
         stateDb: ConfigPathEntry;
     };
     openclawConfigPaths: {
@@ -55,35 +70,18 @@ export interface DoctorOutput {
         openclawConfig: ConfigPathEntry;
     };
     featureFlags: FeatureFlagSummary;
+    internalAgents: InternalAgentDiagnostics[];
     providerHealth: ProviderHealthEntry[];
-    internalAgents: {
-        correctionObserver: {
-            enabled: boolean;
-            flagSource: string;
-            status: 'disabled' | 'configured' | 'auth_missing' | 'config_missing' | 'unavailable';
-            configSource: 'workflows.yaml' | 'env' | 'missing' | 'unavailable';
-            provider: string | null;
-            model: string | null;
-            apiKeyEnv: string | null;
-            apiKeyPresent: boolean;
-            reason: string;
-            nextAction: string;
-        };
-    };
     warnings: string[];
     reason?: string;
     nextActions: string[];
+    /** Legacy files detected (informational only, not used for resolution) */
+    legacyFilesDetected: string[];
 }
-/**
- * Resolve the OpenClaw home directory used to look up `openclaw.json` and
- * extension state. PD does not own this path — it only reports its existence.
- */
 export declare function getOpenClawHome(): string;
 export declare function getOpenClawConfigPath(): string;
 export interface InspectStateDbOptions {
-    /** Max rows to scan from tasks table. */
     maxRows?: number;
-    /** Max age in ms — only signals within this window are considered "recent". */
     maxAgeMs?: number;
 }
 export interface RecentProviderSignal {
@@ -93,50 +91,12 @@ export interface RecentProviderSignal {
 }
 export interface StateDbSignalResult {
     signal: RecentProviderSignal | null;
-    /** True if the DB was found and could be opened in readonly mode. */
     dbReachable: boolean;
-    /** Optional warning when the DB exists but couldn't be read. */
     warning?: string;
 }
-/**
- * Read the state.db recent provider error signal (best-effort, structural only).
- *
- * We inspect recent task/run rows in `<workspaceDir>/.pd/state.db` to detect
- * `rate_limit` / `auth_missing` / `unavailable` signals from the live pipeline.
- * This is a bounded best-effort probe — if the DB is missing or unreadable we
- * return `null` and let the doctor fall back to config-only classification.
- */
 export declare function inspectStateDbForProviderSignal(stateDbPath: string, nowMs?: number, opts?: InspectStateDbOptions): Promise<StateDbSignalResult>;
-/**
- * Resolve the provider/model/apiKeyEnv from the workspace's `workflows.yaml`
- * funnel policy. Returns `null` for each field when not configured.
- *
- * NEVER leaks api key values or env var values.
- */
-export interface ProviderConfigFromWorkflows {
-    provider: string | null;
-    model: string | null;
-    apiKeyEnv: string | null;
-    baseUrl: string | null;
-    source: 'workflows.yaml' | 'cli_flag' | 'default' | 'missing';
-    /** True if the workflows.yaml file was found and parseable. */
-    workflowsFound: boolean;
-    /** Parse warning, if any. */
-    parseWarning?: string;
-}
-export declare function resolveProviderConfigFromWorkflows(stateDir: string, opts?: {
-    cliProvider?: string;
-    cliModel?: string;
-    cliApiKeyEnv?: string;
-    cliBaseUrl?: string;
-}): Promise<ProviderConfigFromWorkflows>;
 export interface BuildDoctorInput {
     workspaceDir: string;
-    /** Optional CLI overrides for provider/model/apiKeyEnv. */
-    cliProvider?: string;
-    cliModel?: string;
-    cliApiKeyEnv?: string;
-    cliBaseUrl?: string;
 }
 export declare function buildDoctorOutput(input: BuildDoctorInput): Promise<DoctorOutput>;
 //# sourceMappingURL=config-doctor.d.ts.map

package/dist/services/config-doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-doctor.d.ts","sourceRoot":"","sources":["../../src/services/config-doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-doctor.d.ts","sourceRoot":"","sources":["../../src/services/config-doctor.ts"],"names":[],"mappings":"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"}