@psiclawops/hypermem 0.6.2 → 0.8.0

package/dist/degradation.js

@@ -0,0 +1,141 @@
+/**
+ * HyperMem Canonical Degradation Contracts, Phase C0.2
+ *
+ * Defines the typed surfaces, reason enum, and format builders for degraded
+ * prompt-visible outputs. These shapes stay in volatile context and should not
+ * cross the stable-prefix boundary.
+ */
+/** All valid DegradationReason values as a readonly array. */
+export const DEGRADATION_REASONS = [
+    'gradient_t2_prose',
+    'gradient_t3_stub',
+    'eviction_oversize',
+    'eviction_turn0_trim',
+    'wave_guard_pressure_high',
+    'wave_guard_pressure_elevated',
+    'budget_cluster_drop',
+    'artifact_oversize',
+    'artifact_fetch_hint',
+    'replay_cold_redis',
+    'replay_stabilizing',
+    'replay_exited',
+    'pressure_mismatch',
+    'unknown',
+];
+/** Field-length caps for canonical degraded strings. */
+export const DEGRADATION_LIMITS = {
+    toolName: 64,
+    toolId: 64,
+    reason: 48,
+    toolSummary: 120,
+    toolArtifactId: 64,
+    artifactId: 64,
+    artifactPath: 160,
+    artifactFetchHint: 80,
+    replayState: 32,
+    replaySummary: 120,
+};
+function sanitizeInline(value) {
+    return value
+        .replace(/[\r\n\t]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .replace(/]/g, ')')
+        .trim();
+}
+function clampInline(value, limit) {
+    const cleaned = sanitizeInline(value);
+    if (cleaned.length <= limit)
+        return cleaned;
+    if (limit <= 3)
+        return cleaned.slice(0, limit);
+    return cleaned.slice(0, limit - 3) + '...';
+}
+export function isDegradationReason(value) {
+    return DEGRADATION_REASONS.includes(value);
+}
+// Matches stubs with or without the optional artifact field.
+const TOOL_CHAIN_RE = /^\[tool:([^\s\]]+) id=([^\s\]]+) status=(ejected) reason=([^\s\]]+)(?: artifact=([^\s\]]+))? summary=(.*)\]$/s;
+export function formatToolChainStub(stub) {
+    const name = clampInline(stub.name, DEGRADATION_LIMITS.toolName);
+    const id = clampInline(stub.id, DEGRADATION_LIMITS.toolId);
+    const reason = clampInline(stub.reason, DEGRADATION_LIMITS.reason);
+    const summary = clampInline(stub.summary, DEGRADATION_LIMITS.toolSummary);
+    const artifactPart = stub.artifactId
+        ? ` artifact=${clampInline(stub.artifactId, DEGRADATION_LIMITS.toolArtifactId)}`
+        : '';
+    return `[tool:${name} id=${id} status=${stub.status} reason=${reason}${artifactPart} summary=${summary}]`;
+}
+export function parseToolChainStub(text) {
+    const match = text.match(TOOL_CHAIN_RE);
+    if (!match)
+        return null;
+    const [, name, id, status, reason, artifactId, summary] = match;
+    if (status !== 'ejected' || !isDegradationReason(reason))
+        return null;
+    const out = { name, id, status: 'ejected', reason, summary };
+    if (artifactId)
+        out.artifactId = artifactId;
+    return out;
+}
+export function isToolChainStub(text) {
+    return parseToolChainStub(text) !== null;
+}
+const ARTIFACT_REF_RE = /^\[artifact:(.+?) path=(.+?) size=(\d+) status=(degraded) reason=(.+?) fetch=(.*)\]$/s;
+export function formatArtifactRef(ref) {
+    const id = clampInline(ref.id, DEGRADATION_LIMITS.artifactId);
+    const path = clampInline(ref.path, DEGRADATION_LIMITS.artifactPath);
+    const reason = clampInline(ref.reason, DEGRADATION_LIMITS.reason);
+    const fetchHint = clampInline(ref.fetchHint, DEGRADATION_LIMITS.artifactFetchHint);
+    return `[artifact:${id} path=${path} size=${ref.sizeTokens} status=${ref.status} reason=${reason} fetch=${fetchHint}]`;
+}
+export function parseArtifactRef(text) {
+    const match = text.match(ARTIFACT_REF_RE);
+    if (!match)
+        return null;
+    const [, id, path, sizeTokens, status, reason, fetchHint] = match;
+    if (status !== 'degraded' || !isDegradationReason(reason))
+        return null;
+    return {
+        id,
+        path,
+        sizeTokens: parseInt(sizeTokens, 10),
+        status: 'degraded',
+        reason,
+        fetchHint,
+    };
+}
+export function isArtifactRef(text) {
+    return parseArtifactRef(text) !== null;
+}
+export function isReplayState(value) {
+    return value === 'entering' || value === 'stabilizing' || value === 'exited';
+}
+const REPLAY_MARKER_RE = /^\[replay state=([^\s\]]+) status=(bounded) reason=([^\s\]]+) summary=(.*)\]$/s;
+export function formatReplayMarker(marker) {
+    const state = clampInline(marker.state, DEGRADATION_LIMITS.replayState);
+    const reason = clampInline(marker.reason, DEGRADATION_LIMITS.reason);
+    const summary = clampInline(marker.summary, DEGRADATION_LIMITS.replaySummary);
+    return `[replay state=${state} status=${marker.status} reason=${reason} summary=${summary}]`;
+}
+export function parseReplayMarker(text) {
+    const match = text.match(REPLAY_MARKER_RE);
+    if (!match)
+        return null;
+    const [, state, status, reason, summary] = match;
+    if (status !== 'bounded' || !isReplayState(state) || !isDegradationReason(reason))
+        return null;
+    return {
+        state,
+        status: 'bounded',
+        reason,
+        summary,
+    };
+}
+export function isReplayMarker(text) {
+    return parseReplayMarker(text) !== null;
+}
+// ─── Shared helpers ───────────────────────────────────────────────────────────
+export function isDegradedContent(text) {
+    return isToolChainStub(text) || isArtifactRef(text) || isReplayMarker(text);
+}
+//# sourceMappingURL=degradation.js.map

