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

    Function getForecastLatestForApi

    • 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[];
          }[];
          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: "UP"
                                  | "DOWN";
                                  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: "UP"
                                  | "DOWN";
                                  magnitude: number;
                                  ts: number;
                              }[];
                              ewmaNow: number;
                              intercept: number;
                              outlierCount: number;
                              robustSigma: number;
                              sampleSize: number;
                              slope: number;
                          }
                          | null;
                      },
                  >,
              >;
          };
          status: "INSUFFICIENT_EVIDENCE"
          | "OK";
          v: 1;
      }