@principles/pd-cli 1.73.2 → 1.74.0

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

@@ -0,0 +1,142 @@
+/**
+ * PD Config Doctor — discovers and explains PD / OpenClaw configuration state.
+ *
+ * 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
+ *   - Provider/model/auth status (classified)
+ *
+ * Constraints:
+ *   - NEVER reads or returns API key values, env var values, or raw config bytes.
+ *   - All file reads are bounded; YAML/JSON is treated as `unknown` and validated.
+ *   - 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 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 {
+    source: string;
+    configPath: string;
+    enabledMvpChannels: string[];
+    disabledFlags: string[];
+    warnings: string[];
+}
+export interface DoctorOutput {
+    status: DoctorStatus;
+    workspaceDir: string;
+    pdConfigPaths: {
+        workspaceDir: ConfigPathEntry;
+        pdDir: ConfigPathEntry;
+        featureFlags: ConfigPathEntry;
+        workflowsYaml: ConfigPathEntry;
+        stateDb: ConfigPathEntry;
+    };
+    openclawConfigPaths: {
+        openclawHome: ConfigPathEntry;
+        openclawConfig: ConfigPathEntry;
+    };
+    featureFlags: FeatureFlagSummary;
+    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[];
+}
+/**
+ * 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 {
+    classification: DoctorClassification;
+    reason: string;
+    observedAt: string | null;
+}
+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

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