opencandle 0.11.1 → 0.13.0

package/src/runtime/artifact-contracts.ts

@@ -1,77 +0,0 @@
-import type { PolicyCardId, TaskFamily } from "../routing/planning.js";
-
-export type ArtifactContractId =
-  | "concept_example_table"
-  | "portfolio_exposure_map"
-  | "rebalance_action_plan"
-  | "source_coverage_table";
-
-export interface ArtifactContractDefinition {
-  id: ArtifactContractId;
-  taskFamilies: TaskFamily[];
-  description: string;
-  status: "trace_only";
-}
-
-export const ARTIFACT_CONTRACT_REGISTRY: Record<ArtifactContractId, ArtifactContractDefinition> = {
-  concept_example_table: {
-    id: "concept_example_table",
-    taskFamilies: ["concept_explainer"],
-    description: "Compact examples, cross-checks, or comparison rows for educational answers.",
-    status: "trace_only",
-  },
-  portfolio_exposure_map: {
-    id: "portfolio_exposure_map",
-    taskFamilies: ["portfolio_review"],
-    description: "Structural exposure map for portfolio review and rebalance prompts.",
-    status: "trace_only",
-  },
-  rebalance_action_plan: {
-    id: "rebalance_action_plan",
-    taskFamilies: ["portfolio_review"],
-    description: "Staged rebalance action plan with target ranges and execution caveats.",
-    status: "trace_only",
-  },
-  source_coverage_table: {
-    id: "source_coverage_table",
-    taskFamilies: ["sentiment_snapshot", "filing_thesis_review", "current_event_explanation"],
-    description: "Source and provider-gap coverage table for source-heavy answers.",
-    status: "trace_only",
-  },
-};
-
-export function artifactContractIdsForPlanning(input: {
-  taskFamily: TaskFamily;
-  policyCardId: PolicyCardId;
-}): ArtifactContractId[] {
-  if (
-    input.policyCardId === "concept_options_education" ||
-    input.policyCardId === "concept_inflation_cash_education" ||
-    input.policyCardId === "concept_valuation_metric_education"
-  ) {
-    return ["concept_example_table"];
-  }
-  if (input.policyCardId === "portfolio_rebalance_review") {
-    return ["portfolio_exposure_map", "rebalance_action_plan"];
-  }
-  if (
-    input.taskFamily === "sentiment_snapshot" ||
-    input.taskFamily === "filing_thesis_review" ||
-    input.taskFamily === "current_event_explanation"
-  ) {
-    return ["source_coverage_table"];
-  }
-  return [];
-}
-
-export function validateArtifactContractRegistry(): string[] {
-  const errors: string[] = [];
-  for (const [id, contract] of Object.entries(ARTIFACT_CONTRACT_REGISTRY)) {
-    if (contract.id !== id) errors.push(`${id} key must match contract id`);
-    if (contract.status !== "trace_only") errors.push(`${id} must remain trace-only in V1`);
-    if (contract.taskFamilies.length === 0)
-      errors.push(`${id} must declare at least one task family`);
-    if (!contract.description.trim()) errors.push(`${id} must include a description`);
-  }
-  return errors;
-}

package/src/runtime/evidence.ts

@@ -1,78 +0,0 @@
-/** Source of a value flowing through the runtime. */
-export type ProvenanceSource =
-  | "user"
-  | "preference"
-  | "default"
-  | "fetched"
-  | "computed"
-  | "unavailable"
-  | "stale_cache";
-
-/** Tracks where a value came from, when, and with what confidence. */
-export interface Provenance {
-  source: ProvenanceSource;
-  timestamp?: string;
-  provider?: string;
-  confidence?: number;
-  reason?: string;
-}
-
-/** A labeled data point with its provenance. */
-export interface EvidenceRecord {
-  label: string;
-  value: unknown;
-  provenance: Provenance;
-}
-
-/** Successful provider result. */
-export interface ProviderResultOk<T> {
-  status: "ok";
-  data: T;
-  timestamp: string;
-  cached?: boolean;
-  stale?: boolean;
-}
-
-/** Failed/unavailable provider result. */
-export interface ProviderResultUnavailable {
-  status: "unavailable";
-  reason: string;
-  provider: string;
-}
-
-/** Union of provider outcomes — every provider call returns one of these. */
-export type ProviderResult<T> = ProviderResultOk<T> | ProviderResultUnavailable;
-
-/** Type guard for successful provider results. */
-export function isProviderOk<T>(result: ProviderResult<T>): result is ProviderResultOk<T> {
-  return result.status === "ok";
-}
-
-/** Convert a ProviderResult into an EvidenceRecord. */
-export function toEvidenceRecord<T>(
-  label: string,
-  result: ProviderResult<T>,
-  providerId?: string,
-): EvidenceRecord {
-  if (isProviderOk(result)) {
-    return {
-      label,
-      value: result.data,
-      provenance: {
-        source: result.stale ? "stale_cache" : "fetched",
-        timestamp: result.timestamp,
-        provider: providerId,
-        confidence: result.stale ? 0.5 : undefined,
-      },
-    };
-  }
-  return {
-    label,
-    value: null,
-    provenance: {
-      source: "unavailable",
-      reason: result.reason,
-      provider: result.provider,
-    },
-  };
-}

