Agent Maturity Compass API - v1.2.0
    Preparing search index...

    Function refreshForecastForApi

    • Parameters

      • params: {
            scope: "agent" | "node" | "workspace";
            targetId?: string | null;
            workspace: string;
        }

      Returns {
          advisories: {
              acknowledged?: { by: string; note: string; ts: number };
              advisoryId: string;
              category:
                  | "DRIFT"
                  | "NOTARY"
                  | "INTEGRITY"
                  | "ANOMALY"
                  | "RISK_INDEX"
                  | "VALUE_REGRESSION"
                  | "GOVERNANCE"
                  | "BUDGET";
              createdTs: number;
              evidenceRefs: { eventHashes: string[]; runIds: string[] };
              recommendedNextSteps: string[];
              scope: { id: string; type: "AGENT" | "WORKSPACE" | "NODE" };
              severity: "INFO" | "WARN" | "CRITICAL";
              summary: string;
              whyNow: string[];
          }[];
          forecast: {
              advisories: {
                  acknowledged?: { by: string; note: string; ts: number };
                  advisoryId: string;
                  category:
                      | "DRIFT"
                      | "NOTARY"
                      | "INTEGRITY"
                      | "ANOMALY"
                      | "RISK_INDEX"
                      | "VALUE_REGRESSION"
                      | "GOVERNANCE"
                      | "BUDGET";
                  createdTs: number;
                  evidenceRefs: { eventHashes: string[]; runIds: string[] };
                  recommendedNextSteps: string[];
                  scope: { id: string; type: "AGENT" | "WORKSPACE" | "NODE" };
                  severity: "INFO" | "WARN" | "CRITICAL";
                  summary: string;
                  whyNow: string[];
              }[];
              anomalies: {
                  evidenceRefs: { eventHashes: string[]; runIds: string[] };
                  explanationTemplateId: string;
                  severity: "INFO" | "WARN" | "CRITICAL";
                  type: string;
              }[];
              drift: {
                  delta: number;
                  evidenceRefs: { eventHashes: string[]; runIds: string[] };
                  metricId: string;
                  severity: "INFO" | "WARN" | "CRITICAL";
                  window: number;
              }[];
              etaToTarget: {
                  conservativeDays?: number;
                  expectedDays?: number;
                  optimisticDays?: number;
                  reasons: string[];
                  status: "UNKNOWN"
                  | "OK";
              };
              evidenceCoverage: {
                  attestedShare: number;
                  latestCorrelationRatio: number;
                  latestIntegrityIndex: number;
                  observedRuns: number;
                  observedShare: number;
                  selfReportedShare: number;
              };
              generatedTs: number;
              horizons: { longDays: number; midDays: number; shortDays: number };
              leadingIndicators: {
                  direction: "IMPROVING" | "STABLE" | "WORSENING";
                  evidenceRefs: { eventHashes: string[]; runIds: string[] };
                  explanationTemplateId: string;
                  id: string;
                  label: string;
                  magnitude: number;
                  robustZ: number;
              }[];
              modelVersion: string;
              policySha256: string;
              reasons: string[];
              scope: { id: string; type: "AGENT"
              | "WORKSPACE"
              | "NODE" };
              series: {
                  correlationRatio: {
                      forecast: {
                          long:
                              | { atTs: number; high: number; low: number; value: number }
                              | null;
                          mid: { atTs: number; high: number; low: number; value: number } | null;
                          short:
                              | { atTs: number; high: number; low: number; value: number }
                              | null;
                      };
                      points: {
                          runId?: string;
                          trustTier?: string;
                          ts: number;
                          value: number;
                      }[];
                      trend: | {
                          changePoints: {
                              direction: "UP"
                              | "DOWN";
                              magnitude: number;
                              ts: number;
                          }[];
                          ewmaNow: number;
                          intercept: number;
                          outlierCount: number;
                          robustSigma: number;
                          sampleSize: number;
                          slope: number;
                      }
                      | null;
                  };
                  fourC: {
                      Capabilities: {
                          forecast: {
                              long: | { atTs: number; high: number; low: number; value: number }
                              | null;
                              mid: { atTs: number; high: number; low: number; value: number } | null;
                              short:
                                  | { atTs: number; high: number; low: number; value: number }
                                  | null;
                          };
                          points: {
                              runId?: string;
                              trustTier?: string;
                              ts: number;
                              value: number;
                          }[];
                          trend: | {
                              changePoints: {
                                  direction: "UP"
                                  | "DOWN";
                                  magnitude: number;
                                  ts: number;
                              }[];
                              ewmaNow: number;
                              intercept: number;
                              outlierCount: number;
                              robustSigma: number;
                              sampleSize: number;
                              slope: number;
                          }
                          | null;
                      };
                      Concept: {
                          forecast: {
                              long: | { atTs: number; high: number; low: number; value: number }
                              | null;
                              mid: { atTs: number; high: number; low: number; value: number } | null;
                              short:
                                  | { atTs: number; high: number; low: number; value: number }
                                  | null;
                          };
                          points: {
                              runId?: string;
                              trustTier?: string;
                              ts: number;
                              value: number;
                          }[];
                          trend: | {
                              changePoints: {
                                  direction: "UP"
                                  | "DOWN";
                                  magnitude: number;
                                  ts: number;
                              }[];
                              ewmaNow: number;
                              intercept: number;
                              outlierCount: number;
                              robustSigma: number;
                              sampleSize: number;
                              slope: number;
                          }
                          | null;
                      };
                      Configuration: {
                          forecast: {
                              long: | { atTs: number; high: number; low: number; value: number }
                              | null;
                              mid: { atTs: number; high: number; low: number; value: number } | null;
                              short:
                                  | { atTs: number; high: number; low: number; value: number }
                                  | null;
                          };
                          points: {
                              runId?: string;
                              trustTier?: string;
                              ts: number;
                              value: number;
                          }[];
                          trend: | {
                              changePoints: {
                                  direction: "UP"
                                  | "DOWN";
                                  magnitude: number;
                                  ts: number;
                              }[];
                              ewmaNow: number;
                              intercept: number;
                              outlierCount: number;
                              robustSigma: number;
                              sampleSize: number;
                              slope: number;
                          }
                          | null;
                      };
                      Culture: {
                          forecast: {
                              long: | { atTs: number; high: number; low: number; value: number }
                              | null;
                              mid: { atTs: number; high: number; low: number; value: number } | null;
                              short:
                                  | { atTs: number; high: number; low: number; value: number }
                                  | null;
                          };
                          points: {
                              runId?: string;
                              trustTier?: string;
                              ts: number;
                              value: number;
                          }[];
                          trend: | {
                              changePoints: {
                                  direction: "UP"
                                  | "DOWN";
                                  magnitude: number;
                                  ts: number;
                              }[];
                              ewmaNow: number;
                              intercept: number;
                              outlierCount: number;
                              robustSigma: number;
                              sampleSize: number;
                              slope: number;
                          }
                          | null;
                      };
                  };
                  indices: Partial<
                      Record<
                          | "EcosystemFocusRisk"
                          | "ClarityPathRisk"
                          | "EconomicSignificanceRisk"
                          | "RiskAssuranceRisk"
                          | "DigitalDualityRisk",
                          {
                              forecast: {
                                  long: | { atTs: number; high: number; low: number; value: number }
                                  | null;
                                  mid:
                                      | { atTs: number; high: number; low: number; value: number }
                                      | null;
                                  short:
                                      | { atTs: number; high: number; low: number; value: number }
                                      | null;
                              };
                              points: {
                                  runId?: string;
                                  trustTier?: string;
                                  ts: number;
                                  value: number;
                              }[];
                              trend: | {
                                  changePoints: {
                                      direction: (...)
                                      | (...);
                                      magnitude: number;
                                      ts: number;
                                  }[];
                                  ewmaNow: number;
                                  intercept: number;
                                  outlierCount: number;
                                  robustSigma: number;
                                  sampleSize: number;
                                  slope: number;
                              }
                              | null;
                          },
                      >,
                  >;
                  integrityIndex: {
                      forecast: {
                          long: | { atTs: number; high: number; low: number; value: number }
                          | null;
                          mid: { atTs: number; high: number; low: number; value: number } | null;
                          short:
                              | { atTs: number; high: number; low: number; value: number }
                              | null;
                      };
                      points: {
                          runId?: string;
                          trustTier?: string;
                          ts: number;
                          value: number;
                      }[];
                      trend: | {
                          changePoints: {
                              direction: "UP"
                              | "DOWN";
                              magnitude: number;
                              ts: number;
                          }[];
                          ewmaNow: number;
                          intercept: number;
                          outlierCount: number;
                          robustSigma: number;
                          sampleSize: number;
                          slope: number;
                      }
                      | null;
                  };
                  maturityOverall: {
                      forecast: {
                          long: | { atTs: number; high: number; low: number; value: number }
                          | null;
                          mid: { atTs: number; high: number; low: number; value: number } | null;
                          short:
                              | { atTs: number; high: number; low: number; value: number }
                              | null;
                      };
                      points: {
                          runId?: string;
                          trustTier?: string;
                          ts: number;
                          value: number;
                      }[];
                      trend: | {
                          changePoints: {
                              direction: "UP"
                              | "DOWN";
                              magnitude: number;
                              ts: number;
                          }[];
                          ewmaNow: number;
                          intercept: number;
                          outlierCount: number;
                          robustSigma: number;
                          sampleSize: number;
                          slope: number;
                      }
                      | null;
                  };
                  operating: Record<
                      string,
                      {
                          forecast: {
                              long: | { atTs: number; high: number; low: number; value: number }
                              | null;
                              mid: { atTs: number; high: number; low: number; value: number } | null;
                              short:
                                  | { atTs: number; high: number; low: number; value: number }
                                  | null;
                          };
                          points: {
                              runId?: string;
                              trustTier?: string;
                              ts: number;
                              value: number;
                          }[];
                          trend: | {
                              changePoints: {
                                  direction: "UP"
                                  | "DOWN";
                                  magnitude: number;
                                  ts: number;
                              }[];
                              ewmaNow: number;
                              intercept: number;
                              outlierCount: number;
                              robustSigma: number;
                              sampleSize: number;
                              slope: number;
                          }
                          | null;
                      },
                  >;
                  value: Partial<
                      Record<
                          | "EmotionalValue"
                          | "FunctionalValue"
                          | "EconomicValue"
                          | "BrandValue"
                          | "LifetimeValue",
                          {
                              forecast: {
                                  long: | { atTs: number; high: number; low: number; value: number }
                                  | null;
                                  mid:
                                      | { atTs: number; high: number; low: number; value: number }
                                      | null;
                                  short:
                                      | { atTs: number; high: number; low: number; value: number }
                                      | null;
                              };
                              points: {
                                  runId?: string;
                                  trustTier?: string;
                                  ts: number;
                                  value: number;
                              }[];
                              trend: | {
                                  changePoints: {
                                      direction: (...)
                                      | (...);
                                      magnitude: number;
                                      ts: number;
                                  }[];
                                  ewmaNow: number;
                                  intercept: number;
                                  outlierCount: number;
                                  robustSigma: number;
                                  sampleSize: number;
                                  slope: number;
                              }
                              | null;
                          },
                      >,
                  >;
              };
              status: "INSUFFICIENT_EVIDENCE"
              | "OK";
              v: 1;
          };
          latestPath: string
          | null;
          snapshotPath: string | null;
          snapshotSha256: string | null;
      }