@aiwayds/dsh-topics-memory 0.23.0 → 0.24.0

package/lib/config.d.ts

@@ -118,6 +118,13 @@ export declare const TopicsConfig: z<Schemastery.ObjectS<NoInfer<{
      *  behavior change anywhere (byte-for-byte legacy); shadow = compute +
      *  bypass-ledger only, nothing lands in context; on = engage. */
     packageMode: z<string, string, "volatile-defined">;
+    /** Lesson injection gate (B2, spec §7 C1 MJ-4): off | shadow | on, default
+     *  off. off = established lessons neither inject nor shadow (zero injection-
+     *  side behavior); shadow = the lesson priority seat double-computes into
+     *  the bypass ledger (meta/lesson-shadow.jsonl), never lands in context;
+     *  on = established lessons inject. Only the injection side lives here —
+     *  the lesson loop (distill/approval) is the new repo's improveLoop gate. */
+    lessonInject: z<string, string, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     /** GitHub repo `owner/name`; empty = local-only mode (ADR 0008). */
     repo: z<string, string, "volatile-defined">;
@@ -231,6 +238,13 @@ export declare const TopicsConfig: z<Schemastery.ObjectS<NoInfer<{
      *  behavior change anywhere (byte-for-byte legacy); shadow = compute +
      *  bypass-ledger only, nothing lands in context; on = engage. */
     packageMode: z<string, string, "volatile-defined">;
+    /** Lesson injection gate (B2, spec §7 C1 MJ-4): off | shadow | on, default
+     *  off. off = established lessons neither inject nor shadow (zero injection-
+     *  side behavior); shadow = the lesson priority seat double-computes into
+     *  the bypass ledger (meta/lesson-shadow.jsonl), never lands in context;
+     *  on = established lessons inject. Only the injection side lives here —
+     *  the lesson loop (distill/approval) is the new repo's improveLoop gate. */
+    lessonInject: z<string, string, "volatile-defined">;
 }>>, "plain">;
 export type TopicsConfigValue = {
     repo: string;
@@ -281,8 +295,11 @@ export type TopicsConfigValue = {
     embeddingProvider?: string;
     embeddingModel?: string;
     packageMode?: 'off' | 'shadow' | 'on';
+    /** Lesson injection gate (B2). Optional in this TS view only (sentinel
+     *  pattern as above) — consumers treat undefined as 'off'. */
+    lessonInject?: 'off' | 'shadow' | 'on';
 };
-export declare const CONFIG_KEYS: readonly ["repo", "autoInject", "injectDedup", "suppressEcho", "topK", "perTopicBudget", "totalBudget", "matchThreshold", "tagBoost", "injectMode", "qualityLane", "graphDepth", "recencyWindowDays", "autoObserve", "includeSubagents", "observationMaxChars", "distillEveryTurns", "distillOnSessionEnd", "distillProvider", "distillModel", "distillBatchSize", "distillMaxModelCalls", "consolidateCadence", "deprecatedTtlDays", "usageBoost", "zeroOpenDecay", "pushDebounceSeconds", "jevEnabled", "jevBackend", "jevModel", "jevTimeoutMs", "jevSecretFile", "jevLayaFallback", "jevLayaUrl", "embeddingProvider", "embeddingModel", "packageMode"];
+export declare const CONFIG_KEYS: readonly ["repo", "autoInject", "injectDedup", "suppressEcho", "topK", "perTopicBudget", "totalBudget", "matchThreshold", "tagBoost", "injectMode", "qualityLane", "graphDepth", "recencyWindowDays", "autoObserve", "includeSubagents", "observationMaxChars", "distillEveryTurns", "distillOnSessionEnd", "distillProvider", "distillModel", "distillBatchSize", "distillMaxModelCalls", "consolidateCadence", "deprecatedTtlDays", "usageBoost", "zeroOpenDecay", "pushDebounceSeconds", "jevEnabled", "jevBackend", "jevModel", "jevTimeoutMs", "jevSecretFile", "jevLayaFallback", "jevLayaUrl", "embeddingProvider", "embeddingModel", "packageMode", "lessonInject"];
 export type ConfigKey = (typeof CONFIG_KEYS)[number];
 /** CamelCase → dash-display (topK → top-k) for command output. */
 export declare function displayKey(key: string): string;

package/lib/config.js

@@ -118,6 +118,13 @@ export const TopicsConfig = z.object({
      *  behavior change anywhere (byte-for-byte legacy); shadow = compute +
      *  bypass-ledger only, nothing lands in context; on = engage. */
     packageMode: z.string().default('off').volatile(),
+    /** Lesson injection gate (B2, spec §7 C1 MJ-4): off | shadow | on, default
+     *  off. off = established lessons neither inject nor shadow (zero injection-
+     *  side behavior); shadow = the lesson priority seat double-computes into
+     *  the bypass ledger (meta/lesson-shadow.jsonl), never lands in context;
+     *  on = established lessons inject. Only the injection side lives here —
+     *  the lesson loop (distill/approval) is the new repo's improveLoop gate. */
+    lessonInject: z.string().default('off').volatile(),
 });
 export const CONFIG_KEYS = [
     'repo',
@@ -157,6 +164,7 @@ export const CONFIG_KEYS = [
     'embeddingProvider',
     'embeddingModel',
     'packageMode',
+    'lessonInject',
 ];
 /** CamelCase → dash-display (topK → top-k) for command output. */
 export function displayKey(key) {
@@ -247,6 +255,11 @@ export function parseConfigValue(key, raw) {
                 return raw;
             return { error: 'package-mode 取值 off|shadow|on' };
         }
+        case 'lessonInject': {
+            if (raw === 'off' || raw === 'shadow' || raw === 'on')
+                return raw;
+            return { error: 'lesson-inject 取值 off|shadow|on' };
+        }
         case 'jevLayaFallback': {
             if (raw === 'on' || raw === 'true')
                 return true;

package/lib/digest.d.ts

@@ -45,6 +45,8 @@ export interface AssembleResult {
     }[];
     /** Slow-lane pointers that entered the context (v4 §4.2). */
     slowIncluded?: string[];
+    /** Established lessons that entered the context (B2, spec 卷一 §6.3). */
+    lessonIncluded?: string[];
 }
 export interface AssembleConfig {
     perTopicBudget: number;
@@ -58,6 +60,27 @@ export interface SlowPointerInput {
     description?: string;
     why: string;
 }
+/**
+ * One established-lesson pointer (B2, spec 卷一 §6.3): flat-mode normal-entry
+ * rendering with the machine-recognizable source marker (MJ-C combination
+ * matrix — lessonInject=on without the A3 package injects lessons as plain
+ * entries, tagged `lesson source:<kind>`).
+ */
+export interface LessonPointerInput {
+    slug: string;
+    title: string;
+    status: string;
+    description?: string;
+    score: number;
+    source: string;
+}
+/** The `(lesson source:x)` marker on lesson entries — flat AND package form. */
+export declare function lessonSourceTag(source: string): string;
+/** One flat lesson entry: same two-line pointer shape + the source marker. */
+export declare function lessonEntryText(input: LessonPointerInput, budgetTokens: number): {
+    text: string;
+    usedTokens: number;
+};
 /**
  * One slow-lane pointer: same shape as a fast pointer plus the mandatory why
  * line (v4 §4.2 — 每条带 why 行). No score: the gate here was the LLM rerank,
@@ -69,14 +92,15 @@ export declare function slowEntryText(input: SlowPointerInput, budgetTokens: num
 };
 /**
  * Greedily pack pointer entries (hits already score-ordered) under the total
- * budget. Zero hits → empty text (ADR 0006: 零命中零注入).
+ * budget. Zero hits → empty text (ADR 0006: 零命中零注入). `lessons` (B2)
+ * packs after the slow pointers as flat entries with the source marker.
  */
-export declare function assemblePointer(entries: readonly DigestInput[], cfg: AssembleConfig, slow?: readonly SlowPointerInput[]): AssembleResult;
+export declare function assemblePointer(entries: readonly DigestInput[], cfg: AssembleConfig, slow?: readonly SlowPointerInput[], lessons?: readonly LessonPointerInput[]): AssembleResult;
 /**
- * Greedily pack per-topic digests (hits already score-ordered) under the
- * total budget. Zero hits → empty text (ADR 0006: 零命中零注入).
+ * Greedily pack per-topic digests (hits already score-ordered) under the total
+ * budget. Zero hits → empty text (ADR 0006: 零命中零注入). `lessons` (B2).
  */
-export declare function assembleInjection(entries: readonly DigestInput[], cfg: AssembleConfig, slow?: readonly SlowPointerInput[]): AssembleResult;
+export declare function assembleInjection(entries: readonly DigestInput[], cfg: AssembleConfig, slow?: readonly SlowPointerInput[], lessons?: readonly LessonPointerInput[]): AssembleResult;
 /** One retrieval-side candidate, roster metadata pre-extracted by the caller. */
 export interface PackageCandidate {
     slug: string;
@@ -90,6 +114,15 @@ export interface PackageCandidate {
     reasons: string[];
     /** Edge/lane provenance: `depends:dN` | `slow-pick` | `semantic…` | raw. */
     via?: string;
+    /**
+     * Lesson priority seat (B2, spec 卷一 §6.3): sorts FIRST in the direct
+     * layer and is exempt from the ≤2 direct-seat cap (still budget-bound) —
+     * 「主层 ≤2 席中命中 lesson 至少 1 席」. Absent on every topic candidate.
+     */
+    prioritySeat?: boolean;
+    /** Rendered as a `(${sourceTag})` suffix on the entry head — lesson source
+     *  marker (`lesson source:correction`), MJ-C. */
+    sourceTag?: string;
 }
 export interface PackageInput {
     query: string;

package/lib/digest.js

@@ -93,6 +93,20 @@ export function pointerEntry(input, budgetTokens) {
     const text = lines.join('\n');
     return { text, usedTokens: estimateTokens(text) };
 }
+/** The `(lesson source:x)` marker on lesson entries — flat AND package form. */
+export function lessonSourceTag(source) {
+    return `lesson source:${source}`;
+}
+/** One flat lesson entry: same two-line pointer shape + the source marker. */
+export function lessonEntryText(input, budgetTokens) {
+    const lines = [];
+    lines.push(`### ${input.title} [${input.status}] (topics:${input.slug} score:${input.score.toFixed(2)}) (${lessonSourceTag(input.source)})`);
+    const one = (input.description ?? '').replace(/\s+/g, ' ').trim();
+    if (one !== '')
+        lines.push(truncateToTokens(one, Math.max(16, budgetTokens - 32)).text);
+    const text = lines.join('\n');
+    return { text, usedTokens: estimateTokens(text) };
+}
 /**
  * One slow-lane pointer: same shape as a fast pointer plus the mandatory why
  * line (v4 §4.2 — 每条带 why 行). No score: the gate here was the LLM rerank,
@@ -116,16 +130,18 @@ function wrapBlocks(blocks) {
 }
 /**
  * Shared greedy packing: fast entries first (score-ordered), then optional
- * slow-lane pointers, all under one total budget (v4 B2: shared 600 — the
- * slow lane spends whatever the fast lane leaves; 分账终值 is a P3 question).
+ * slow-lane pointers, then optional lesson entries (B2: flat-mode normal
+ * entry slots), all under one total budget (v4 B2: shared 600 — the slow lane
+ * spends whatever the fast lane leaves; 分账终值 is a P3 question).
  * Zero blocks → empty text (ADR 0006: 零命中零注入).
  */
-function packInjection(entries, cfg, render, slow) {
-    if (entries.length === 0 && (slow === undefined || slow.length === 0)) {
+function packInjection(entries, cfg, render, slow, lessons) {
+    if (entries.length === 0 && (slow === undefined || slow.length === 0) && (lessons === undefined || lessons.length === 0)) {
         return { text: '', usedTokens: 0, included: [], dropped: [] };
     }
     const included = [];
     const slowIncluded = [];
+    const lessonIncluded = [];
     const dropped = [];
     const blocks = [];
     let used = estimateTokens(`${WRAPPER_OPEN}\n${WRAPPER_INTRO}\n\n${WRAPPER_CLOSE}`);
@@ -159,27 +175,47 @@ function packInjection(entries, cfg, render, slow) {
         slowIncluded.push(item.slug);
         used += block.usedTokens;
     }
+    for (const item of lessons ?? []) {
+        const budget = Math.min(cfg.perTopicBudget, cfg.totalBudget - used);
+        if (budget < 24) {
+            dropped.push({ slug: item.slug, reason: 'lesson-budget' });
+            continue;
+        }
+        const block = lessonEntryText(item, budget);
+        if (used + block.usedTokens > cfg.totalBudget) {
+            dropped.push({ slug: item.slug, reason: 'lesson-budget' });
+            continue;
+        }
+        blocks.push(block.text);
+        lessonIncluded.push(item.slug);
+        used += block.usedTokens;
+    }
     if (blocks.length === 0)
         return { text: '', usedTokens: 0, included: [], dropped };
     const text = wrapBlocks(blocks);
     const result = { text, usedTokens: estimateTokens(text), included, dropped };
     if (slowIncluded.length > 0)
         result.slowIncluded = slowIncluded;
+    if (lessonIncluded.length > 0) {
+        result.lessonIncluded = lessonIncluded;
+        result.included = [...included, ...lessonIncluded];
+    }
     return result;
 }
 /**
  * Greedily pack pointer entries (hits already score-ordered) under the total
- * budget. Zero hits → empty text (ADR 0006: 零命中零注入).
+ * budget. Zero hits → empty text (ADR 0006: 零命中零注入). `lessons` (B2)
+ * packs after the slow pointers as flat entries with the source marker.
  */
-export function assemblePointer(entries, cfg, slow) {
-    return packInjection(entries, cfg, pointerEntry, slow);
+export function assemblePointer(entries, cfg, slow, lessons) {
+    return packInjection(entries, cfg, pointerEntry, slow, lessons);
 }
 /**
- * Greedily pack per-topic digests (hits already score-ordered) under the
- * total budget. Zero hits → empty text (ADR 0006: 零命中零注入).
+ * Greedily pack per-topic digests (hits already score-ordered) under the total
+ * budget. Zero hits → empty text (ADR 0006: 零命中零注入). `lessons` (B2).
  */
-export function assembleInjection(entries, cfg, slow) {
-    return packInjection(entries, cfg, topicDigest, slow);
+export function assembleInjection(entries, cfg, slow, lessons) {
+    return packInjection(entries, cfg, topicDigest, slow, lessons);
 }
 /** Total package cap — pinned, does not float with hit strength (A3 决议 3). */
 export const PACKAGE_TOTAL = 600;
@@ -302,11 +338,15 @@ function isTrivialQuery(query, queryTokens) {
     const stripped = query.replace(/\s+/g, '');
     return stripped.length > 0 && stripped.length <= PACKAGE_TRIVIAL_QUERY_CHARS;
 }
-/** Stable within-layer order: score desc, then usage, then input order. */
+/** Stable within-layer order: prioritySeat first (lesson 优先席), then score
+ *  desc, then usage, then input order. */
 function rankStable(list, usage) {
     return list
         .map((c, i) => ({ c, i, u: usage?.get(c.slug) ?? 0 }))
-        .sort((a, b) => b.c.score - a.c.score || b.u - a.u || a.i - b.i)
+        .sort((a, b) => (b.c.prioritySeat === true ? 1 : 0) - (a.c.prioritySeat === true ? 1 : 0) ||
+        b.c.score - a.c.score ||
+        b.u - a.u ||
+        a.i - b.i)
         .map((x) => x.c);
 }
 /** Machine-assembled why line (A3 决议 2): hit channel + edge source + score. */
@@ -359,7 +399,7 @@ function packageWhyLine(c, queryTokens) {
  * 不再重复预告）。实质行是弹性段，超预算先截它（spec §2.4）。
  */
 function directEntryText(c, queryTokens, budget) {
-    const head = `### ${c.title} [${c.status}]`;
+    const head = `### ${c.title} [${c.status}]${c.sourceTag !== undefined && c.sourceTag !== '' ? ` (${c.sourceTag})` : ''}`;
     const why = packageWhyLine(c, queryTokens);
     const warn = c.reasons.includes('conflicted-demoted') ? '⚠ 此条存在未合并冲突，结论可能过期。' : null;
     const openBase = `细节: topic_open "${c.slug}"`;
@@ -478,7 +518,9 @@ export function assemblePackage(input, opts) {
     const layers = { direct: [], neighborhood: [], weak: [] };
     const directBlocks = [];
     for (const c of direct) {
-        if (directBlocks.length >= PACKAGE_DIRECT_MAX && !isEntityAnchored(input.queryTokens, c)) {
+        // prioritySeat (lesson 优先席) is exempt from the direct-seat cap — the
+        // budget is the only thing that can still cut it.
+        if (directBlocks.length >= PACKAGE_DIRECT_MAX && !isEntityAnchored(input.queryTokens, c) && c.prioritySeat !== true) {
             dropped.push({ slug: c.slug, reason: 'direct-cap' });
             continue;
         }

package/lib/ilog.d.ts

@@ -85,6 +85,20 @@ export interface InjectionRecord {
      * Written once with the record, never backfilled (ilog append-only).
      */
     slowOutcome?: SlowOutcome;
+    /**
+     * Lesson gate fields (B2, spec 卷一 §6.3/§7) — present only on rounds where
+     * lessonInject is shadow|on AND at least one established lesson matched the
+     * query. `lessons` is the trigger-channel match list with whether the entry
+     * entered the context; shadow rounds always carry included:false there (the
+     * double-compute lands in meta/lesson-shadow.jsonl instead).
+     */
+    lessonInject?: 'shadow' | 'on';
+    lessons?: {
+        slug: string;
+        score: number;
+        source: string;
+        included: boolean;
+    }[];
 }
 /**
  * One topic_open event (pointer-open log, v4 §4.3). Everything beyond

package/lib/index.d.ts

@@ -124,6 +124,7 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
     embeddingProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
     embeddingModel: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
     packageMode: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    lessonInject: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     repo: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
     autoInject: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
@@ -162,6 +163,7 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
     embeddingProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
     embeddingModel: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
     packageMode: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    lessonInject: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
 }>>, "plain">;
 /** Live config reference as a 0.1.7 host passes it (cron / mcp-adapter
  * spelling): `.get()` snapshots the current value — the host swaps the
@@ -174,6 +176,13 @@ interface VolatileRef<T> {
 export type TopicsRuntimeConfig = Partial<{
     [K in keyof TopicsConfigValue]: VolatileRef<TopicsConfigValue[K]> | TopicsConfigValue[K];
 }>;
+/**
+ * B-line dual-write seam contract (卷二 §6.2) — shared types are exported by
+ * THIS repo (C1 决议 3: no shared lib until a third consumer appears). The
+ * new repo calls TopicsService.feedObservations / setLessonStatus through the
+ * host process; direct bundle writes are forbidden on its side.
+ */
+export type { StructuredObservation, FeedResult, StoreResult } from './service.ts';
 /**
  * Strip a leading YAML frontmatter block (`---` / body / `---`) from a skill
  * markdown file. `SkillDefinition.content` must be the instruction body after
@@ -186,4 +195,3 @@ export type TopicsRuntimeConfig = Partial<{
  */
 export declare function stripFrontmatter(raw: string): string;
 export declare function apply(ctx: Context, config?: TopicsRuntimeConfig): Promise<void>;
-export {};

package/lib/index.js

@@ -1035,6 +1035,7 @@ const DEFAULTS = {
     embeddingProvider: '',
     embeddingModel: '',
     packageMode: 'off',
+    lessonInject: 'off',
     usageBoost: 0.15,
     pushDebounceSeconds: 45,
 };

package/lib/okf.d.ts

@@ -13,6 +13,32 @@
  * @module okf
  */
 export type TopicStatus = 'draft' | 'stable' | 'deprecated';
+/**
+ * Bundle entry kinds (B2, spec 2026-10-self-improve-topics §6.1): `topic` =
+ * factual knowledge (「是什么」), `lesson` = behavioral lesson (「怎么做事」).
+ * The kind rides the OKF `type` frontmatter field — the canonical serialized
+ * value for a lesson is `Lesson` (matching the `Topic` capitalization
+ * convention); recognition is case-insensitive so bundles written by the
+ * new repo's loop parse regardless of casing drift.
+ */
+export type TopicKind = 'topic' | 'lesson';
+/** lesson scope (B2 MJ-2, spec §6.2): workspace lessons inject only in the
+ *  workspace that produced them (cwd-hash match); global need no filter. */
+export type LessonScope = 'workspace' | 'global';
+/** lesson confidence (B2, spec §6.2): the FACT source — `status` derives from
+ *  it (hint↔draft, established↔stable); hint never injects (MJ-3). */
+export type LessonConfidence = 'hint' | 'established';
+/** lesson provenance (B2 BL-2, spec §6.2): machine-recognizable source tag;
+ *  uninstall reclamation keys on source≠manual (卷二 §9). */
+export type LessonSource = 'distilled' | 'correction' | 'manual';
+/** kind from the raw `type` frontmatter value (case-insensitive `lesson`). */
+export declare function topicKindOf(type: string): TopicKind;
+/** The canonical serialized `type` value per kind. */
+export declare function kindTypeValue(kind: TopicKind): string;
+/** confidence 为事实源（B2 Minor）：hint↔draft、established↔stable.
+ *  `deprecated` is a lifecycle endpoint OUTSIDE the confidence axis — callers
+ *  set it directly (setLessonStatus / consolidation / TTL sweep). */
+export declare function deriveLessonStatus(confidence: LessonConfidence): TopicStatus;
 export interface SourceEntry {
     id?: string;
     resource: string;
@@ -46,6 +72,14 @@ export interface TopicFrontmatter {
     verified?: TrustStamp;
     stale_after?: string;
     sources?: SourceEntry[];
+    /** lesson 必带 scope（默认 workspace；global 需显式）。 */
+    scope?: LessonScope;
+    /** confidence 事实源；status 派生（deriveLessonStatus）。默认 hint。 */
+    confidence?: LessonConfidence;
+    /** provenance 标记（卸载回收按 source≠manual）。默认 manual。 */
+    source?: LessonSource;
+    /** 写入时的 workspace 标识（cwd hash，MJ-2）；scope=global 时可空。 */
+    workspaceId?: string;
     /** Producer-defined extras — preserved on round-trip per OKF §4.1. */
     [extra: string]: unknown;
 }

package/lib/okf.js

@@ -13,6 +13,20 @@
  * @module okf
  */
 import { parseYaml, stringifyYaml, YamlError } from "./yaml.js";
+/** kind from the raw `type` frontmatter value (case-insensitive `lesson`). */
+export function topicKindOf(type) {
+    return typeof type === 'string' && type.trim().toLowerCase() === 'lesson' ? 'lesson' : 'topic';
+}
+/** The canonical serialized `type` value per kind. */
+export function kindTypeValue(kind) {
+    return kind === 'lesson' ? 'Lesson' : 'Topic';
+}
+/** confidence 为事实源（B2 Minor）：hint↔draft、established↔stable.
+ *  `deprecated` is a lifecycle endpoint OUTSIDE the confidence axis — callers
+ *  set it directly (setLessonStatus / consolidation / TTL sweep). */
+export function deriveLessonStatus(confidence) {
+    return confidence === 'established' ? 'stable' : 'draft';
+}
 export class OkfError extends Error {
     name = 'OkfError';
 }
@@ -106,8 +120,26 @@ export function parseTopicDoc(raw) {
             return s;
         });
     }
+    // ---- lesson-kind fields (B2, spec §6.2) — parsed on lesson docs only ----
+    // Invalid enum values DEGRADE TO THE DEFAULT (triggers precedent: a producer
+    // slip must never invalidate an otherwise sound doc); the seam writers own
+    // the closed vocabulary. On lesson docs these four keys join the known set
+    // so the extras loop cannot double-store a raw unvalidated value.
+    if (topicKindOf(fmRaw.type) === 'lesson') {
+        fm.scope = fmRaw.scope === 'global' ? 'global' : 'workspace';
+        fm.confidence = fmRaw.confidence === 'established' ? 'established' : 'hint';
+        fm.source = fmRaw.source === 'distilled' || fmRaw.source === 'correction' ? fmRaw.source : 'manual';
+        if (typeof fmRaw.workspaceId === 'string' && fmRaw.workspaceId !== '')
+            fm.workspaceId = fmRaw.workspaceId;
+    }
     // Preserve unknown producer-defined keys verbatim (OKF §4.1 extensions).
     const known = new Set(['type', 'title', 'description', 'tags', 'triggers', 'depends', 'open_questions', 'impact', 'status', 'generated', 'verified', 'stale_after', 'sources']);
+    if (fm.scope !== undefined || fm.confidence !== undefined || fm.source !== undefined) {
+        known.add('scope');
+        known.add('confidence');
+        known.add('source');
+        known.add('workspaceId');
+    }
     for (const [k, v] of Object.entries(fmRaw)) {
         if (!known.has(k))
             fm[k] = v;
@@ -137,6 +169,15 @@ export function serializeTopicDoc(doc) {
         out.stale_after = fm.stale_after;
     if (fm.sources !== undefined && fm.sources.length > 0)
         out.sources = fm.sources;
+    // lesson fields serialize in a fixed slot (deterministic order, spec §6.2).
+    if (fm.scope !== undefined)
+        out.scope = fm.scope;
+    if (fm.confidence !== undefined)
+        out.confidence = fm.confidence;
+    if (fm.source !== undefined)
+        out.source = fm.source;
+    if (fm.workspaceId !== undefined)
+        out.workspaceId = fm.workspaceId;
     for (const [k, v] of Object.entries(fm)) {
         if (!(k in out))
             out[k] = v;

package/lib/paths.d.ts

@@ -45,4 +45,13 @@ export declare function conflictsFile(root: string): string;
 export declare function hostId(): string;
 /** The actor string stamped into `generated.by` for machine-written topics. */
 export declare function actorFor(): string;
+/**
+ * Current workspace identifier for lesson scope filtering (B2 MJ-2, spec
+ * 卷一 §6.2): the sha256 prefix of the process cwd, overridable via
+ * $DSH_TOPICS_WORKSPACE_ID (tests / multi-root hosts; the override also lets
+ * a host pin one identity across chdirs). 拍板（spec 未钉死来源）: cwd hash at
+ * read time is the minimal viable source — the same derivation the lesson
+ * write path stamps into frontmatter.workspaceId, so no config plumbing.
+ */
+export declare function currentWorkspaceId(): string;
 export {};

package/lib/paths.js

@@ -12,6 +12,7 @@
  * @module paths
  */
 import { existsSync, renameSync } from 'node:fs';
+import { createHash } from 'node:crypto';
 import { homedir } from 'node:os';
 import { hostname as osHostname } from 'node:os';
 import { join } from 'node:path';
@@ -82,3 +83,17 @@ export function hostId() {
 export function actorFor() {
     return `agent:dsh-topics-memory@${hostId()}`;
 }
+/**
+ * Current workspace identifier for lesson scope filtering (B2 MJ-2, spec
+ * 卷一 §6.2): the sha256 prefix of the process cwd, overridable via
+ * $DSH_TOPICS_WORKSPACE_ID (tests / multi-root hosts; the override also lets
+ * a host pin one identity across chdirs). 拍板（spec 未钉死来源）: cwd hash at
+ * read time is the minimal viable source — the same derivation the lesson
+ * write path stamps into frontmatter.workspaceId, so no config plumbing.
+ */
+export function currentWorkspaceId() {
+    const env = process.env.DSH_TOPICS_WORKSPACE_ID?.trim();
+    if (env !== undefined && env !== '')
+        return env;
+    return createHash('sha256').update(process.cwd()).digest('hex').slice(0, 16);
+}

package/lib/pipeline-events.d.ts

@@ -15,8 +15,10 @@
  */
 /** Closed vocabulary, spec §8.1 + W-C wave start set. `slow-lane-outcome` is
  *  the slow lane's per-run disposition row (quality.ts); the distill/link
- *  kinds are the A2/A6 producers' contract — they import this module. */
-export type PipelineEventKind = 'slow-lane-outcome' | 'distill-op-invalid' | 'distill-op-retry-exhausted' | 'link-ref-rejected';
+ *  kinds are the A2/A6 producers' contract — they import this module. The
+ *  two `seam-*` kinds are the B-line dual-write audit trail (卷二 §6.2:
+ *  caller-identity audit — opts.actor — rides every seam call). */
+export type PipelineEventKind = 'slow-lane-outcome' | 'distill-op-invalid' | 'distill-op-retry-exhausted' | 'link-ref-rejected' | 'seam-observations-fed' | 'seam-lesson-status';
 /** File NAME inside the bundle's meta dir (path via pipelineEventsFile). */
 export declare const PIPELINE_EVENTS_FILE = "pipeline-events.jsonl";
 export interface PipelineEvent {

package/lib/pipeline-events.js

@@ -31,6 +31,8 @@ const KNOWN_KINDS = new Set([
     'distill-op-invalid',
     'distill-op-retry-exhausted',
     'link-ref-rejected',
+    'seam-observations-fed',
+    'seam-lesson-status',
 ]);
 export function pipelineEventsFile(bundleDir) {
     return join(metaDir(bundleDir), PIPELINE_EVENTS_FILE);