package/src/runtime/numeric-claims.ts

@@ -1,108 +0,0 @@
-import type { EvidenceRecord } from "./evidence.js";
-
-/**
- * Observe-only numeric-claim extraction for synthesis validation (I3).
- *
- * These heuristics bind numbers in analyst prose to tool-result metrics so
- * checkNumberMatch has claims to verify. They are deliberately conservative:
- * every false mismatch poisons the false-positive-rate data that gates the
- * answer-receipts direction (I8 phase 1), so a missed claim is cheaper than
- * a wrong one.
- */
-
-/** Flatten numeric values from a tool-evidence digest preview into labeled tool results. */
-export function collectToolNumbers(record: EvidenceRecord, toolResults: Map<string, number>): void {
-  if (!isPlainObject(record.value)) return;
-  const tool = typeof record.value.tool === "string" ? record.value.tool : undefined;
-  const digest = isPlainObject(record.value.resultDigest) ? record.value.resultDigest : undefined;
-  const preview = typeof digest?.preview === "string" ? digest.preview : undefined;
-  if (!tool || !preview) return;
-  const parsed = parseMaybeJson(preview);
-  if (!parsed) return;
-  for (const [path, value] of flattenNumericValues(parsed)) {
-    toolResults.set(`${tool}.${path}`, value);
-  }
-}
-
-/**
- * Extract numeric claims from step text for metrics present in toolResults.
- *
- * Binding rules (each guards against a live-observed false-positive class):
- * - the metric term must appear as a whole word ("opening" is not `open`)
- * - the number must follow within a short window (no cross-sentence binding)
- * - thousands separators parse as one number ("129,935,067" is not 129)
- * - a prose value that rounds to the tool result is normalized onto it
- *   ("197.14" claims the tool's 197.13999938964844, not a mismatch)
- */
-export function extractNumericClaims(
-  text: string,
-  toolResults: Map<string, number>,
-): EvidenceRecord[] {
-  const records: EvidenceRecord[] = [];
-  for (const [label, expected] of toolResults) {
-    const metric = label.split(".").at(-1);
-    if (!metric) continue;
-    const pattern = new RegExp(
-      `\\b${escapeRegex(metric)}\\b[^\\d-]{0,30}(-?\\d{1,3}(?:,\\d{3})+(?:\\.\\d+)?|-?\\d+(?:\\.\\d+)?)`,
-      "i",
-    );
-    const match = text.match(pattern);
-    if (!match) continue;
-    const value = Number(match[1].replace(/,/g, ""));
-    if (!Number.isFinite(value)) continue;
-    records.push({
-      label,
-      value: isRoundingOf(value, expected) ? expected : value,
-      provenance: { source: "computed" },
-    });
-  }
-  return records;
-}
-
-/** True when `claim` is `expected` rounded to the claim's own precision. */
-function isRoundingOf(claim: number, expected: number): boolean {
-  if (claim === expected) return true;
-  const decimals = countDecimals(claim);
-  const factor = 10 ** decimals;
-  return Math.round(expected * factor) / factor === claim;
-}
-
-function countDecimals(value: number): number {
-  const text = String(value);
-  const dot = text.indexOf(".");
-  return dot === -1 ? 0 : text.length - dot - 1;
-}
-
-function flattenNumericValues(
-  value: Record<string, unknown>,
-  prefix = "",
-): Array<[string, number]> {
-  const values: Array<[string, number]> = [];
-  for (const [key, item] of Object.entries(value)) {
-    const path = prefix ? `${prefix}.${key}` : key;
-    if (typeof item === "number" && Number.isFinite(item)) {
-      values.push([path, item]);
-    } else if (isPlainObject(item)) {
-      values.push(...flattenNumericValues(item, path));
-    }
-  }
-  return values;
-}
-
-function escapeRegex(value: string): string {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-function parseMaybeJson(raw: unknown): Record<string, unknown> | undefined {
-  if (typeof raw !== "string") return undefined;
-  try {
-    const parsed: unknown = JSON.parse(raw);
-    return isPlainObject(parsed) ? parsed : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}