@graphrefly/graphrefly 0.27.0 → 0.29.0

package/dist/index-BJqt9EwW.d.ts

@@ -0,0 +1,231 @@
+import { a as Node } from './node-Dd6wHSib.js';
+import { a as GraphOptions, G as Graph } from './graph-Qjg9gWHI.js';
+
+/**
+ * Domain templates (roadmap §8.2).
+ *
+ * Opinionated Graph factories for common "info → action" domains.
+ * Each template wires up §8.1 reduction primitives (stratify, funnel, feedback,
+ * budgetGate, scorer) with domain-specific stages. Users fork/extend by
+ * accessing named nodes and swapping stages.
+ *
+ * **Source injection (option B):** templates accept a `source` node, not a
+ * hardcoded adapter. Pass `fromOTel(...)`, `fromGitHook(...)`, or a test
+ * `state()` — the topology is the same.
+ *
+ * @module
+ */
+
+/** Stratification branch config for observability signals. */
+type ObservabilityBranch = {
+    name: string;
+    classify: (value: unknown) => boolean;
+};
+/** Options for {@link observabilityGraph}. */
+type ObservabilityGraphOptions = GraphOptions & {
+    /** Ingested signal source (e.g. fromOTel(...) or test state). */
+    source: Node<unknown>;
+    /**
+     * Classification rules for signal stratification.
+     * Default: errors / traces / metrics branches.
+     */
+    branches?: ObservabilityBranch[];
+    /**
+     * Correlation function: receives stratified branch values and produces
+     * correlated insights. Default: identity pass-through.
+     */
+    correlate?: (values: unknown[]) => unknown;
+    /**
+     * SLO verification function: returns a verification result for a
+     * correlated insight. Default: always passes.
+     */
+    sloCheck?: (value: unknown) => unknown;
+    /**
+     * Scorer weights for alert prioritization. One per branch.
+     * Default: equal weights [1, 1, 1].
+     */
+    weights?: number[];
+    /** Max feedback iterations for false-positive learning. Default: 5. */
+    maxFeedbackIterations?: number;
+};
+/**
+ * OTel ingest → stratified reduction → correlation → SLO verification →
+ * alert prioritization → output.
+ *
+ * Well-known node names:
+ * - `"source"` — injected signal source
+ * - `"stratify::branch/<name>"` — per-branch classification
+ * - `"correlate"` — cross-branch correlation
+ * - `"slo_value"`, `"slo_verified"` — SLO verification pair
+ * - `"alerts"` — scored, prioritized output
+ * - `"output"` — final output (alias for alerts)
+ *
+ * @category patterns
+ */
+declare function observabilityGraph(name: string, opts: ObservabilityGraphOptions): Graph;
+/** A structured issue extracted from raw findings. */
+type ExtractedIssue = {
+    id: string;
+    title: string;
+    severity: number;
+    source: string;
+    raw: unknown;
+};
+/** Options for {@link issueTrackerGraph}. */
+type IssueTrackerGraphOptions = GraphOptions & {
+    /** Findings source (e.g. fromGitHook(...), fromFSWatch(...)). */
+    source: Node<unknown>;
+    /**
+     * Extract structured issues from raw findings.
+     * Default: wraps raw value as a single issue.
+     */
+    extract?: (raw: unknown) => ExtractedIssue;
+    /**
+     * Verify an extracted issue (assertion check).
+     * Default: always valid.
+     */
+    verify?: (issue: ExtractedIssue) => unknown;
+    /**
+     * Detect regression by comparing against known patterns.
+     * Receives (current issue, known patterns).
+     * Default: no regression detected.
+     */
+    detectRegression?: (issue: ExtractedIssue, known: unknown) => unknown;
+    /** Max feedback iterations for re-scanning. Default: 3. */
+    maxFeedbackIterations?: number;
+};
+/**
+ * Findings ingest → extraction → verification → regression detection →
+ * distillation → prioritized queue.
+ *
+ * Well-known node names:
+ * - `"source"` — injected findings source
+ * - `"extract"` — structured issue extraction
+ * - `"verify"` — issue verification
+ * - `"known_patterns"` — accumulated known issue patterns (state)
+ * - `"regression"` — regression detection
+ * - `"priority"` — severity-based prioritization
+ * - `"output"` — final prioritized output
+ *
+ * @category patterns
+ */
+declare function issueTrackerGraph(name: string, opts: IssueTrackerGraphOptions): Graph;
+/** Classification result from LLM moderation. */
+type ModerationResult = {
+    label: "safe" | "review" | "block";
+    confidence: number;
+    reason?: string;
+    original: unknown;
+};
+/** Options for {@link contentModerationGraph}. */
+type ContentModerationGraphOptions = GraphOptions & {
+    /** Content source (text/multimedia ingest). */
+    source: Node<unknown>;
+    /**
+     * Classification function: returns a ModerationResult.
+     * Default: labels everything "review" with confidence 0.5.
+     */
+    classify?: (content: unknown) => ModerationResult;
+    /** System prompt for LLM classification. */
+    systemPrompt?: string;
+    /** Scorer weights: [safe, review, block]. Default: [0.1, 1, 2]. */
+    weights?: [number, number, number];
+    /** Max feedback iterations for policy refinement. Default: 5. */
+    maxFeedbackIterations?: number;
+    /** Max review queue size. When set, oldest entries are trimmed on overflow. */
+    maxQueueSize?: number;
+};
+/**
+ * Content ingest → LLM/rule classification → stratified routing (safe/review/block) →
+ * human review queue → scorer → feedback (false positives → policy refinement) → output.
+ *
+ * Well-known node names:
+ * - `"source"` — content ingest
+ * - `"classify"` — LLM or rule-based classification
+ * - `"stratify::branch/safe"`, `"stratify::branch/review"`, `"stratify::branch/block"` — routed branches
+ * - `"review_queue"` — state node for human review items
+ * - `"priority"` — scored priority output
+ * - `"policy"` — writable state for policy refinement
+ * - `"output"` — final moderation output
+ *
+ * @category patterns
+ */
+declare function contentModerationGraph(name: string, opts: ContentModerationGraphOptions): Graph;
+/** Schema validation result. */
+type ValidationResult = {
+    valid: boolean;
+    errors: string[];
+    record: unknown;
+};
+/** Anomaly detection result. */
+type AnomalyResult = {
+    anomaly: boolean;
+    score: number;
+    detail?: string;
+    record: unknown;
+};
+/** Options for {@link dataQualityGraph}. */
+type DataQualityGraphOptions = GraphOptions & {
+    /** Data source (e.g. fromPrisma(...), fromKysely(...)). */
+    source: Node<unknown>;
+    /**
+     * Schema validation function.
+     * Default: always valid.
+     */
+    validate?: (record: unknown) => ValidationResult;
+    /**
+     * Anomaly detection function.
+     * Default: no anomaly.
+     */
+    detectAnomaly?: (record: unknown) => AnomalyResult;
+    /**
+     * Drift detection: compares current record against baseline.
+     * Default: no drift.
+     */
+    detectDrift?: (record: unknown, baseline: unknown) => unknown;
+    /**
+     * Remediation suggestion function.
+     * Default: no suggestion.
+     */
+    suggest?: (result: {
+        validation: ValidationResult;
+        anomaly: AnomalyResult;
+    }) => unknown;
+    /** Max feedback iterations for rule refinement. Default: 3. */
+    maxFeedbackIterations?: number;
+};
+/**
+ * Data ingest → schema validation → anomaly detection → drift alerting →
+ * auto-remediation suggestions → output.
+ *
+ * Well-known node names:
+ * - `"source"` — data ingest
+ * - `"validate"` — schema validation
+ * - `"anomaly"` — anomaly detection
+ * - `"baseline"` — rolling baseline state
+ * - `"drift"` — drift detection
+ * - `"remediate"` — auto-remediation suggestions
+ * - `"output"` — combined quality report
+ *
+ * @category patterns
+ */
+declare function dataQualityGraph(name: string, opts: DataQualityGraphOptions): Graph;
+
+type index_AnomalyResult = AnomalyResult;
+type index_ContentModerationGraphOptions = ContentModerationGraphOptions;
+type index_DataQualityGraphOptions = DataQualityGraphOptions;
+type index_ExtractedIssue = ExtractedIssue;
+type index_IssueTrackerGraphOptions = IssueTrackerGraphOptions;
+type index_ModerationResult = ModerationResult;
+type index_ObservabilityBranch = ObservabilityBranch;
+type index_ObservabilityGraphOptions = ObservabilityGraphOptions;
+type index_ValidationResult = ValidationResult;
+declare const index_contentModerationGraph: typeof contentModerationGraph;
+declare const index_dataQualityGraph: typeof dataQualityGraph;
+declare const index_issueTrackerGraph: typeof issueTrackerGraph;
+declare const index_observabilityGraph: typeof observabilityGraph;
+declare namespace index {
+  export { type index_AnomalyResult as AnomalyResult, type index_ContentModerationGraphOptions as ContentModerationGraphOptions, type index_DataQualityGraphOptions as DataQualityGraphOptions, type index_ExtractedIssue as ExtractedIssue, type index_IssueTrackerGraphOptions as IssueTrackerGraphOptions, type index_ModerationResult as ModerationResult, type index_ObservabilityBranch as ObservabilityBranch, type index_ObservabilityGraphOptions as ObservabilityGraphOptions, type index_ValidationResult as ValidationResult, index_contentModerationGraph as contentModerationGraph, index_dataQualityGraph as dataQualityGraph, index_issueTrackerGraph as issueTrackerGraph, index_observabilityGraph as observabilityGraph };
+}
+
+export { type AnomalyResult as A, type ContentModerationGraphOptions as C, type DataQualityGraphOptions as D, type ExtractedIssue as E, type IssueTrackerGraphOptions as I, type ModerationResult as M, type ObservabilityBranch as O, type ValidationResult as V, type ObservabilityGraphOptions as a, issueTrackerGraph as b, contentModerationGraph as c, dataQualityGraph as d, index as i, observabilityGraph as o };