@aiwayds/dsh-topics-memory 0.23.0 → 0.24.1

package/lib/service.d.ts

@@ -36,6 +36,40 @@ export interface SlowDelivery {
     /** Producing run's disposition (A4 全留痕) — copied into ilog.slowOutcome. */
     outcome?: SlowOutcome;
 }
+/**
+ * One structured observation from the new repo's signal layer (B1 §2.1
+ * whitelist): FEATURES ONLY, never conversation text (红线⑤). Unknown caller
+ * fields cannot pass — the whitelist copy in feedObservations is the gate.
+ */
+export interface StructuredObservation {
+    /** Signal type from the B1 closed list (`tool-error`, `turn-end-negative`,
+     *  `unused-injection`, `repeat-call`, `interruption-pair`, `jev-calibration`). */
+    type: string;
+    /** ISO instant; defaults to now. */
+    at?: string;
+    sessionId?: string;
+    /** Bounded scalar feature fields (toolName/errorName/count/band/...). */
+    detail?: Record<string, string | number | boolean>;
+}
+export interface FeedResult {
+    accepted: number;
+    duplicates: number;
+    rejected: number;
+    ids: string[];
+    /** Present when the call itself was refused (missing/blank actor). */
+    error?: 'unauthorized';
+}
+export interface StoreResult {
+    ok: boolean;
+    slug: string;
+    /** Refusal reason; absent on success. */
+    reason?: 'unauthorized' | 'not-found' | 'not-a-lesson' | 'invalid-state';
+    /** confidence before the transition (when the lesson was read). */
+    from?: okf.LessonConfidence;
+    /** removed only: bundle-relative archive path (git-revertable). */
+    archivedTo?: string;
+    committed?: boolean;
+}
 export declare class TopicsService {
     private cache;
     /** mtime-keyed parse of the observations log, grouped by session. */
@@ -109,8 +143,12 @@ export declare class TopicsService {
     private embeddingIndexCacheGet;
     /** Shadow bypass ledger (spec §8.3): one line per shadow round — feature
      *  fields only, never query text (jev-log discipline). Silent on failure;
-     *  512KB truncation keeps the newest three quarters. */
-    private appendPackageShadowLedger;
+     *  512KB truncation keeps the newest three quarters. Shared by the package
+     *  shadow (meta/package-shadow.jsonl) and the lesson shadow (B2,
+     *  meta/lesson-shadow.jsonl). */
+    private appendShadowLedger;
+    private packageShadowLedgerPath;
+    private lessonShadowLedgerPath;
     /** Boot-time embedding index maintenance (spec §3: boot 校验+增量重建).
      *  Provider '' or packageMode off → no-op (default-off byte-for-byte).
      *  Full-roster embed on rebuild (A1 §5: ~9.5s for 137 topics). */
@@ -154,6 +192,7 @@ export declare class TopicsService {
         echoed: string[];
         included: string[];
         slowIncluded: string[];
+        lessonIncluded: string[];
     };
     /**
      * topic_open tool path (v4 §4.1): full conclusion / open questions /
@@ -181,9 +220,25 @@ export declare class TopicsService {
     private attributeOpen;
     /** Sync roster read (same mtime cache as roster()). */
     rosterSync(): RetrievableTopic[];
+    /** Established, scope-passing lesson entries (B2, spec 卷一 §6.3) — sync,
+     *  sharing the roster's mtime cache. Injection reads ONLY established
+     *  lessons here (MJ-3: hint 仅供审批队列展示，永不注入); scope filter =
+     *  workspace lessons must carry the current workspace id (MJ-2); scope=global
+     *  and legacy entries without a workspaceId pass (fail-open — the filter's
+     *  default is permissive, the confidence gate is the hard one). */
+    lessonsSync(): (RetrievableTopic & {
+        confidence: okf.LessonConfidence;
+        source: okf.LessonSource;
+        scope: okf.LessonScope;
+        workspaceId?: string;
+    })[];
     private readDocSync;
     private readDoc;
-    /** topic_save tool path: create or update with actor stamping. */
+    /** topic_save tool path: create or update with actor stamping. `kind:
+     *  'lesson'` (B2 data plane) switches the OKF type to Lesson and stamps the
+     *  lesson frontmatter (scope/confidence/source/workspaceId) with the
+     *  confidence↔status derivation (hint↔draft, established↔stable —
+     *  confidence is the fact source). */
     saveTopic(input: {
         title: string;
         description?: string;
@@ -199,6 +254,12 @@ export declare class TopicsService {
         recommendations?: string;
         source?: 'model' | 'distill';
         slug?: string;
+        /** B2 lesson data plane: entry kind (default topic). */
+        kind?: okf.TopicKind;
+        scope?: okf.LessonScope;
+        confidence?: okf.LessonConfidence;
+        /** Lesson provenance (input.source above is the tool-path tag). */
+        lessonSource?: okf.LessonSource;
     }): Promise<SaveResult & {
         slug: string;
     }>;
@@ -208,6 +269,30 @@ export declare class TopicsService {
         sessionId?: string;
         source?: 'model' | 'auto';
     }): Promise<Observation>;
+    /**
+     * ① 观察投喂: structured observations (B1 §2.1 whitelist, FEATURES ONLY —
+     * 对话原文禁入, 红线⑤) appended to the observations stream with the `fed`
+     * provenance marker and `kind: 'signal'`; each line carries `by: actor`.
+     * The whitelist copy drops unknown caller fields, caps detail entries and
+     * string sizes, and renders a sorted feature line as the observation text.
+     * Duplicates (same type+session+detail in the recent tail) are counted, not
+     * appended (重复观察由原仓去重). Fail-soft: one malformed entry is counted
+     * as rejected, never sinks the batch.
+     */
+    feedObservations(obs: readonly StructuredObservation[], opts: {
+        actor: string;
+    }): Promise<FeedResult>;
+    /**
+     * ② lesson 状态变更 (B2/卷二 §6.2): hint→established / →deprecated /
+     * →removed. established flips confidence (the FACT source) and derives
+     * status (established↔stable); deprecated flips status only (the TTL sweep
+     * owns the rest); removed = archive FIRST (byte-exact copy to
+     * `archive/lessons/` inside the bundle, git-revertable — 红线④) then out of
+     * the roster, one commit. Each call lands a `seam-lesson-status` audit row.
+     */
+    setLessonStatus(slug: string, to: 'established' | 'deprecated' | 'removed', opts: {
+        actor: string;
+    }): Promise<StoreResult>;
     search(query: string, topK?: number): Promise<SearchOutcome>;
     history(slug: string, limit?: number): Promise<{
         entries: {