package/dist/dreaming-promoter.d.ts

@@ -67,10 +67,48 @@ export interface DreamerResult {
 }
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace-council/{agentId}/
+ * Council agents live at ~/.openclaw/workspace/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export declare function resolveAgentWorkspacePath(agentId: string): Promise<string | null>;
+/**
+ * Temporal-state markers that indicate a fact is time-bound or conditional.
+ *
+ * Facts containing any of these markers MUST carry structured recency metadata
+ * (`validFrom` / `invalidAt` columns) to be eligible for durable promotion.
+ * Plain ISO dates in the content text do NOT satisfy this requirement — a
+ * dated sentence like "suspended pending X as of 2026-04-18" is still temporary
+ * and would harden stale state if promoted.
+ *
+ * Exported so tests and downstream callers can verify coverage and extend it.
+ * Keep this list centralized; do not fork copies into other modules.
+ */
+export declare const TEMPORAL_MARKERS: RegExp[];
+/**
+ * Returns true if content contains any temporal-state marker.
+ * Exported for test coverage and for callers that want to gate their own writes.
+ */
+export declare function hasTemporalMarker(content: string): boolean;
+/**
+ * Structured recency metadata from the facts table.
+ * Either field being set (non-null, non-empty) signals the fact row was
+ * authored with temporal bounds the store can enforce.
+ */
+export interface FactRecencyMeta {
+    validFrom?: string | null;
+    invalidAt?: string | null;
+}
+/**
+ * Reject facts that are clearly noise at promotion time.
+ * A second line of defense — the indexer's isQualityFact() is the primary filter,
+ * but legacy noise in the DB (pre-TUNE-013) still needs to be caught here.
+ *
+ * Additionally blocks promotion of temporally-scoped facts that lack structured
+ * recency metadata. A fact like "model frozen until provider routing stable"
+ * without `validFrom`/`invalidAt` would harden a temporary state into durable
+ * memory forever. Plain ISO dates in content text do NOT bypass this check.
+ */
+export declare function isPromotable(content: string, meta?: FactRecencyMeta): boolean;
 /**
  * Run the dreaming promotion pass for a single agent.
  *

package/dist/dreaming-promoter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dreaming-promoter.d.ts","sourceRoot":"","sources":["../src/dreaming-promoter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,aASpC,CAAC;AAIF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBvF;AA2ND;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,YAAY,EACvB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,OAAO,CAAC,aAAa,CAAC,CAgJxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,YAAY,EACvB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,OAAO,CAAC,aAAa,EAAE,CAAC,CAa1B"}
+{"version":3,"file":"dreaming-promoter.d.ts","sourceRoot":"","sources":["../src/dreaming-promoter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,aASpC,CAAC;AAIF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBvF;AAoKD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,EAyBpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AASD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAsD7E;AAGD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,YAAY,EACvB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,OAAO,CAAC,aAAa,CAAC,CAoJxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,YAAY,EACvB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,OAAO,CAAC,aAAa,EAAE,CAAC,CAa1B"}

package/dist/dreaming-promoter.js

@@ -31,12 +31,12 @@ export const DEFAULT_DREAMER_CONFIG = {
 // ─── Workspace path resolution ───────────────────────────────────────────────
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace-council/{agentId}/
+ * Council agents live at ~/.openclaw/workspace/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export async function resolveAgentWorkspacePath(agentId) {
     const home = os.homedir();
-    const councilPath = path.join(home, '.openclaw', 'workspace-council', agentId);
+    const councilPath = path.join(home, '.openclaw', 'workspace', agentId);
     const workspacePath = path.join(home, '.openclaw', 'workspace', agentId);
     try {
         await fs.access(councilPath);
@@ -185,12 +185,69 @@ async function appendToMemoryFile(memoryPath, entries) {
     }
 }
 // ─── Promotion-time content filter ─────────────────────────────────────────
+/**
+ * Temporal-state markers that indicate a fact is time-bound or conditional.
+ *
+ * Facts containing any of these markers MUST carry structured recency metadata
+ * (`validFrom` / `invalidAt` columns) to be eligible for durable promotion.
+ * Plain ISO dates in the content text do NOT satisfy this requirement — a
+ * dated sentence like "suspended pending X as of 2026-04-18" is still temporary
+ * and would harden stale state if promoted.
+ *
+ * Exported so tests and downstream callers can verify coverage and extend it.
+ * Keep this list centralized; do not fork copies into other modules.
+ */
+export const TEMPORAL_MARKERS = [
+    /\bas of\b/i,
+    /\buntil\b/i,
+    /\bcurrently\b/i,
+    /\bfor now\b/i,
+    /\bsuspended\b/i,
+    /\bpending\b/i,
+    /\brollout\b/i,
+    /\bphase\b/i,
+    /\btemporary\b/i,
+    /\btemporarily\b/i,
+    /\brecheck\b/i,
+    /\bpaused\b/i,
+    /\bblocked\b/i,
+    /\btrial\b/i,
+    /\bexperiment(?:al)?\b/i,
+    /\bexploratory period\b/i,
+    /\bin effect during\b/i,
+    /\bwhile .* (?:continues|ongoing|in progress|rolls out|rolling out)\b/i,
+    /\boverride\b/i,
+    /\bhotfix\b/i,
+    /\bworkaround\b/i,
+    /\bmigration (?:ongoing|in progress|underway)\b/i,
+    /\bfreeze(?:d)?\b/i,
+    /\bpre-release\b/i,
+];
+/**
+ * Returns true if content contains any temporal-state marker.
+ * Exported for test coverage and for callers that want to gate their own writes.
+ */
+export function hasTemporalMarker(content) {
+    return TEMPORAL_MARKERS.some((re) => re.test(content));
+}
+function hasStrongRecencyMetadata(meta) {
+    if (!meta)
+        return false;
+    const vf = (meta.validFrom ?? '').trim();
+    const ia = (meta.invalidAt ?? '').trim();
+    return vf.length > 0 || ia.length > 0;
+}
 /**
  * Reject facts that are clearly noise at promotion time.
  * A second line of defense — the indexer's isQualityFact() is the primary filter,
  * but legacy noise in the DB (pre-TUNE-013) still needs to be caught here.
+ *
+ * Additionally blocks promotion of temporally-scoped facts that lack structured
+ * recency metadata. A fact like "model frozen until provider routing stable"
+ * without `validFrom`/`invalidAt` would harden a temporary state into durable
+ * memory forever. Plain ISO dates in content text do NOT bypass this check.
  */
