opencode-swarm 7.121.4 → 7.122.0

package/dist/hooks/promotion-evidence-store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Promotion-evidence store (issue #1849 §B2).
+ *
+ * Append-only, FIFO-bounded JSONL store for {@link PromotionEvidenceRecord}s
+ * produced when a validated terminal receipt (applied/violated/contradicted) is
+ * filed. This is the wiring that finally feeds #1847's
+ * {@link evaluatePromotionPolicy} consumer (previously inert "until #1849
+ * produces real receipts").
+ *
+ * Per-worktree by design: promotion evidence records THIS worktree's observed
+ * applications. It is intentionally NOT a member of `KNOWLEDGE_FAMILY` (the
+ * linked-cohort shared-artifact manifest), matching the precedent set by
+ * `src/turbo/epic/promotion-evidence.ts`. It lives under the project-root
+ * `.swarm/` (via {@link validateSwarmPath}), NOT the link-aware shared store
+ * dir, so it stays per-worktree.
+ */
+import type { PromotionEvidenceRecord } from './knowledge-types.js';
+/** Resolve the promotion-evidence log path under the project-root `.swarm/`. */
+export declare function resolvePromotionEvidencePath(directory: string): string;
+/**
+ * Append validated promotion-evidence records. Fail-open + bounded: a write
+ * error logs and continues (the receipt event itself is the authoritative
+ * record; promotion evidence is a derived consumer). FIFO-trims the log when it
+ * exceeds {@link MAX_PROMOTION_EVIDENCE_ENTRIES}.
+ */
+export declare function appendPromotionEvidence(directory: string, records: PromotionEvidenceRecord[]): Promise<void>;
+/**
+ * Load all promotion-evidence records, grouped by entry_id. This is the loader
+ * that replaces the inert stub at `hive-promoter.ts:loadPromotionEvidence`.
+ * Returns an empty object when the file is absent (no evidence yet — the
+ * conservative default). Never throws.
+ */
+export declare function loadPromotionEvidenceByEntry(directory: string): Promise<Record<string, PromotionEvidenceRecord[]>>;