@aiwayds/dsh-topics-memory 0.23.0 → 0.24.0

package/lib/store.js

@@ -8,7 +8,7 @@
  *
  * @module store
  */
-import { readdir, readFile, writeFile, rename, mkdir, appendFile, access, rm, } from 'node:fs/promises';
+import { readdir, readFile, writeFile, rename, mkdir, appendFile, access, rm, copyFile, } from 'node:fs/promises';
 import { readFileSync } from 'node:fs';
 import { constants as FsConstants } from 'node:fs';
 import { dirname, join } from 'node:path';
@@ -16,6 +16,7 @@ import { randomUUID } from 'node:crypto';
 import * as okf from "./okf.js";
 import * as gitmod from "./git.js";
 import { actorFor } from "./paths.js";
+export const topicKindOf = okf.topicKindOf;
 export class StoreError extends Error {
     name = 'StoreError';
 }
@@ -352,6 +353,30 @@ export class BundleStore {
             return true;
         });
     }
+    /**
+     * Lesson removal seam (B2/卷二 §6.2 MJ-B, spec 红线④): archive BEFORE the
+     * roster removal — the file is copied byte-exact to `archive/lessons/`
+     * inside the bundle and only then deleted from `topics/`, both landing in
+     * ONE git commit so `git revert` restores the lesson exactly (自动写资产
+     * 必须可回滚). Returns undefined when the slug doesn't exist (idempotent).
+     */
+    async archiveLesson(slug, opts) {
+        return this.enqueue(async () => {
+            const clean = okf.slugify(slug);
+            const file = this.topicPath(clean);
+            if (!(await existsSync(file)))
+                return undefined;
+            const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const archivedTo = `archive/lessons/${clean}-${stamp}.md`;
+            const absTo = join(this.root, archivedTo);
+            await mkdir(dirname(absTo), { recursive: true });
+            await copyFile(file, absTo);
+            await rm(file);
+            await this.regenerateIndex();
+            const committed = await this.commit([archivedTo, `topics/${clean}.md`, 'index.md'], opts.message);
+            return { archivedTo, committed };
+        });
+    }
     async regenerateIndex() {
         const metas = await this.listTopics();
         const entries = metas.map((m) => ({
@@ -431,6 +456,8 @@ export class BundleStore {
         };
         if (input.sessionId !== undefined)
             obs.sessionId = input.sessionId;
+        if (input.by !== undefined)
+            obs.by = input.by;
         // Behind the store-wide queue: markDistilled / recordUnconsumed rewrite
         // the whole JSONL file — an unsynchronized append here could interleave
         // with a rewrite and lose either the new observation or the rewrite.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-topics-memory",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "dsh-plugin: quality-first topic memory for dsh — a topic keeps the starting question, conclusion, impact and dependencies, not the process; local-first git-traced OKF bundle, budgeted LLM-free injection",
   "type": "module",
   "main": "lib/index.js",
@@ -42,7 +42,7 @@
     "build": "tsc -p tsconfig.json",
     "check": "tsc --noEmit -p tsconfig.json",
     "pretest": "tsc -p tsconfig.json",
-    "test": "node --test test/yaml.test.mjs test/okf.test.mjs test/retrieval.test.mjs test/digest.test.mjs test/digest-package.test.mjs test/ilog.test.mjs test/store.test.mjs test/paths.test.mjs test/git.test.mjs test/sync.test.mjs test/tools.test.mjs test/dedup.test.mjs test/commands.test.mjs test/onboard.test.mjs test/delegation.test.mjs test/observer.test.mjs test/distill.test.mjs test/consolidate.test.mjs test/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/quality.test.mjs test/replay-gate.test.mjs test/depends-repair.test.mjs test/skill.test.mjs test/fast-lane.test.mjs test/legacy-import.test.mjs test/jev-config.test.mjs test/jev-gate.test.mjs test/jev-client.test.mjs test/jev-log.test.mjs test/jev-dual.test.mjs test/jev-fastgate.test.mjs test/zero-open-decay.test.mjs test/embedding.test.mjs test/embedding-index.test.mjs test/query-sanitize.test.mjs test/semantic-rerank.test.mjs test/inject-config.test.mjs test/distill-links.test.mjs test/store-links.test.mjs",
+    "test": "node --test test/yaml.test.mjs test/okf.test.mjs test/retrieval.test.mjs test/digest.test.mjs test/digest-package.test.mjs test/ilog.test.mjs test/store.test.mjs test/paths.test.mjs test/git.test.mjs test/sync.test.mjs test/tools.test.mjs test/dedup.test.mjs test/commands.test.mjs test/onboard.test.mjs test/delegation.test.mjs test/observer.test.mjs test/distill.test.mjs test/consolidate.test.mjs test/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/quality.test.mjs test/replay-gate.test.mjs test/depends-repair.test.mjs test/skill.test.mjs test/fast-lane.test.mjs test/legacy-import.test.mjs test/jev-config.test.mjs test/jev-gate.test.mjs test/jev-client.test.mjs test/jev-log.test.mjs test/jev-dual.test.mjs test/jev-fastgate.test.mjs test/zero-open-decay.test.mjs test/embedding.test.mjs test/embedding-index.test.mjs test/query-sanitize.test.mjs test/semantic-rerank.test.mjs test/inject-config.test.mjs test/distill-links.test.mjs test/store-links.test.mjs test/lesson-seams.test.mjs",
     "smoke": "node scripts/smoke-boot.mjs"
   },
   "dependencies": {},

package/src/config.ts

@@ -120,6 +120,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 type TopicsConfigValue = {
@@ -171,6 +178,9 @@ 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 const CONFIG_KEYS = [
@@ -211,6 +221,7 @@ export const CONFIG_KEYS = [
   'embeddingProvider',
   'embeddingModel',
   'packageMode',
+  'lessonInject',
 ] as const
 
 export type ConfigKey = (typeof CONFIG_KEYS)[number]
@@ -295,6 +306,10 @@ export function parseConfigValue(key: ConfigKey, raw: string): boolean | number
       if (raw === 'off' || raw === 'shadow' || raw === 'on') 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
       if (raw === 'off' || raw === 'false') return false

package/src/digest.ts

@@ -110,6 +110,8 @@ export interface AssembleResult {
   dropped: { slug: string; reason: string }[]
   /** 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 {
@@ -126,6 +128,36 @@ export interface SlowPointerInput {
   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 function lessonSourceTag(source: string): string {
+  return `lesson source:${source}`
+}
+
+/** One flat lesson entry: same two-line pointer shape + the source marker. */
+export function lessonEntryText(input: LessonPointerInput, budgetTokens: number): { text: string; usedTokens: number } {
+  const lines: string[] = []
+  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,
@@ -153,8 +185,9 @@ function wrapBlocks(blocks: readonly string[]): string {
 
 /**
  * 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(
@@ -162,12 +195,14 @@ function packInjection(
   cfg: AssembleConfig,
   render: (entry: DigestInput, budget: number) => { text: string; usedTokens: number },
   slow?: readonly SlowPointerInput[],
+  lessons?: readonly LessonPointerInput[],
 ): AssembleResult {
-  if (entries.length === 0 && (slow === undefined || slow.length === 0)) {
+  if (entries.length === 0 && (slow === undefined || slow.length === 0) && (lessons === undefined || lessons.length === 0)) {
     return { text: '', usedTokens: 0, included: [], dropped: [] }
   }
   const included: string[] = []
   const slowIncluded: string[] = []
+  const lessonIncluded: string[] = []
   const dropped: { slug: string; reason: string }[] = []
   const blocks: string[] = []
   let used = estimateTokens(`${WRAPPER_OPEN}\n${WRAPPER_INTRO}\n\n${WRAPPER_CLOSE}`)
@@ -201,35 +236,57 @@ function packInjection(
     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: AssembleResult = { 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: readonly DigestInput[],
   cfg: AssembleConfig,
   slow?: readonly SlowPointerInput[],
+  lessons?: readonly LessonPointerInput[],
 ): AssembleResult {
-  return packInjection(entries, cfg, pointerEntry, slow)
+  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: readonly DigestInput[],
   cfg: AssembleConfig,
   slow?: readonly SlowPointerInput[],
+  lessons?: readonly LessonPointerInput[],
 ): AssembleResult {
-  return packInjection(entries, cfg, topicDigest, slow)
+  return packInjection(entries, cfg, topicDigest, slow, lessons)
 }
 
 // ---------------------------------------------------------------------------
@@ -253,6 +310,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 {
@@ -401,11 +467,16 @@ function isTrivialQuery(query: string, queryTokens: readonly string[]): boolean
   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: readonly PackageCandidate[], usage: Map<string, number> | undefined): PackageCandidate[] {
   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)
 }
 
@@ -452,7 +523,7 @@ function directEntryText(
   queryTokens: readonly string[],
   budget: number,
 ): { text: string; usedTokens: number } {
-  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}"`
@@ -568,7 +639,9 @@ export function assemblePackage(input: PackageInput, opts?: PackageOpts): Packag
   const layers: PackageResult['layers'] = { direct: [], neighborhood: [], weak: [] }
   const directBlocks: string[] = []
   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/src/ilog.ts

@@ -77,6 +77,15 @@ 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 }[]
 }
 
 /**

package/src/index.ts

@@ -259,6 +259,14 @@ interface VolatileRef<T> {
  * on bare test harnesses — {@link readConfigValue} accepts both. */
 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'
+
 /** Snapshot one config slot: live ref → current value, plain value → itself. */
 function readConfigValue(slot: unknown): unknown {
   const ref = slot as { get?: unknown } | undefined
@@ -1164,6 +1172,7 @@ const DEFAULTS: TopicsConfigValue = {
   embeddingProvider: '',
   embeddingModel: '',
   packageMode: 'off',
+  lessonInject: 'off',
   usageBoost: 0.15,
   pushDebounceSeconds: 45,
 }

package/src/okf.ts

@@ -17,6 +17,43 @@ import { parseYaml, stringifyYaml, YamlError } from './yaml.ts'
 
 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 function topicKindOf(type: string): TopicKind {
+  return typeof type === 'string' && type.trim().toLowerCase() === 'lesson' ? 'lesson' : 'topic'
+}
+
+/** The canonical serialized `type` value per kind. */
+export function kindTypeValue(kind: TopicKind): string {
+  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: LessonConfidence): TopicStatus {
+  return confidence === 'established' ? 'stable' : 'draft'
+}
+
 export interface SourceEntry {
   id?: string
   resource: string
@@ -52,6 +89,15 @@ export interface TopicFrontmatter {
   verified?: TrustStamp
   stale_after?: string
   sources?: SourceEntry[]
+  // ---- lesson-kind fields (B2, spec §6.2) — present on kind=lesson docs ----
+  /** 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
 }
@@ -148,8 +194,25 @@ export function parseTopicDoc(raw: string): TopicDoc {
       return s as SourceEntry
     })
   }
+  // ---- 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
   }
@@ -174,6 +237,11 @@ export function serializeTopicDoc(doc: TopicDoc): string {
   if (fm.verified !== undefined) out.verified = { by: fm.verified.by, at: fm.verified.at }
   if (fm.stale_after !== undefined) 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/src/paths.ts

@@ -13,6 +13,7 @@
  */
 
 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'
@@ -102,3 +103,17 @@ export function hostId(): string {
 export function actorFor(): string {
   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(): string {
+  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/src/pipeline-events.ts

@@ -21,8 +21,10 @@ import { metaDir } from './paths.ts'
 
 /** 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 const PIPELINE_EVENTS_FILE = 'pipeline-events.jsonl'
@@ -47,6 +49,8 @@ const KNOWN_KINDS: ReadonlySet<string> = new Set<string>([
   'distill-op-invalid',
   'distill-op-retry-exhausted',
   'link-ref-rejected',
+  'seam-observations-fed',
+  'seam-lesson-status',
 ])
 
 export function pipelineEventsFile(bundleDir: string): string {