-function isPromotable(content) {
+export function isPromotable(content, meta) {
     // Multi-line content — reject both actual newlines AND escaped \n sequences
     // (some facts stored pre-TUNE-013 have literal \n in the string value)
     if (content.includes('\n') || content.includes('\\n'))
@@ -236,6 +293,13 @@ function isPromotable(content) {
     // Minimum meaningful length: 50 chars as promotion floor (stricter than indexer's 40)
     if (content.trim().length < 50)
         return false;
+    // Temporal-state screen: if the content is time-bound ("until X", "suspended
+    // pending Y", "rollout phase", etc.) it must carry structured recency
+    // metadata. Otherwise the promoter would harden a temporary state into
+    // durable memory. Plain ISO dates in the content do NOT satisfy this — a
+    // dated sentence confirms the claim is temporary, it does not unblock it.
+    if (hasTemporalMarker(content) && !hasStrongRecencyMetadata(meta))
+        return false;
     return true;
 }
 /**
@@ -284,6 +348,8 @@ export async function runDreamingPromoter(agentId, libraryDb, config = {}) {
       content,
       confidence,
       decay_score,
+      valid_from,
+      invalid_at,
       ROUND((julianday('now') - julianday(created_at)), 2) AS age_days
     FROM facts
     WHERE agent_id = ?
@@ -299,7 +365,7 @@ export async function runDreamingPromoter(agentId, libraryDb, config = {}) {
     result.candidates = rawFacts.length;
     // 4. Score and rank
     const scored = rawFacts
-        .filter(f => isPromotable(f.content))
+        .filter(f => isPromotable(f.content, { validFrom: f.valid_from, invalidAt: f.invalid_at }))
         .map(f => ({
         id: f.id,
         agentId: f.agent_id,

package/dist/expertise-store.d.ts

@@ -0,0 +1,129 @@
+/**
+ * hypermem Expertise Store
+ *
+ * Stores domain expertise patterns — learned behaviors that make the Nth run
+ * better than the 1st. Two-phase lifecycle:
+ *   1. Observations: raw learnings logged from conversations, pipelines, reviews
+ *   2. Patterns: graduated observations with N≥3 confirming instances
+ *
+ * Patterns are agent-scoped but domain-tagged, enabling cross-agent queries.
+ * Patterns have confidence, frequency tracking, and decay on counter-evidence.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+export interface ExpertiseObservation {
+    id: number;
+    agentId: string;
+    domain: string;
+    context: string | null;
+    observationText: string;
+    sourceType: 'conversation' | 'pipeline' | 'review' | 'manual';
+    sourceRef: string | null;
+    createdAt: string;
+}
+export interface ExpertisePattern {
+    id: number;
+    agentId: string;
+    domain: string;
+    patternText: string;
+    confidence: number;
+    frequency: number;
+    firstSeen: string;
+    lastConfirmed: string;
+    invalidatedAt: string | null;
+    invalidationReason: string | null;
+    decayScore: number;
+}
+export interface ExpertiseEvidence {
+    observationId: number;
+    patternId: number;
+    relationship: 'confirms' | 'contradicts';
+    createdAt: string;
+}
+export declare class ExpertiseStore {
+    private readonly db;
+    private readonly graduationThreshold;
+    constructor(db: DatabaseSync, graduationThreshold?: number);
+    /**
+     * Record a raw observation from any source.
+     */
+    record(agentId: string, observationText: string, domain: string, opts?: {
+        context?: string;
+        sourceType?: ExpertiseObservation['sourceType'];
+        sourceRef?: string;
+    }): ExpertiseObservation;
+    /**
+     * Get observations for an agent, optionally filtered by domain.
+     */
+    getObservations(agentId: string, opts?: {
+        domain?: string;
+        limit?: number;
+    }): ExpertiseObservation[];
+    /**
+     * Retrieve active expertise patterns for current work context.
+     * Returns patterns sorted by confidence DESC, frequency DESC.
+     * Excludes invalidated patterns by default.
+     */
+    query(agentId: string, domain: string, opts?: {
+        context?: string;
+        includeInvalidated?: boolean;
+        limit?: number;
+        minConfidence?: number;
+    }): ExpertisePattern[];
+    /**
+     * Cross-agent query: get patterns from any agent in a given domain.
+     * Useful for fleet-wide expertise ("what has any agent learned about X?").
+     */
+    queryFleet(domain: string, opts?: {
+        limit?: number;
+        minConfidence?: number;
+    }): ExpertisePattern[];
+    /**
+     * Graduate an observation to a pattern.
+     *
+     * If a similar pattern already exists (same agent, domain, and pattern text prefix match),
+     * increments its frequency and updates lastConfirmed instead of creating a duplicate.
+     *
+     * Auto-graduation happens when an observation has N≥graduationThreshold confirming
+     * evidence links. Can also be called manually.
+     */
+    graduate(agentId: string, observationId: number, opts?: {
+        patternText?: string;
+        confidence?: number;
+    }): ExpertisePattern | null;
+    /**
+     * Record evidence linking an observation to a pattern.
+     * If this pushes a pattern's contradicting evidence past threshold,
+     * auto-invalidates the pattern.
+     */
+    addEvidence(observationId: number, patternId: number, relationship: 'confirms' | 'contradicts'): void;
+    /**
+     * Check if any observations are ready for auto-graduation.
+     * An observation graduates when it has N≥threshold confirming evidence links.
+     * Returns the number of newly graduated patterns.
+     */
+    autoGraduate(agentId: string): number;
+    /**
+     * Mark a pattern as invalidated.
+     */
+    invalidate(patternId: number, reason: string): boolean;
+    /**
+     * List all active patterns for an agent, optionally filtered by domain.
+     */
+    list(agentId: string, opts?: {
+        domain?: string;
+        includeInvalidated?: boolean;
+    }): ExpertisePattern[];
+    /**
+     * Decay all patterns by a fixed rate. Similar to fact decay.
+     */
+    decayPatterns(agentId: string, decayRate?: number): number;
+    /**
+     * Get pattern and observation counts for an agent.
+     */
+    getStats(agentId: string): {
+        observations: number;
+        activePatterns: number;
+        invalidatedPatterns: number;
+    };
+}
+//# sourceMappingURL=expertise-store.d.ts.map

package/dist/expertise-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expertise-store.d.ts","sourceRoot":"","sources":["../src/expertise-store.ts"],"names":[],"mappings":"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"}