agentsmesh 0.32.0 → 0.34.0

package/dist/{init-CrZhoNTj.d.ts → init-ChDbKSJ0.d.ts}

@@ -172,11 +172,6 @@ interface GuardrailWarning {
     readonly message: string;
 }
 
-/**
- * Capture rejection errors thrown by {@link addLessonInto}. Kept in their own
- * module so `add.ts` stays focused on the mutation logic; re-exported from
- * `add.js` so every existing importer keeps its `from './add.js'` path.
- */
 declare class UnknownTopicError extends Error {
     readonly topic: string;
     readonly code = "UNKNOWN_TOPIC";
@@ -387,15 +382,20 @@ declare function importLegacyLessons(projectRoot: string, options: ImportLegacyO
  * cross-process mutex without any third-party dependency.
  *
  * Stale recovery: the holder writes its PID and start timestamp into the lock
- * dir. On contention we peek at the PID; if the process is gone or the lock is
- * older than `staleMs`, we evict it and retry.
+ * dir. On contention we peek at the PID: a dead same-host holder is evicted at
+ * once. A live holder (or one on another host, whose PID we cannot probe) is
+ * evicted only past `staleMs` — an hours-long bound that catches a hung
+ * process or a recycled PID, never a slow but healthy run.
  */
 interface LockOptions {
     /** Maximum retry attempts before throwing LockAcquisitionError. */
     retries?: number;
     /** Delay between retries in ms. */
     retryDelayMs?: number;
-    /** Lock age beyond which an existing lock is treated as stale and evicted. */
+    /**
+     * Secondary age bound (default 6h): a lock older than this is evicted even
+     * when its holder PID is still alive or cannot be probed (other host).
+     */
     staleMs?: number;
     /** Human-readable lock name surfaced in LockAcquisitionError, e.g. "lessons lock". */
     label?: string;
@@ -469,7 +469,7 @@ declare function toRelPath(projectRoot: string, absolute: string): string;
  * survives generate → import → generate round-trip; only the wording inside each
  * block is tightened for maximum agent compliance.
  */
-declare const LESSONS_PROCEDURAL_RULE = "## Lessons (BLOCKING)\n\nGraph `.agentsmesh/lessons/lessons.json` is canonical; never hand-edit it. Manual: `lessons` skill.\n\n**Recall:** before every file edit or state-changing command, MUST run `agentsmesh lessons query --file <path> --cmd <command>` and obey matches; at task start, ALSO run `agentsmesh lessons query --keyword \"<task terms>\" --always` for conceptual + universal rules no path/command names. Pure-read commands and recall itself are exempt.\n\n**Capture:** after any failure, user correction, regression, wrong assumption, useful surprise, repeated friction, or non-obvious fix, MUST self-critique and run `agentsmesh lessons add \"<imperative rule>\" --topic <id> --trigger-file <glob> --evidence <sha|lesson-id>`.\n\n**Before final:** report `Lesson: captured <id>` or `Lesson: none`. No recall/capture gate = task incomplete. No shell: use `lessons_query` / `lessons_add`.";
+declare const LESSONS_PROCEDURAL_RULE = "## Lessons (BLOCKING)\n\nGraph `.agentsmesh/lessons/lessons.json` is canonical; never hand-edit it. Manual: `lessons` skill.\n\n**Recall:** before every file edit or state-changing command, MUST run `agentsmesh lessons query --file <path> --cmd <command> --session auto` and obey matches; at task start, ALSO run `agentsmesh lessons query --keyword \"<task terms>\" --always --session auto` for conceptual + universal rules no path/command names. Pure-read commands and recall itself are exempt.\n\n**Capture:** after any failure, user correction, regression, wrong assumption, useful surprise, repeated friction, or non-obvious fix, MUST self-critique and run `agentsmesh lessons add \"<imperative rule>\" --topic <id> --trigger-file <glob> --evidence <sha|lesson-id>`.\n\n**Before final:** report `Lesson: captured <id>` or `Lesson: none`. No recall/capture gate = task incomplete. No shell: use `lessons_query` / `lessons_add`.";
 
 interface ScaffoldLessonsResult {
     readonly created: string[];

package/dist/lessons.d.ts

@@ -1,5 +1,5 @@
-import { o as RankedLesson, j as LessonsQuery, A as AddLessonInput, a as AddLessonOptions, b as AddLessonResult } from './init-CrZhoNTj.js';
-export { c as AddLessonTriggers, D as DEFAULT_RECALL_LIMIT, X as DEFAULT_RECALL_MAX_TOKENS, I as ImportLegacyOptions, d as ImportLegacyReport, Y as LESSONS_LOCK_FILENAME, L as LESSONS_PROCEDURAL_RULE, e as Lesson, f as LessonStatus, g as LessonsGraph, Z as LessonsGraphExistsError, h as LessonsGraphSchema, i as LessonsPaths, M as MatchedLesson, k as MergeLessonsOptions, l as MergeLessonsResult, m as MutateOptions, R as RankOptions, n as RankReason, S as ScaffoldLessonsResult, p as StripMarkersOptions, q as StripMarkersReport, T as Topic, r as Trigger, s as TriggerKind, U as UnknownTopicError, V as ValidationFinding, t as ValidationLevel, u as ValidationReport, v as acquireLessonsLock, w as addLesson, x as graphFilePath, y as importLegacyLessons, _ as lessonsLockPath, z as lessonsPaths, B as loadLessonsGraph, C as mergeLessons, E as mutateLessonsGraph, F as parseGraph, G as queryLessons, H as rankLessons, J as scaffoldLessons, K as serializeGraph, N as stripLegacyMarkers, O as stripMarkersInGraph, P as toRelPath, Q as tryLoadLessonsGraph, W as validateLessonsGraph } from './init-CrZhoNTj.js';
+import { o as RankedLesson, j as LessonsQuery, A as AddLessonInput, a as AddLessonOptions, b as AddLessonResult } from './init-ChDbKSJ0.js';
+export { c as AddLessonTriggers, D as DEFAULT_RECALL_LIMIT, X as DEFAULT_RECALL_MAX_TOKENS, I as ImportLegacyOptions, d as ImportLegacyReport, Y as LESSONS_LOCK_FILENAME, L as LESSONS_PROCEDURAL_RULE, e as Lesson, f as LessonStatus, g as LessonsGraph, Z as LessonsGraphExistsError, h as LessonsGraphSchema, i as LessonsPaths, M as MatchedLesson, k as MergeLessonsOptions, l as MergeLessonsResult, m as MutateOptions, R as RankOptions, n as RankReason, S as ScaffoldLessonsResult, p as StripMarkersOptions, q as StripMarkersReport, T as Topic, r as Trigger, s as TriggerKind, U as UnknownTopicError, V as ValidationFinding, t as ValidationLevel, u as ValidationReport, v as acquireLessonsLock, w as addLesson, x as graphFilePath, y as importLegacyLessons, _ as lessonsLockPath, z as lessonsPaths, B as loadLessonsGraph, C as mergeLessons, E as mutateLessonsGraph, F as parseGraph, G as queryLessons, H as rankLessons, J as scaffoldLessons, K as serializeGraph, N as stripLegacyMarkers, O as stripMarkersInGraph, P as toRelPath, Q as tryLoadLessonsGraph, W as validateLessonsGraph } from './init-ChDbKSJ0.js';
 import 'zod';
 
 /**
@@ -34,6 +34,14 @@ interface RecallOptions {
     readonly sessionId?: string;
     /** Force dedup off even when a session correlator is present. */
     readonly noDedup?: boolean;
+    /**
+     * Expire suppressions this long after delivery. Set by callers that have NO
+     * context-reset signal (the MCP server never sees the client compact), so a
+     * lesson dropped from a summarized context cannot stay hidden forever. The
+     * hook path leaves this unset on purpose: it resets on SessionStart
+     * compact/clear, which is the exact signal a wall-clock TTL only approximates.
+     */
+    readonly ttlMs?: number;
 }
 interface RecallResult {
     /** Relevance-ranked, capped lessons (compact metadata lives on each entry). */