stratagate-dsh 0.3.2 → 0.3.4

package/dist/plugin.js

@@ -3727,6 +3727,123 @@ var SqliteStorage = class {
 
 // packages/core/src/topics.ts
 import { createHash, randomUUID } from "node:crypto";
+
+// packages/core/src/topic-diagnostics.ts
+var categories = [
+  "max-tokens",
+  "schema-invalid",
+  "validation-failed",
+  "timeout",
+  "provider-failed",
+  "worker-failed",
+  "source-changed"
+];
+var TOPIC_SAFE_REASONS = /* @__PURE__ */ new Set([
+  "A topic may be updated only once per projection.",
+  "Invalid duplicate chapter label conflicts with an existing topic.",
+  "Invalid duplicate chapter label in one projection.",
+  "Invalid duplicate chapter label matches an unexposed existing topic.",
+  "Invalid or duplicate topic section title.",
+  "Invalid section backfill: explicit sections must cover the existing chapter.",
+  "Invalid topic membership source events.",
+  "Invalid topic overview section.",
+  "Invalid topic overview source events.",
+  "Invalid topic overview title.",
+  "Invalid topic section source events.",
+  "Invalid topic sections.",
+  "Invalid topic title or description.",
+  "New topic overview must match a final topic section.",
+  "Old overview evidence must be preserved verbatim; new sections need batch events.",
+  "Old section membership must be preserved; reassignment needs batch events.",
+  "Overview references must belong to returned topic membership.",
+  "Section references must belong to returned topic membership.",
+  "Topic projection lease expired; stale result rejected.",
+  "Topic projection must contain at most 8 overview paragraphs per chapter per batch.",
+  "Topic projection must return 1-12 topics.",
+  "Topic projection omitted batch events.",
+  "Topic projection source version changed; stale result rejected.",
+  "Topic sections omitted batch events.",
+  "Truncated topic sources permit navigation scope only, not factual overview.",
+  "Unknown or unexposed topic id.",
+  "duplicate chapter label; combine its batch assignments",
+  "duplicate section title",
+  "every returned topic must cover a supplied batch Event",
+  "every supplied batch Event must be assigned to a topic",
+  "every topic batch Event must be assigned to a section",
+  "expected only topics, with at most 12 entries",
+  "new overview must match a declared or inherited section",
+  "old overview evidence may only be preserved verbatim; rewritten entries must cite batch Events only",
+  "overview must contain 0-8 source-grounded entries",
+  "overview.sourceEventIds must contain unique, supplied Event ids (at most 12)",
+  "overview.text must be nonempty and at most 600 characters",
+  "overview.title must be nonempty and at most 80 characters",
+  "section backfill must update only its existing chapter",
+  "section.sourceEventIds must contain unique, supplied Event ids",
+  "section.title must be nonempty and at most 80 characters",
+  "sections must assign batch Events independently of overview",
+  "topic.description must be nonempty and at most 400 characters",
+  "topic.sourceEventIds must contain unique, supplied Event ids",
+  "topic.title must be nonempty and at most 120 characters",
+  "topicId must be nonempty and at most 200 characters",
+  "truncated Event evidence may only support scope entries",
+  "unexpected overview field",
+  "unexpected section field",
+  "unexpected topic field",
+  "unknown or repeated topicId",
+  "unknown overview kind",
+  "topic input exceeds model context capacity",
+  "output token limit reached",
+  "structured topic schema mismatch",
+  "tool arguments are not valid JSON",
+  "expected exactly one structured topic call",
+  "topic semantic validation failed",
+  "structured model task timed out",
+  "provider or route error",
+  "topic worker failed",
+  "source version changed; stale result rejected",
+  "topic projection lease expired"
+]);
+function safeTopicDiagnostics(value) {
+  if (!value || typeof value !== "object") return void 0;
+  const input = value;
+  if (!categories.includes(input.category)) return void 0;
+  const result = {
+    category: input.category,
+    reason: typeof input.reason === "string" && TOPIC_SAFE_REASONS.has(input.reason) ? input.reason : "topic worker failed"
+  };
+  for (const key of [
+    "eventCount",
+    "candidateTopicCount",
+    "estimatedInputTokens",
+    "requestedOutputTokens",
+    "maxOutputTokens",
+    "modelCalls",
+    "attempt",
+    "splitDepth"
+  ]) {
+    const number = input[key];
+    if (typeof number === "number" && Number.isSafeInteger(number) && number >= 0) result[key] = number;
+  }
+  if (["stop", "max-tokens", "error", "aborted", "tool-calls", "unknown"].includes(String(input.finishReason))) {
+    result.finishReason = input.finishReason;
+  }
+  if (["requested-unverified", "reasoning-observed", "fallback", "unavailable"].includes(String(input.reasoningOff))) {
+    result.reasoningOff = input.reasoningOff;
+  }
+  if (typeof input.reasoningObserved === "boolean") result.reasoningObserved = input.reasoningObserved;
+  return result;
+}
+var TopicProjectionError = class extends Error {
+  diagnostics;
+  constructor(category, reason, metadata = {}) {
+    const diagnostics = safeTopicDiagnostics({ ...metadata, category, reason });
+    super(`${diagnostics.category}: ${diagnostics.reason}`);
+    this.name = "TopicProjectionError";
+    this.diagnostics = diagnostics;
+  }
+};
+
+// packages/core/src/topics.ts
 var MEMORY_TOPIC_PROJECTOR_VERSION = 3;
 var TOPIC_BATCH_LIMIT = 12;
 var TOPIC_CANDIDATE_LIMIT = 12;
@@ -3762,8 +3879,25 @@ function memoryTopicSectionTitle(part) {
   return part.title?.trim() || SECTION_TITLES[part.kind] || "\u4E3B\u9898\u6982\u89C8";
 }
 var normalizedLabel = (value) => value.normalize("NFKC").trim().replace(/\s+/g, " ").toLowerCase();
+function memoryTopicOverviewMatchesSection(part, titles) {
+  const display = normalizedLabel(memoryTopicSectionTitle(part));
+  return titles.some((title) => normalizedLabel(title) === display);
+}
+function memoryTopicMembershipSections(topic) {
+  if (topic.sections !== void 0) return structuredClone(topic.sections);
+  const sections = /* @__PURE__ */ new Map();
+  for (const part of topic.overview) {
+    const title = memoryTopicSectionTitle(part);
+    const key = normalizedLabel(title);
+    const section = sections.get(key) ?? { title, sourceEventIds: [] };
+    section.sourceEventIds = unique2([...section.sourceEventIds, ...part.sourceEventIds]);
+    sections.set(key, section);
+  }
+  return [...sections.values()];
+}
 function sectionTitles(topic) {
   const titles = /* @__PURE__ */ new Map();
+  for (const section of memoryTopicMembershipSections(topic)) titles.set(normalizedLabel(section.title), section.title);
   for (const part of topic.overview) {
     const title = memoryTopicSectionTitle(part);
     if (!titles.has(normalizedLabel(title))) titles.set(normalizedLabel(title), title);
@@ -3788,6 +3922,7 @@ function topicView(topic, events, versions) {
     description: valid ? topic.description : "\u6982\u89C8\u7B49\u5F85\u91CD\u65B0\u6574\u7406\uFF0C\u8BF7\u67E5\u770B\u5173\u8054\u4E8B\u4EF6\u3002",
     sourceEventIds: ids,
     overview: overview2,
+    sections: valid ? memoryTopicMembershipSections(topic) : [],
     createdAt: topic.createdAt,
     updatedAt: topic.updatedAt,
     coverage: { totalEvents: ids.length, summarizedEvents: summarized.size, omittedEvents: ids.length - summarized.size },
@@ -3816,6 +3951,9 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
   state = { topics: [], jobs: [], projectedVersions: {} };
   restore(state) {
     this.state = state ? structuredClone(state) : { topics: [], jobs: [], projectedVersions: {} };
+    for (const topic of this.state.topics) if (topic.sections === void 0) {
+      topic.sections = memoryTopicMembershipSections(topic);
+    }
     if (state && state.rebuildVersions === void 0 && state.topics.some((topic) => topic.invalidated)) {
       this.state.rebuildVersions = Object.fromEntries(state.topics.filter((topic) => topic.invalidated).flatMap((topic) => Object.entries(topic.sourceVersions).filter(([id, version]) => state.projectedVersions[id] !== version)));
     }
@@ -3851,9 +3989,23 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
   bootstrap() {
     return this.state.bootstrap ? structuredClone(this.state.bootstrap) : null;
   }
+  needsInitialization() {
+    return this.state.bootstrap?.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION || this.state.sectionMembershipVersion !== 1;
+  }
   initializeBootstrap(events, now) {
-    if (this.state.bootstrap?.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION) return;
     this.synchronize(events, now);
+    if (this.state.sectionMembershipVersion !== 1) {
+      const versions = sourceVersions(new Map(events.filter(visible).map((event) => [event.id, event])));
+      const missing = {};
+      for (const topic of this.state.topics.filter((topic2) => !topic2.invalidated)) {
+        const assigned = new Set(memoryTopicMembershipSections(topic).flatMap((section) => section.sourceEventIds));
+        const ids = topic.sourceEventIds.filter((id) => !assigned.has(id) && versions.has(id) && this.state.projectedVersions[id] === versions.get(id));
+        if (ids.length) missing[topic.id] = Object.fromEntries(ids.map((id) => [id, versions.get(id)]));
+      }
+      this.state.sectionBackfill = missing;
+      this.state.sectionMembershipVersion = 1;
+    }
+    if (this.state.bootstrap?.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION) return;
     this.state.bootstrap = {
       projectorVersion: MEMORY_TOPIC_PROJECTOR_VERSION,
       sourceVersions: Object.fromEntries(sourceVersions(new Map(events.filter(visible).map((event) => [event.id, event])))),
@@ -3869,7 +4021,7 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
     const versions = sourceVersions(sources2);
     if (this.state.bootstrap && this.state.bootstrap.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION || this.state.topics.some((topic) => topic.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION) || this.state.jobs.some((job) => job.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION)) {
       const fromV2 = (!this.state.bootstrap || this.state.bootstrap.projectorVersion === 2) && this.state.topics.every((topic) => topic.projectorVersion === 2) && this.state.jobs.every((job) => job.projectorVersion === 2);
-      const chapters = fromV2 ? this.state.topics.filter((topic) => !topic.invalidated && topic.title.trim() && topic.description.trim() && topic.sourceEventIds.length > 0 && topic.sourceEventIds.every((id) => sources2.has(id) && topic.sourceVersions[id] === versions.get(id)) && Object.entries(topic.dependencyVersions ?? topic.sourceVersions).every(([id, version]) => versions.get(id) === version)).map((topic) => ({ ...topic, overview: [], projectorVersion: MEMORY_TOPIC_PROJECTOR_VERSION, updatedAt: now })) : [];
+      const chapters = fromV2 ? this.state.topics.filter((topic) => !topic.invalidated && topic.title.trim() && topic.description.trim() && topic.sourceEventIds.length > 0 && topic.sourceEventIds.every((id) => sources2.has(id) && topic.sourceVersions[id] === versions.get(id)) && Object.entries(topic.dependencyVersions ?? topic.sourceVersions).every(([id, version]) => versions.get(id) === version)).map((topic) => ({ ...topic, overview: [], sections: [], projectorVersion: MEMORY_TOPIC_PROJECTOR_VERSION, updatedAt: now })) : [];
       this.state = { topics: chapters, jobs: [], projectedVersions: {} };
     }
     for (const topic of this.state.topics) {
@@ -3878,6 +4030,7 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
         topic.title = "";
         topic.description = "";
         topic.overview = [];
+        topic.sections = [];
         for (const id of topic.sourceEventIds) if (sources2.has(id)) {
           const version = versions.get(id);
           if (topic.sourceVersions[id] === version && this.state.projectedVersions[id] === version) {
@@ -3901,6 +4054,13 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       job.superseded = true;
       job.lastError = "source-changed";
       job.updatedAt = now;
+      job.diagnostics = safeTopicDiagnostics({
+        ...job.diagnostics,
+        category: "source-changed",
+        reason: "source version changed; stale result rejected",
+        eventCount: job.sourceEventIds.length,
+        attempt: job.attempts
+      });
     }
     const finished = this.state.jobs.filter((job) => job.status === "completed" || job.status === "failed" && job.nextRetryAt === null);
     const retain = new Set([...finished.slice(-64), ...finished.filter((job) => job.status === "failed" && !job.superseded && job.attempts >= TOPIC_MAX_ATTEMPTS)].map((job) => job.id));
@@ -3908,6 +4068,12 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
     for (const [id, version] of Object.entries(this.state.rebuildVersions ?? {})) {
       if (versions.get(id) !== version || this.state.projectedVersions[id] === version) delete this.state.rebuildVersions[id];
     }
+    for (const [topicId, pending] of Object.entries(this.state.sectionBackfill ?? {})) {
+      const topic = this.state.topics.find((topic2) => topic2.id === topicId && !topic2.invalidated);
+      const assigned = new Set(topic ? memoryTopicMembershipSections(topic).flatMap((section) => section.sourceEventIds) : []);
+      for (const [id, version] of Object.entries(pending)) if (!topic || !topic.sourceEventIds.includes(id) || versions.get(id) !== version || assigned.has(id)) delete pending[id];
+      if (!Object.keys(pending).length) delete this.state.sectionBackfill[topicId];
+    }
     const bootstrap = this.state.bootstrap;
     if (bootstrap && bootstrap.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION) {
       const outstanding = Object.entries(bootstrap.sourceVersions).filter(([id, version]) => versions.get(id) === version && this.state.projectedVersions[id] !== version);
@@ -3920,6 +4086,14 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
   }
   recover(now) {
     for (const job of this.state.jobs) if (job.status === "running" && Date.parse(job.leaseUntil ?? job.updatedAt) <= Date.parse(now)) {
+      job.diagnostics = safeTopicDiagnostics({
+        category: "timeout",
+        reason: "topic projection lease expired",
+        eventCount: job.sourceEventIds.length,
+        candidateTopicCount: job.context?.existingTopics.length,
+        attempt: job.attempts,
+        splitDepth: job.splitDepth ?? 0
+      });
       job.status = "failed";
       job.lastError = "timeout";
       job.context = null;
@@ -3928,29 +4102,36 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       job.updatedAt = now;
     }
   }
-  pendingEvents(events) {
+  pendingWork(events) {
     const sources2 = new Map(events.filter(visible).map((event) => [event.id, event]));
     const versions = sourceVersions(sources2);
     const dirtyIds = new Set(this.state.topics.filter((topic) => topic.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION || Object.entries(topic.dependencyVersions ?? topic.sourceVersions).some(([id, version]) => versions.get(id) !== version)).flatMap((topic) => topic.sourceEventIds));
-    return events.filter(visible).filter((event) => {
+    const blocked = (id, version, topicId) => this.state.jobs.some((job) => !job.superseded && job.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION && job.sectionBackfillTopicId === topicId && job.sourceVersions[id] === version && jobInputsCurrent(job, versions) && (job.status === "running" || job.status === "pending" || job.status === "failed" && (job.attempts >= TOPIC_MAX_ATTEMPTS || job.nextRetryAt !== null)));
+    return events.filter(visible).sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id)).flatMap((event) => {
       const version = versions.get(event.id);
-      if (this.state.projectedVersions[event.id] === version && !dirtyIds.has(event.id)) return false;
-      return !this.state.jobs.some((job) => !job.superseded && job.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION && job.sourceVersions[event.id] === version && jobInputsCurrent(job, versions) && (job.status === "running" || job.status === "pending" || job.status === "failed" && (job.attempts >= TOPIC_MAX_ATTEMPTS || job.nextRetryAt !== null)));
-    }).sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+      const work = [];
+      if ((this.state.projectedVersions[event.id] !== version || dirtyIds.has(event.id)) && !blocked(event.id, version)) {
+        work.push({ event });
+      }
+      for (const [topicId, pending] of Object.entries(this.state.sectionBackfill ?? {})) {
+        if (pending[event.id] === version && !blocked(event.id, version, topicId)) work.push({ event, sectionBackfillTopicId: topicId });
+      }
+      return work;
+    });
   }
-  isBootstrap(id, version) {
+  isBootstrap(id, version, sectionBackfillTopicId) {
     const bootstrap = this.state.bootstrap;
-    return this.state.rebuildVersions?.[id] === version || !bootstrap || bootstrap.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION || bootstrap.status !== "completed" && bootstrap.sourceVersions[id] === version;
+    return sectionBackfillTopicId !== void 0 || this.state.rebuildVersions?.[id] === version || !bootstrap || bootstrap.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION || bootstrap.status !== "completed" && bootstrap.sourceVersions[id] === version;
   }
-  matchesMode(ids, versions, mode) {
-    return mode === "all" || ids.some((id) => this.isBootstrap(id, versions.get(id)) === (mode === "bootstrap"));
+  matchesMode(ids, versions, mode, sectionBackfillTopicId) {
+    return mode === "all" || ids.some((id) => this.isBootstrap(id, versions.get(id), sectionBackfillTopicId) === (mode === "bootstrap"));
   }
   hasPending(events, now, mode = "all") {
     const sources2 = new Map(events.filter(visible).map((event) => [event.id, event]));
     const versions = sourceVersions(sources2);
     const running = this.state.jobs.find((job) => job.status === "running");
     if (running) return Date.parse(running.leaseUntil ?? running.updatedAt) <= now || !jobInputsCurrent(running, versions);
-    return this.pendingEvents(events).some((event) => this.matchesMode([event.id], versions, mode)) || this.state.jobs.some((job) => !job.superseded && job.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION && job.attempts < TOPIC_MAX_ATTEMPTS && (job.status === "pending" || job.status === "failed" && job.nextRetryAt !== null && Date.parse(job.nextRetryAt) <= now) && jobInputsCurrent(job, versions) && this.matchesMode(job.sourceEventIds, versions, mode));
+    return this.pendingWork(events).some(({ event, sectionBackfillTopicId }) => this.matchesMode([event.id], versions, mode, sectionBackfillTopicId)) || this.state.jobs.some((job) => !job.superseded && job.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION && job.attempts < TOPIC_MAX_ATTEMPTS && (job.status === "pending" && (job.nextRetryAt === null || Date.parse(job.nextRetryAt) <= now) || job.status === "failed" && job.nextRetryAt !== null && Date.parse(job.nextRetryAt) <= now) && jobInputsCurrent(job, versions) && this.matchesMode(job.sourceEventIds, versions, mode, job.sectionBackfillTopicId));
   }
   claim(events, now, mode = "all") {
     if (this.state.bootstrap?.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION) {
@@ -3961,9 +4142,9 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
     if (this.state.jobs.some((job2) => job2.status === "running")) return null;
     const sources2 = new Map(events.filter(visible).map((event) => [event.id, event]));
     const versions = sourceVersions(sources2);
-    const eligible = this.state.jobs.filter((job2) => !job2.superseded && job2.attempts < TOPIC_MAX_ATTEMPTS && (job2.status === "pending" || job2.status === "failed" && job2.nextRetryAt !== null && Date.parse(job2.nextRetryAt) <= Date.parse(now)) && jobInputsCurrent(job2, versions) && this.matchesMode(job2.sourceEventIds, versions, mode)).sort((a, b) => Number(this.isBootstrap(a.sourceEventIds[0], versions.get(a.sourceEventIds[0]))) - Number(this.isBootstrap(b.sourceEventIds[0], versions.get(b.sourceEventIds[0]))))[0];
+    const eligible = this.state.jobs.filter((job2) => !job2.superseded && job2.attempts < TOPIC_MAX_ATTEMPTS && (job2.status === "pending" && (job2.nextRetryAt === null || Date.parse(job2.nextRetryAt) <= Date.parse(now)) || job2.status === "failed" && job2.nextRetryAt !== null && Date.parse(job2.nextRetryAt) <= Date.parse(now)) && jobInputsCurrent(job2, versions) && this.matchesMode(job2.sourceEventIds, versions, mode, job2.sectionBackfillTopicId)).sort((a, b) => Number(this.isBootstrap(a.sourceEventIds[0], versions.get(a.sourceEventIds[0]), a.sectionBackfillTopicId)) - Number(this.isBootstrap(b.sourceEventIds[0], versions.get(b.sourceEventIds[0]), b.sectionBackfillTopicId)))[0];
     let job = eligible;
-    if (job && this.isBootstrap(job.sourceEventIds[0], versions.get(job.sourceEventIds[0])) && mode === "all" && this.pendingEvents(events).some((event) => !this.isBootstrap(event.id, versions.get(event.id)))) job = void 0;
+    if (job && this.isBootstrap(job.sourceEventIds[0], versions.get(job.sourceEventIds[0]), job.sectionBackfillTopicId) && mode === "all" && this.pendingWork(events).some(({ event, sectionBackfillTopicId }) => !this.isBootstrap(event.id, versions.get(event.id), sectionBackfillTopicId))) job = void 0;
     if (job?.status === "failed") {
       const previous = job;
       previous.nextRetryAt = null;
@@ -3983,9 +4164,10 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       this.state.jobs.push(job);
     }
     if (!job) {
-      const pending = this.pendingEvents(events).filter((event) => this.matchesMode([event.id], versions, mode)).sort((a, b) => Number(this.isBootstrap(a.id, versions.get(a.id))) - Number(this.isBootstrap(b.id, versions.get(b.id)))).filter((event) => !this.state.jobs.some((candidate) => candidate.status === "failed" && candidate.attempts < TOPIC_MAX_ATTEMPTS && candidate.nextRetryAt !== null && candidate.sourceVersions[event.id] === versions.get(event.id)));
+      const pending = this.pendingWork(events).filter(({ event, sectionBackfillTopicId }) => this.matchesMode([event.id], versions, mode, sectionBackfillTopicId)).sort((a, b) => Number(this.isBootstrap(a.event.id, versions.get(a.event.id), a.sectionBackfillTopicId)) - Number(this.isBootstrap(b.event.id, versions.get(b.event.id), b.sectionBackfillTopicId)));
       const first = pending[0];
-      const sameKind = pending.filter((event) => first && this.isBootstrap(event.id, versions.get(event.id)) === this.isBootstrap(first.id, versions.get(first.id))).slice(0, TOPIC_BATCH_LIMIT);
+      const backfillTopicId = first?.sectionBackfillTopicId;
+      const sameKind = pending.filter(({ event, sectionBackfillTopicId }) => first && sectionBackfillTopicId === backfillTopicId && this.isBootstrap(event.id, versions.get(event.id), sectionBackfillTopicId) === this.isBootstrap(first.event.id, versions.get(first.event.id), backfillTopicId)).slice(0, TOPIC_BATCH_LIMIT).map(({ event }) => event);
       const batch2 = [];
       let eventBudget = 16e3;
       for (const event of sameKind) {
@@ -4012,6 +4194,7 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
         createdAt: now,
         updatedAt: now
       };
+      if (backfillTopicId) job.sectionBackfillTopicId = backfillTopicId;
       this.state.jobs.push(job);
     }
     const batch = job.sourceEventIds.map((id) => sources2.get(id));
@@ -4030,21 +4213,30 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       }).join(" "), 4]
     ])).map(({ item, score }) => [item.id, score]));
     const overlap = (topic) => topic.sourceEventIds.filter((id) => batchIds.has(id)).length;
-    const candidates = eligibleTopics.sort((a, b) => overlap(b) - overlap(a) || (lexicalScores.get(b.id) ?? 0) - (lexicalScores.get(a.id) ?? 0) || b.updatedAt.localeCompare(a.updatedAt) || a.id.localeCompare(b.id)).slice(0, TOPIC_CANDIDATE_LIMIT);
+    const candidates = eligibleTopics.filter((topic) => !job.sectionBackfillTopicId || topic.id === job.sectionBackfillTopicId).sort((a, b) => overlap(b) - overlap(a) || (lexicalScores.get(b.id) ?? 0) - (lexicalScores.get(a.id) ?? 0) || b.updatedAt.localeCompare(a.updatedAt) || a.id.localeCompare(b.id)).slice(0, TOPIC_CANDIDATE_LIMIT);
     const existingTopics = [];
     let remaining = 3e4 - JSON.stringify(batch.map(compactEvent)).length;
     for (const topic of candidates) {
-      const overview2 = topic.overview.slice(0, 4);
+      const overview2 = job.sectionBackfillTopicId ? [] : topic.overview.slice(0, 4);
       const exposed = unique2([
         ...overview2.flatMap((part) => part.sourceEventIds),
         ...topic.sourceEventIds.filter((id) => batchIds.has(id))
       ]);
+      const allTitles = sectionTitles(topic);
+      let titleBudget = 4e3;
+      const shownTitles = job.sectionBackfillTopicId ? allTitles.filter((title, index) => {
+        const cost2 = JSON.stringify(title).length;
+        if (index >= 120 || cost2 > titleBudget) return false;
+        titleBudget -= cost2;
+        return true;
+      }) : allTitles;
       const candidate = {
         id: topic.id,
         title: topic.title,
         description: topic.description,
         overview: overview2,
-        sectionTitles: sectionTitles(topic),
+        sectionTitles: shownTitles,
+        ...shownTitles.length < allTitles.length ? { sectionTitlesOmitted: allTitles.length - shownTitles.length } : {},
         sourceEventIds: exposed,
         totalSourceEvents: topic.sourceEventIds.length
       };
@@ -4057,7 +4249,16 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       const compact = compactEvent(event);
       return compact.title !== event.title || compact.summary !== event.summary || JSON.stringify(compact.temporal) !== JSON.stringify(topicTemporal(event)) || JSON.stringify(compact.tags) !== JSON.stringify(event.tags);
     }).map((event) => event.id);
-    job.context = { jobId: job.id, events: batch.map(compactEvent), existingTopics, truncatedEventIds };
+    if (job.sectionBackfillTopicId && !existingTopics.some((topic) => topic.id === job.sectionBackfillTopicId)) {
+      throw new Error("Section backfill chapter cannot fit the projection input budget.");
+    }
+    job.context = {
+      jobId: job.id,
+      events: batch.map(compactEvent),
+      existingTopics,
+      truncatedEventIds,
+      ...job.sectionBackfillTopicId ? { sectionBackfillTopicId: job.sectionBackfillTopicId } : {}
+    };
     const storedById = new Map(this.state.topics.map((topic) => [topic.id, topic]));
     job.candidateVersions = Object.fromEntries(existingTopics.map((topic) => [topic.id, digest(storedById.get(topic.id))]));
     const dependencyIds = unique2([...job.sourceEventIds, ...existingTopics.flatMap((topic) => [
@@ -4065,12 +4266,13 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       ...!storedById.get(topic.id).invalidated ? Object.keys(storedById.get(topic.id).dependencyVersions ?? {}).filter((id) => sources2.has(id)) : []
     ])]);
     job.dependencyVersions = Object.fromEntries(dependencyIds.map((id) => [id, versions.get(id)]));
+    job.diagnostics = void 0;
     job.status = "running";
     job.attempts += 1;
     job.lastError = null;
     job.nextRetryAt = null;
     job.updatedAt = now;
-    if (this.state.bootstrap.status === "pending" && this.matchesMode(job.sourceEventIds, versions, "bootstrap")) {
+    if (this.state.bootstrap.status === "pending" && this.matchesMode(job.sourceEventIds, versions, "bootstrap", job.sectionBackfillTopicId)) {
       this.state.bootstrap.status = "running";
     }
     job.leaseUntil = new Date(Date.parse(now) + TOPIC_LEASE_MS).toISOString();
@@ -4080,13 +4282,16 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
     const job = this.requireJob(id);
     if (job.status === "completed") return { topicIds: [...job.topicIds] };
     if (job.status !== "running" || !job.context) throw new Error(`Topic projection ${id} is not running`);
-    if (Date.parse(job.leaseUntil ?? job.updatedAt) <= Date.parse(now)) throw new Error("Topic projection lease expired; stale result rejected.");
+    if (Date.parse(job.leaseUntil ?? job.updatedAt) <= Date.parse(now)) throw new TopicProjectionError("source-changed", "Topic projection lease expired; stale result rejected.");
     const sources2 = new Map(events.filter(visible).map((event) => [event.id, event]));
     const versions = sourceVersions(sources2);
     if (!jobInputsCurrent(job, versions) || Object.entries(job.candidateVersions).some(([topicId, version]) => digest(this.state.topics.find((topic) => topic.id === topicId)) !== version)) {
-      throw new Error("Topic projection source version changed; stale result rejected.");
+      throw new TopicProjectionError("source-changed", "Topic projection source version changed; stale result rejected.");
+    }
+    if (!Array.isArray(result?.topics) || result.topics.length < 1 || result.topics.length > 12) throw new TopicProjectionError("validation-failed", "Topic projection must return 1-12 topics.");
+    if (job.sectionBackfillTopicId && (result.topics.length !== 1 || result.topics[0].topicId !== job.sectionBackfillTopicId || result.topics[0].sections === void 0)) {
+      throw new TopicProjectionError("validation-failed", "Invalid section backfill: explicit sections must cover the existing chapter.");
     }
-    if (!Array.isArray(result?.topics) || result.topics.length < 1 || result.topics.length > 12) throw new Error("Topic projection must return 1-12 topics.");
     const candidates = new Map(job.context.existingTopics.map((topic) => [topic.id, topic]));
     const allowed = /* @__PURE__ */ new Set([...job.sourceEventIds, ...job.context.existingTopics.flatMap((topic) => topic.sourceEventIds)]);
     const batchIds = new Set(job.sourceEventIds);
@@ -4095,7 +4300,7 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
     const labels = /* @__PURE__ */ new Set();
     const proposals = [];
     const checkIds = (ids, label) => {
-      if (!Array.isArray(ids) || ids.length === 0 || unique2(ids).length !== ids.length || ids.some((eventId) => typeof eventId !== "string" || !allowed.has(eventId))) throw new Error(`Invalid topic ${label} source events.`);
+      if (!Array.isArray(ids) || ids.length === 0 || unique2(ids).length !== ids.length || ids.some((eventId) => typeof eventId !== "string" || !allowed.has(eventId))) throw new TopicProjectionError("validation-failed", `Invalid topic ${label} source events.`);
       return ids;
     };
     for (const proposal of result.topics) {
@@ -4105,44 +4310,72 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       const label = normalizedLabel;
       const sameLabel = typeof proposal.title === "string" ? this.state.topics.filter((topic) => !topic.invalidated && label(topic.title) === label(proposal.title)) : [];
       if (sameLabel.some((topic) => !candidates.has(topic.id))) {
-        throw new Error("Invalid duplicate chapter label matches an unexposed existing topic.");
+        throw new TopicProjectionError("validation-failed", "Invalid duplicate chapter label matches an unexposed existing topic.");
       }
       const existing = proposal.topicId ? this.state.topics.find((topic) => topic.id === proposal.topicId) : inferred ?? (sameLabel.length === 1 ? sameLabel[0] : void 0);
       if (sameLabel.some((topic) => topic.id !== existing?.id)) {
-        throw new Error("Invalid duplicate chapter label conflicts with an existing topic.");
+        throw new TopicProjectionError("validation-failed", "Invalid duplicate chapter label conflicts with an existing topic.");
       }
       if (typeof proposal.title === "string") {
         const key = label(proposal.title);
-        if (labels.has(key)) throw new Error("Invalid duplicate chapter label in one projection.");
+        if (labels.has(key)) throw new TopicProjectionError("validation-failed", "Invalid duplicate chapter label in one projection.");
         labels.add(key);
       }
-      if (proposal.topicId && (!existing || !candidates.has(proposal.topicId))) throw new Error("Unknown or unexposed topic id.");
+      if (proposal.topicId && (!existing || !candidates.has(proposal.topicId))) throw new TopicProjectionError("validation-failed", "Unknown or unexposed topic id.");
       const topicId = existing?.id ?? `topic_${randomUUID()}`;
-      if (touched.has(topicId)) throw new Error("A topic may be updated only once per projection.");
+      if (touched.has(topicId)) throw new TopicProjectionError("validation-failed", "A topic may be updated only once per projection.");
       touched.add(topicId);
-      if (typeof proposal.title !== "string" || !proposal.title.trim() || [...proposal.title].length > 120 || typeof proposal.description !== "string" || !proposal.description.trim() || [...proposal.description].length > 400) throw new Error("Invalid topic title or description.");
+      if (typeof proposal.title !== "string" || !proposal.title.trim() || [...proposal.title].length > 120 || typeof proposal.description !== "string" || !proposal.description.trim() || [...proposal.description].length > 400) throw new TopicProjectionError("validation-failed", "Invalid topic title or description.");
       for (const eventId of ids) if (batchIds.has(eventId)) covered.add(eventId);
-      if (!Array.isArray(proposal.overview) || proposal.overview.length > 8) throw new Error("Topic projection must contain at most 8 overview paragraphs per chapter per batch.");
+      if (!Array.isArray(proposal.overview) || proposal.overview.length > 8) throw new TopicProjectionError("validation-failed", "Topic projection must contain at most 8 overview paragraphs per chapter per batch.");
       for (const part of proposal.overview) {
-        if (part.title !== void 0 && (typeof part.title !== "string" || !part.title.trim() || [...part.title].length > 80)) throw new Error("Invalid topic overview title.");
-        if (!["history", "decision", "change", "open-question", "scope"].includes(part.kind) || typeof part.text !== "string" || !part.text.trim() || [...part.text].length > 600) throw new Error("Invalid topic overview section.");
+        if (part.title !== void 0 && (typeof part.title !== "string" || !part.title.trim() || [...part.title].length > 80)) throw new TopicProjectionError("validation-failed", "Invalid topic overview title.");
+        if (!["history", "decision", "change", "open-question", "scope"].includes(part.kind) || typeof part.text !== "string" || !part.text.trim() || [...part.text].length > 600) throw new TopicProjectionError("validation-failed", "Invalid topic overview section.");
         checkIds(part.sourceEventIds, "overview");
         if (part.kind !== "scope" && part.sourceEventIds.some((eventId) => job.context.truncatedEventIds?.includes(eventId))) {
-          throw new Error("Truncated topic sources permit navigation scope only, not factual overview.");
+          throw new TopicProjectionError("validation-failed", "Truncated topic sources permit navigation scope only, not factual overview.");
         }
-        if (part.sourceEventIds.length > 12 || part.sourceEventIds.some((eventId) => !ids.includes(eventId))) throw new Error("Overview references must belong to returned topic membership.");
-        if (part.sourceEventIds.some((eventId) => !batchIds.has(eventId)) && !candidates.get(topicId)?.overview.some((old) => digest(old) === digest(part))) throw new Error("Old overview evidence must be preserved verbatim; new sections need batch events.");
-      }
+        if (part.sourceEventIds.length > 12 || part.sourceEventIds.some((eventId) => !ids.includes(eventId))) throw new TopicProjectionError("validation-failed", "Overview references must belong to returned topic membership.");
+        if (part.sourceEventIds.some((eventId) => !batchIds.has(eventId)) && !candidates.get(topicId)?.overview.some((old) => digest(old) === digest(part))) throw new TopicProjectionError("validation-failed", "Old overview evidence must be preserved verbatim; new sections need batch events.");
+      }
+      if (proposal.sections !== void 0 && !Array.isArray(proposal.sections)) throw new TopicProjectionError("validation-failed", "Invalid topic sections.");
+      const assignments = memoryTopicMembershipSections(proposal);
+      const sectionLabels = /* @__PURE__ */ new Set();
+      for (const section of assignments) {
+        if (!section || typeof section.title !== "string" || !section.title.trim() || [...section.title].length > 80 || sectionLabels.has(label(section.title))) throw new TopicProjectionError("validation-failed", "Invalid or duplicate topic section title.");
+        sectionLabels.add(label(section.title));
+        checkIds(section.sourceEventIds, "section");
+        if (section.sourceEventIds.some((eventId) => !ids.includes(eventId))) throw new TopicProjectionError("validation-failed", "Section references must belong to returned topic membership.");
+        if (section.sourceEventIds.some((eventId) => !batchIds.has(eventId)) && !memoryTopicMembershipSections(existing ?? { overview: [] }).some((old) => label(old.title) === label(section.title) && section.sourceEventIds.filter((eventId) => !batchIds.has(eventId)).every((eventId) => old.sourceEventIds.includes(eventId)))) throw new TopicProjectionError("validation-failed", "Old section membership must be preserved; reassignment needs batch events.");
+      }
+      if (proposal.sections !== void 0 && ids.some((eventId) => batchIds.has(eventId) && !assignments.some((section) => section.sourceEventIds.includes(eventId)))) throw new TopicProjectionError("validation-failed", "Topic sections omitted batch events.");
       const membership = unique2([...(existing?.sourceEventIds ?? []).filter((eventId) => sources2.has(eventId)), ...ids]);
+      const assignedIds = new Set(proposal.sections === void 0 ? [] : assignments.flatMap((section) => section.sourceEventIds).filter((eventId) => batchIds.has(eventId)));
+      const sections = existing && !existing.invalidated ? memoryTopicMembershipSections(existing) : [];
+      const memberIds = new Set(membership);
+      for (const section of sections) section.sourceEventIds = section.sourceEventIds.filter((eventId) => memberIds.has(eventId) && !assignedIds.has(eventId));
+      for (const assignment of assignments) {
+        const section = sections.find((current) => label(current.title) === label(assignment.title));
+        if (section) section.sourceEventIds = unique2([...section.sourceEventIds, ...assignment.sourceEventIds]);
+        else sections.push({ title: assignment.title.trim(), sourceEventIds: [...assignment.sourceEventIds] });
+      }
+      const finalSections = sections.filter((section) => section.sourceEventIds.length > 0);
+      const titles = finalSections.map((section) => section.title);
       const inherited = existing && !existing.invalidated ? existing.overview : [];
-      const overview2 = unique2(proposal.overview.map((part) => JSON.stringify(part))).map((part) => JSON.parse(part));
-      for (const part of inherited) if (!overview2.some((current) => digest(current) === digest(part))) overview2.push(structuredClone(part));
+      if (proposal.sections !== void 0) for (const part of proposal.overview) {
+        if (!inherited.some((old) => digest(old) === digest(part)) && !memoryTopicOverviewMatchesSection(part, titles)) {
+          throw new TopicProjectionError("validation-failed", "New topic overview must match a final topic section.");
+        }
+      }
+      const overview2 = unique2(proposal.overview.filter((part) => memoryTopicOverviewMatchesSection(part, titles)).map((part) => JSON.stringify(part))).map((part) => JSON.parse(part));
+      for (const part of inherited) if (memoryTopicOverviewMatchesSection(part, titles) && !overview2.some((current) => digest(current) === digest(part))) overview2.push(structuredClone(part));
       proposals.push({
         id: topicId,
-        title: proposal.title.trim(),
-        description: proposal.description.trim(),
+        title: job.sectionBackfillTopicId ? existing.title : proposal.title.trim(),
+        description: job.sectionBackfillTopicId ? existing.description : proposal.description.trim(),
         sourceEventIds: membership,
         overview: overview2,
+        sections: finalSections,
         sourceVersions: Object.fromEntries(membership.map((eventId) => [eventId, versions.get(eventId)])),
         dependencyVersions: { ...!existing?.invalidated ? existing?.dependencyVersions ?? {} : {}, ...job.dependencyVersions },
         projectorVersion: MEMORY_TOPIC_PROJECTOR_VERSION,
@@ -4151,11 +4384,16 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
         updatedAt: now
       });
     }
-    if (job.sourceEventIds.some((eventId) => !covered.has(eventId))) throw new Error("Topic projection omitted batch events.");
+    if (job.sourceEventIds.some((eventId) => !covered.has(eventId))) throw new TopicProjectionError("validation-failed", "every supplied batch Event must be assigned to a topic");
     for (const topic of proposals) {
       const index = this.state.topics.findIndex((current) => current.id === topic.id);
       if (index < 0) this.state.topics.push(topic);
       else this.state.topics[index] = topic;
+      const pending = this.state.sectionBackfill?.[topic.id];
+      if (pending) {
+        for (const eventId of memoryTopicMembershipSections(topic).flatMap((section) => section.sourceEventIds)) delete pending[eventId];
+        if (!Object.keys(pending).length) delete this.state.sectionBackfill[topic.id];
+      }
     }
     Object.assign(this.state.projectedVersions, job.sourceVersions);
     for (const [eventId, version] of Object.entries(job.sourceVersions)) {
@@ -4176,13 +4414,49 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
   fail(id, error, now) {
     const job = this.state.jobs.find((candidate) => candidate.id === id);
     if (!job || job.status !== "running") return;
+    const diagnostic = error instanceof TopicProjectionError ? safeTopicDiagnostics(error.diagnostics) : void 0;
+    const message = error instanceof Error ? error.message : String(error);
+    const category = diagnostic?.category ?? (/timeout|timed out/i.test(message) ? "timeout" : /source.*changed|stale|not running/i.test(message) ? "source-changed" : "worker-failed");
+    job.diagnostics = safeTopicDiagnostics({
+      ...diagnostic,
+      category,
+      reason: diagnostic?.reason ?? (category === "timeout" ? "structured model task timed out" : category === "source-changed" ? "source version changed; stale result rejected" : "topic worker failed"),
+      eventCount: job.sourceEventIds.length,
+      candidateTopicCount: diagnostic?.candidateTopicCount ?? job.context?.existingTopics.length,
+      attempt: job.attempts,
+      splitDepth: job.splitDepth ?? 0
+    });
     job.status = "failed";
     job.context = null;
     job.leaseUntil = null;
-    const message = error instanceof Error ? error.message : String(error);
-    job.lastError = /timeout|timed out/i.test(message) ? "timeout" : /source.*changed|stale|not running/i.test(message) ? "source-changed" : /invalid|omitted|unknown|overview|projection must|truncat/i.test(message) ? "invalid-output" : "worker-failed";
+    job.lastError = category === "validation-failed" ? `${category}: ${job.diagnostics.reason}` : category;
     job.nextRetryAt = job.attempts < TOPIC_MAX_ATTEMPTS ? new Date(Date.parse(now) + 3e4 * 2 ** Math.max(0, job.attempts - 1)).toISOString() : null;
     job.updatedAt = now;
+    if (category === "max-tokens" && diagnostic?.finishReason === "max-tokens" && job.sourceEventIds.length > 1 && (job.splitDepth ?? 0) < 4) {
+      const middle = Math.ceil(job.sourceEventIds.length / 2);
+      for (const ids of [job.sourceEventIds.slice(0, middle), job.sourceEventIds.slice(middle)]) {
+        this.state.jobs.push({
+          ...structuredClone(job),
+          id: `tproj_${randomUUID()}`,
+          sourceEventIds: ids,
+          sourceVersions: Object.fromEntries(ids.map((id2) => [id2, job.sourceVersions[id2]])),
+          dependencyVersions: {},
+          candidateVersions: {},
+          status: "pending",
+          attempts: 0,
+          diagnostics: void 0,
+          splitDepth: (job.splitDepth ?? 0) + 1,
+          topicIds: [],
+          superseded: false,
+          lastError: null,
+          nextRetryAt: job.nextRetryAt,
+          createdAt: now,
+          updatedAt: now
+        });
+      }
+      job.superseded = true;
+      job.nextRetryAt = null;
+    }
   }
   requireJob(id) {
     const job = this.state.jobs.find((candidate) => candidate.id === id);
@@ -4193,7 +4467,7 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
     const previous = this.requireJob(id);
     const sources2 = new Map(events.filter(visible).map((event) => [event.id, event]));
     const versions = sourceVersions(sources2);
-    if (previous.superseded || previous.status !== "failed" || previous.attempts < TOPIC_MAX_ATTEMPTS || previous.nextRetryAt !== null || !jobInputsCurrent(previous, versions) || previous.sourceEventIds.some((eventId) => this.state.projectedVersions[eventId] === versions.get(eventId))) {
+    if (previous.superseded || previous.status !== "failed" || previous.attempts < TOPIC_MAX_ATTEMPTS || previous.nextRetryAt !== null || !jobInputsCurrent(previous, versions) || previous.sourceEventIds.some((eventId) => this.state.projectedVersions[eventId] === versions.get(eventId) && (!previous.sectionBackfillTopicId || this.state.sectionBackfill?.[previous.sectionBackfillTopicId]?.[eventId] !== versions.get(eventId)))) {
       throw new Error("Topic retry conflict: failure is no longer current or retryable.");
     }
     const job = {
@@ -4206,6 +4480,8 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       dependencyVersions: {},
       candidateVersions: {},
       topicIds: [],
+      diagnostics: void 0,
+      splitDepth: 0,
       lastError: null,
       nextRetryAt: null,
       leaseUntil: null,
@@ -4518,7 +4794,7 @@ var StrataGate = class _StrataGate {
   }
   async initializeTopicBootstrap() {
     for (let attempt = 0; attempt < 3; attempt += 1) {
-      if (this.topicDirectory.bootstrap()?.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION) return;
+      if (!this.topicDirectory.needsInitialization()) return;
       try {
         await this.commitMutation(() => this.topicDirectory.initializeBootstrap(this.listAllEvents(), toUtc8Iso(this.now())));
         return;
@@ -7411,7 +7687,7 @@ var TOPIC_OVERVIEW = {
   additionalProperties: false,
   properties: {
     kind: { type: "string", enum: TOPIC_OVERVIEW_KINDS, required: true },
-    title: { type: "string", description: "Lasting category inside the chapter, e.g. defect diagnosis and fixes, releases and installation, or architecture decisions. Never a single Event, bug, version, date or task title; at most 80 characters." },
+    title: { type: "string", description: "Lasting category inside the chapter. Must match a declared or inherited section title; if omitted, the kind default must match one. Never a single Event, bug, version, date or task title; at most 80 characters." },
     text: { type: "string", description: "Source-grounded scope, historical progress, decision, change, or unresolved question; preserve time, uncertainty, plans, cancellation, and disputes.", required: true },
     sourceEventIds: { ...STRING_ARRAY, required: true }
   }
@@ -7428,6 +7704,14 @@ var TOPIC_PROJECTOR_PARAMETERS = {
         title: { type: "string", description: "A broad lasting chapter label (project, life area, relationship), not a single task, release, UI page, or factual conclusion.", required: true },
         description: { type: "string", description: "Describe which records this topic covers; navigation only, not a claim about current truth.", required: true },
         sourceEventIds: { ...STRING_ARRAY, description: "Exact supplied Event ids assigned to this topic; existing unseen topic members are retained by the store.", required: true },
+        sections: { type: "array", required: true, items: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            title: { type: "string", description: "Reuse a lasting section title from sectionTitles when applicable.", required: true },
+            sourceEventIds: { ...STRING_ARRAY, description: "Batch Event ids routed to this section, regardless of overview citations.", required: true }
+          }
+        } },
         overview: { type: "array", items: TOPIC_OVERVIEW, required: true }
       }
     }
@@ -7441,7 +7725,7 @@ events.catalogHints \u4EC5\u662F\u53EF\u9009 routing hint\uFF08\u5206\u7C7B\u5BF
 \u8FD9\u4E9B\u4E8B\u4EF6\u5361\u662F\u6709\u754C\u7684\u5BFC\u822A\u6750\u6599\uFF0C\u6807\u9898\u6216\u6458\u8981\u53EF\u80FD\u7701\u7565\u5C3E\u90E8\uFF1B\u4E0D\u8981\u56E0\u672A\u770B\u5230\u5426\u5B9A\u3001\u540E\u7EED\u66F4\u65B0\u6216\u9650\u5236\u6761\u4EF6\u5C31\u63A8\u65AD\u5F53\u524D\u4E8B\u5B9E\u3001\u5B8C\u6210\u72B6\u6001\u6216\u6CA1\u6709\u4E89\u8BAE\u3002\u5B8C\u6574\u4E8B\u5B9E\u4ECD\u987B\u5C55\u5F00\u4E8B\u4EF6\u548C\u539F\u6587\u53D6\u8BC1\u3002status\u3001supersededBy\u3001temporal.status \u53CA\u5176\u660E\u786E\u5173\u7CFB\u63D0\u4F9B\u7684\u5386\u53F2\u3001\u8BA1\u5212\u3001\u53D6\u6D88\u548C\u51B2\u7A81\u6807\u8BB0\u5FC5\u987B\u4FDD\u7559\uFF1B\u6750\u6599\u4E0D\u8DB3\u65F6\u53EA\u5199\u8986\u76D6\u8303\u56F4\u6216\u5F85\u786E\u8BA4\uFF0C\u4E0D\u8865\u5199\u7ED3\u8BBA\u3002
 truncatedEventIds \u660E\u786E\u5217\u51FA\u672A\u5B8C\u6574\u63D0\u4F9B\u7684\u4E8B\u4EF6\uFF1A\u5F15\u7528\u5176\u4E2D\u4EFB\u4F55\u4E8B\u4EF6\u7684\u6982\u8981\u6BB5\u53EA\u80FD\u662F scope\uFF0C\u53EA\u8BF4\u660E\u8D44\u6599\u8303\u56F4\uFF0C\u4E0D\u5199\u5386\u53F2\u3001\u51B3\u5B9A\u3001\u53D8\u5316\u6216\u5F85\u786E\u8BA4\u7684\u4E8B\u5B9E\uFF1B\u6DF7\u5408\u5F15\u7528\u5176\u4ED6\u4E8B\u4EF6\u4E5F\u4E0D\u80FD\u653E\u5BBD\u6B64\u9650\u5236\u3002
 
-Topic \u662F\u957F\u671F\u7684\u5927\u7AE0\u8282\uFF0C\u6309\u9879\u76EE\u3001\u751F\u6D3B\u9886\u57DF\u6216\u957F\u671F\u5173\u7CFB\u7EC4\u7EC7\uFF0C\u800C\u4E0D\u662F\u6BCF\u4E2A\u4E8B\u4EF6\u6216\u5B50\u4EFB\u52A1\u4E00\u7AE0\u3002\u4F8B\u5982 StrataGate UI\u3001DSH \u517C\u5BB9\u3001Topic Directory\u3001Retrieval \u5E94\u5F52\u5165\u201CStrataGate\u201D\u540C\u4E00\u7AE0\uFF1B\u6C42\u804C\u6295\u9012\u3001\u9762\u8BD5\u548C\u5B9E\u4E60\u8FDB\u5C55\u5F52\u5165\u201C\u6C42\u804C\u4E0E\u804C\u4E1A\u53D1\u5C55\u201D\u3002existingTopics.sectionTitles \u5217\u51FA\u8BE5\u7AE0\u5168\u90E8\u5DF2\u6709\u5C0F\u8282\u6807\u9898\uFF0C\u4EC5\u4F9B\u5BFC\u822A\uFF0C\u4E0D\u662F\u6B63\u6587\u6216\u4E8B\u5B9E\u8BC1\u636E\u3002\u5DF2\u6709\u5C0F\u8282\u80FD\u5BB9\u7EB3\u672C\u6279\u4E8B\u9879\u65F6\u5FC5\u987B\u9010\u5B57\u590D\u7528\u539F title\uFF0C\u4E0D\u8981\u8FD1\u4E49\u6539\u540D\uFF1B\u4E0D\u80FD\u56E0\u4E3A overview \u53EA\u5C55\u793A\u524D\u51E0\u6BB5\u5C31\u91CD\u590D\u521B\u5EFA\u5C0F\u8282\u3002\u786E\u5B9E\u5C5E\u4E8E\u5DF2\u6709\u7C7B\u522B\u65E0\u6CD5\u5BB9\u7EB3\u7684\u65B0\u957F\u671F\u7C7B\u522B\u624D\u65B0\u589E\u5C0F\u8282\uFF1B\u5DF2\u6709\u7AE0\u4E5F\u5E94\u590D\u7528\u539F\u7AE0\u540D\u548C topicId\u3002\u5728\u7AE0\u5185\u7528 overview.title \u533A\u5206\u957F\u671F\u7C7B\u522B\uFF0C\u4F8B\u5982\u201C\u7F3A\u9677\u6392\u67E5\u4E0E\u4FEE\u590D\u201D\u201C\u7248\u672C\u53D1\u5E03\u4E0E\u5B89\u88C5\u201D\u201C\u67B6\u6784\u4E0E\u914D\u7F6E\u51B3\u7B56\u201D\u201C\u754C\u9762\u4E0E\u4EA4\u4E92\u201D\u201CDSH \u517C\u5BB9\u201D\uFF1Bkind \u8868\u793A\u6BB5\u843D\u5185\u5BB9\u6027\u8D28\uFF0C\u4E0D\u662F\u62C6\u7AE0\u6216\u62C6\u8282\u4F9D\u636E\u3002\u4E0D\u540C\u9879\u76EE\u6216\u4E0D\u76F8\u5173\u9886\u57DF\u4ECD\u5206\u5F00\uFF0C\u4E0D\u80FD\u4E3A\u51CF\u5C11\u7AE0\u6570\u786C\u5408\u5E76\u3002\u6BCF\u6279\u901A\u5E38\u53EA\u65B0\u589E 0-2 \u4E2A\u5927\u7AE0\u8282\uFF1B12 \u662F\u4E92\u4E0D\u76F8\u5173\u9886\u57DF\u7684\u5B89\u5168\u4E0A\u9650\uFF0C\u4E0D\u662F\u521B\u5EFA\u76EE\u6807\u3002
+Topic \u662F\u957F\u671F\u7684\u5927\u7AE0\u8282\uFF0C\u6309\u9879\u76EE\u3001\u751F\u6D3B\u9886\u57DF\u6216\u957F\u671F\u5173\u7CFB\u7EC4\u7EC7\uFF0C\u800C\u4E0D\u662F\u6BCF\u4E2A\u4E8B\u4EF6\u6216\u5B50\u4EFB\u52A1\u4E00\u7AE0\u3002\u4F8B\u5982 StrataGate UI\u3001DSH \u517C\u5BB9\u3001Topic Directory\u3001Retrieval \u5E94\u5F52\u5165\u201CStrataGate\u201D\u540C\u4E00\u7AE0\uFF1B\u6C42\u804C\u6295\u9012\u3001\u9762\u8BD5\u548C\u5B9E\u4E60\u8FDB\u5C55\u5F52\u5165\u201C\u6C42\u804C\u4E0E\u804C\u4E1A\u53D1\u5C55\u201D\u3002existingTopics.sectionTitles \u5217\u51FA\u8BE5\u7AE0\u5168\u90E8\u5DF2\u6709\u5C0F\u8282\u6807\u9898\uFF0C\u4EC5\u4F9B\u5BFC\u822A\uFF0C\u4E0D\u662F\u6B63\u6587\u6216\u4E8B\u5B9E\u8BC1\u636E\u3002\u5DF2\u6709\u5C0F\u8282\u80FD\u5BB9\u7EB3\u672C\u6279\u4E8B\u9879\u65F6\u5FC5\u987B\u9010\u5B57\u590D\u7528\u539F title\uFF0C\u4E0D\u8981\u8FD1\u4E49\u6539\u540D\uFF1B\u4E0D\u80FD\u56E0\u4E3A overview \u53EA\u5C55\u793A\u524D\u51E0\u6BB5\u5C31\u91CD\u590D\u521B\u5EFA\u5C0F\u8282\u3002\u786E\u5B9E\u5C5E\u4E8E\u5DF2\u6709\u7C7B\u522B\u65E0\u6CD5\u5BB9\u7EB3\u7684\u65B0\u957F\u671F\u7C7B\u522B\u624D\u65B0\u589E\u5C0F\u8282\uFF1B\u5DF2\u6709\u7AE0\u4E5F\u5E94\u590D\u7528\u539F\u7AE0\u540D\u548C topicId\u3002\u5728\u7AE0\u5185\u7528 sections.title \u533A\u5206\u957F\u671F\u7C7B\u522B\uFF0C\u4F8B\u5982\u201C\u7F3A\u9677\u6392\u67E5\u4E0E\u4FEE\u590D\u201D\u201C\u7248\u672C\u53D1\u5E03\u4E0E\u5B89\u88C5\u201D\u201C\u67B6\u6784\u4E0E\u914D\u7F6E\u51B3\u7B56\u201D\u201C\u754C\u9762\u4E0E\u4EA4\u4E92\u201D\u201CDSH \u517C\u5BB9\u201D\uFF1Boverview.title \u4F7F\u7528\u5BF9\u5E94\u5C0F\u8282\u6807\u9898\uFF0Ckind \u8868\u793A\u6BB5\u843D\u5185\u5BB9\u6027\u8D28\uFF0C\u4E0D\u662F\u62C6\u7AE0\u6216\u62C6\u8282\u4F9D\u636E\u3002\u4E0D\u540C\u9879\u76EE\u6216\u4E0D\u76F8\u5173\u9886\u57DF\u4ECD\u5206\u5F00\uFF0C\u4E0D\u80FD\u4E3A\u51CF\u5C11\u7AE0\u6570\u786C\u5408\u5E76\u3002\u6BCF\u6279\u901A\u5E38\u53EA\u65B0\u589E 0-2 \u4E2A\u5927\u7AE0\u8282\uFF1B12 \u662F\u4E92\u4E0D\u76F8\u5173\u9886\u57DF\u7684\u5B89\u5168\u4E0A\u9650\uFF0C\u4E0D\u662F\u521B\u5EFA\u76EE\u6807\u3002
 \u6BCF\u4E2A\u672C\u6279\u4E8B\u4EF6\u5FC5\u987B\u81F3\u5C11\u5206\u914D\u7ED9\u4E00\u4E2A\u7AE0\u8282\uFF1B\u5373\u4F7F\u5C1A\u672A\u8FDB\u5165\u56FE\u8C31\u4E5F\u8981\u4FDD\u7559\u5165\u53E3\u3002\u540C\u4E00\u9879\u76EE\u4E0B\u4E0D\u540C\u4E8B\u4EF6\u3001\u65F6\u95F4\u548C\u51B3\u5B9A\u53EF\u4EE5\u5171\u7528\u7AE0\u8282\uFF0C\u5F52\u7C7B\u4E0D\u7B49\u4E8E\u628A\u4E8B\u5B9E\u5408\u5E76\u6216\u8BA4\u5B9A\u5B83\u4EEC\u76F8\u540C\u3002\u5148\u68C0\u67E5\u6240\u6709 existingTopics \u7684\u8303\u56F4\uFF0C\u80FD\u5BB9\u7EB3\u672C\u6279\u4E8B\u9879\u5C31\u4F18\u5148\u590D\u7528 topicId\uFF0C\u5373\u4F7F\u6807\u9898\u6CA1\u6709\u8BE5\u5B50\u4EFB\u52A1\u5173\u952E\u8BCD\uFF1B\u4E0D\u8981\u4E3A\u5B50\u529F\u80FD\u3001\u7248\u672C\u3001\u4E00\u6B21\u6295\u9012\u6216\u53D1\u5E03\u53E6\u5EFA\u7AE0\u8282\u3002\u540C\u540D\u7AE0\u8282\u53EA\u80FD\u8FD4\u56DE\u4E00\u6B21\u3002\u65B0\u589E\u7AE0\u8282\u7701\u7565 topicId\uFF1B\u65E7\u7AE0\u8282\u672A\u5C55\u793A\u7684\u6210\u5458\u7531\u5B58\u50A8\u5C42\u4FDD\u7559\uFF0C\u4E0D\u8981\u731C\u6D4B\u6216\u8865\u9F50\u5176\u5185\u5BB9\u3002\u6BCF\u4E2A\u7AE0\u8282 sourceEventIds \u53EA\u5199\u5B9E\u9645\u7ED9\u51FA\u7684\u4E8B\u4EF6\u7F16\u53F7\uFF1B\u6BCF\u6BB5\u6765\u6E90\u5FC5\u987B\u5C5E\u4E8E\u8BE5\u7AE0\u8282\u7684 sourceEventIds\u3002candidateTopicsOmitted \u8868\u793A\u53D7\u8F93\u5165\u9884\u7B97\u9650\u5236\u672A\u5C55\u793A\u7684\u5019\u9009\u6570\uFF0C\u4E0D\u80FD\u63A8\u65AD\u88AB\u7701\u7565\u7AE0\u8282\u7684\u5185\u5BB9\u3002
 
 \u5BFC\u822A\u5C42\u7EA7\u662F\u7AE0 \u2192 \u8282 \u2192 Event\u3002Event \u4FDD\u6301\u5177\u4F53\u3001\u72EC\u7ACB\uFF1B\u8282\u5FC5\u987B\u80FD\u6301\u7EED\u5BB9\u7EB3\u540C\u7C7B\u4E8B\u4EF6\u3002\u5355\u4E2A bug\u3001\u7248\u672C\u53F7\u3001\u67D0\u5929\u8FDB\u5C55\u3001\u4E00\u6B21\u5B89\u88C5\u6216\u4E00\u4E2A\u4FEE\u590D\u65B9\u6848\u4E0D\u80FD\u5355\u72EC\u6210\u8282\uFF0C\u4E5F\u4E0D\u8981\u7167\u6284 Event \u6807\u9898\u4F5C\u4E3A\u8282\u6807\u9898\u3002\u4F8B\u5982\u201C0.2.4 \u63D0\u53D6\u6839\u56E0\u66B4\u9732\u8FC7\u7A0B\u201D\u201C0.2.6 \u63D0\u53D6\u4ECD 0 \u4EA7\u51FA\u201D\u201C0.2.7 \u4FEE\u590D\u65B9\u6848\u201D\u201C\u5C01\u5757\u5F02\u5E38\u5F85\u6392\u67E5\u201D\u90FD\u8FDB\u5165\u201C\u7F3A\u9677\u6392\u67E5\u4E0E\u4FEE\u590D\u201D\uFF1B\u201C\u4ECA\u65E5\u7248\u672C\u8FED\u4EE3 0.2.1\u21920.2.7\u201D\u201C0.2.8 \u5B89\u88C5\u4E0E\u9A8C\u8BC1\u201D\u8FDB\u5165\u201C\u7248\u672C\u53D1\u5E03\u4E0E\u5B89\u88C5\u201D\u3002\u5177\u4F53\u7248\u672C\u3001\u65F6\u95F4\u3001\u6839\u56E0\u3001\u5904\u7F6E\u8FC7\u7A0B\u548C\u72B6\u6001\u653E\u5728\u8282\u5185\u6982\u8981\u53CA\u539F Event \u4E2D\u3002\u201C\u8BA1\u5212\u4FEE\u590D\u201D\u201C\u4FEE\u590D\u4E2D\u201D\u201C\u5DF2\u4FEE\u590D\u201D\u5C5E\u4E8E\u540C\u4E00\u7C7B\u522B\u7684\u4E0D\u540C\u72B6\u6001\uFF0C\u4E0D\u53E6\u8D77\u8282\u3002\u540C\u4E00\u7C7B\u522B\u53EF\u4EE5\u6709\u591A\u4E2A\u6709\u6765\u6E90\u7684\u6BB5\u843D\uFF0C\u4E0D\u8981\u4E3A\u6BB5\u843D\u53E6\u8D77\u6807\u9898\u3002
@@ -7449,7 +7733,10 @@ Topic \u662F\u957F\u671F\u7684\u5927\u7AE0\u8282\uFF0C\u6309\u9879\u76EE\u3001\u
 
 title \u662F\u53EF\u8BC6\u522B\u7684\u4E3B\u9898\u540D\u79F0\uFF1Bdescription \u7528\u4E00\u53E5\u8BDD\u8BF4\u660E\u8FD9\u91CC\u5B58\u6709\u54EA\u4E9B\u8D44\u6599\uFF0C\u4F8B\u5982\u201C\u5305\u542B\u90E8\u7F72\u9009\u578B\u3001\u8FC1\u79FB\u7ECF\u8FC7\u548C\u9057\u7559\u95EE\u9898\u201D\uFF0C\u4E0D\u8981\u628A\u5386\u53F2\u7ED3\u8BBA\u5199\u6210\u5F53\u524D\u4E8B\u5B9E\u3002overview \u7684 kind \u4EC5\u5141\u8BB8 scope\uFF08\u80CC\u666F\u6216\u8986\u76D6\u8303\u56F4\uFF09\u3001history\uFF08\u5386\u53F2\u8FDB\u5C55\uFF09\u3001decision\uFF08\u5F53\u65F6\u7684\u51B3\u5B9A\uFF09\u3001change\uFF08\u6709\u4F9D\u636E\u7684\u53D8\u5316\uFF09\u3001open-question\uFF08\u5F85\u786E\u8BA4\u4E8B\u9879\uFF09\u3002\u4FDD\u7559\u660E\u786E\u65F6\u70B9\u3001\u8FC7\u53BB\u5F0F\u3001\u8BA1\u5212\u3001\u53D6\u6D88\u3001\u4E89\u8BAE\u548C\u4E0D\u786E\u5B9A\u6027\uFF1B\u6CA1\u6709\u65B0\u7684\u652F\u6301\u4E0D\u80FD\u628A\u65E7\u4E8B\u5B9E\u5347\u683C\u4E3A\u5F53\u524D\u7ED3\u8BBA\uFF0C\u4E0D\u80FD\u628A\u8BA1\u5212\u5199\u6210\u5DF2\u5B8C\u6210\u3001\u5EFA\u8BAE\u5199\u6210\u5DF2\u51B3\u5B9A\u3001\u63A8\u6D4B\u5199\u6210\u539F\u56E0\u3002\u51B3\u5B9A\u66FE\u7ECF\u6210\u7ACB\u4E0D\u7B49\u4E8E\u73B0\u5728\u4ECD\u6709\u6548\u3002\u76F8\u5173\u4E8B\u4EF6\u77DB\u76FE\u65F6\u4FDD\u7559\u77DB\u76FE\u548C\u5F85\u786E\u8BA4\u72B6\u6001\u3002
 
-outputTokenBudget \u662F\u6574\u4E2A\u54CD\u5E94\u7684\u8F93\u51FA\u9884\u7B97\u3002\u4F18\u5148\u5B8C\u6574\u5206\u914D\u672C\u6279\u6240\u6709\u4E8B\u4EF6\uFF0C\u518D\u5199\u5FC5\u8981\u7684\u7B80\u77ED\u540D\u79F0\u3001\u8303\u56F4\u8BF4\u660E\u548C\u65B0\u589E\u6BB5\u3002\u5B58\u50A8\u5C42\u4F1A\u81EA\u52A8\u7EE7\u627F\u6709\u6548\u65E7\u6982\u8981\uFF0C\u65E0\u9700\u8F93\u51FA\u590D\u8FF0\uFF1B\u901A\u5E38\u53EA\u9700 0-2 \u6BB5\u65B0\u589E\u6982\u8981\uFF0C\u9884\u7B97\u4E0D\u8DB3\u65F6 overview \u53EF\u4E3A\u7A7A\uFF0C\u53EA\u5EFA\u7ACB\u76EE\u5F55\u5165\u53E3\uFF0C\u4E0D\u622A\u65AD JSON \u6216\u9057\u6F0F\u4E8B\u4EF6\u3002
+sections \u72EC\u7ACB\u4FDD\u5B58\u4E8B\u4EF6\u7684\u5C0F\u8282\u5F52\u5C5E\uFF0C\u4E0E overview \u7684\u6765\u6E90\u5F15\u7528\u5206\u5F00\u3002\u6BCF\u4E2A\u5F52\u5165\u672C\u7AE0\u7684\u672C\u6279\u4E8B\u4EF6\u5FC5\u987B\u81F3\u5C11\u5206\u914D\u5230\u4E00\u4E2A sections \u5C0F\u8282\uFF0C\u5373\u4F7F\u603B\u89C8\u6CA1\u6709\u5F15\u7528\u5B83\u3002sections \u53EA\u5199\u672C\u6279\u4E8B\u4EF6\u7F16\u53F7\uFF1B\u65E7\u5F52\u5C5E\u7531\u5B58\u50A8\u5C42\u7EE7\u627F\u3002\u4F18\u5148\u9010\u5B57\u590D\u7528 existingTopics.sectionTitles \u4E2D\u9002\u5408\u7684\u6807\u9898\uFF1B\u5C0F\u8282\u6CBF\u7528\u4E0A\u8FF0\u957F\u671F\u7C7B\u522B\u89C4\u5219\u3002\u65B0 overview \u7684\u5C55\u793A\u6807\u9898\u5FC5\u987B\u5339\u914D\u672C\u8F6E sections.title \u6216\u91CD\u5206\u7C7B\u540E\u4ECD\u5B58\u5728\u7684\u5DF2\u6709\u5C0F\u8282\u6807\u9898\uFF0C\u4E0D\u80FD\u9760\u603B\u89C8\u5355\u72EC\u521B\u5EFA\u5C0F\u8282\uFF1B\u7701\u7565 title \u65F6\uFF0C\u5176 kind \u7684\u9ED8\u8BA4\u5C55\u793A\u6807\u9898\u4E5F\u5FC5\u987B\u6709\u5BF9\u5E94\u7684\u6700\u7EC8\u5C0F\u8282\u3002\u82E5\u91CD\u5206\u7C7B\u79FB\u8D70\u65E7\u5C0F\u8282\u7684\u5168\u90E8\u4E8B\u4EF6\uFF0C\u5B58\u50A8\u5C42\u4E22\u5F03\u8BE5\u8282\u7684\u65E7\u603B\u89C8\uFF0C\u5373\u4F7F\u672C\u8F6E\u539F\u6837\u56DE\u4F20\u4E5F\u4E0D\u4F1A\u4FDD\u7559\u3002overview.title \u53EA\u51B3\u5B9A\u6982\u62EC\u6587\u5B57\u663E\u793A\u5728\u54EA\u4E2A\u5C0F\u8282\uFF0C\u4E0D\u51B3\u5B9A\u4E8B\u4EF6\u5F52\u5C5E\uFF1B\u65E0\u9700\u4E3A\u6BCF\u6761\u4E8B\u4EF6\u5199\u603B\u89C8\uFF0C\u4E5F\u4E0D\u8981\u4E3A\u4E86\u8986\u76D6\u76EE\u5F55\u800C\u865A\u589E\u6765\u6E90\u5F15\u7528\u3002
+\u82E5\u8F93\u5165\u542B sectionBackfillTopicId\uFF0C\u8FD9\u662F\u5347\u7EA7\u540E\u7684\u65E7\u4E8B\u4EF6\u8865\u5F52\u7C7B\uFF1A\u53EA\u8FD4\u56DE\u8BE5 topicId \u7684\u4E00\u4E2A\u7AE0\u8282\uFF0C\u4FDD\u7559\u539F\u7AE0\u540D\u548C\u63CF\u8FF0\uFF0C\u4E3A\u5168\u90E8\u672C\u6279\u4E8B\u4EF6\u5199\u5165\u9002\u5F53\u7684\u5C0F\u8282\uFF1B\u4E0D\u5F97\u6362\u7AE0\u6216\u65B0\u5EFA\u7AE0\u3002\u5DF2\u6709\u5C0F\u8282\u6807\u9898\u53EF\u80FD\u53EA\u5C55\u793A\u524D 120 \u4E2A\uFF0C\u4F18\u5148\u590D\u7528\u9002\u5408\u7684\u5DF2\u6709\u6807\u9898\u3002\u6B64\u4EFB\u52A1\u65E0\u9700\u91CD\u5199\u603B\u89C8\uFF0Coverview \u53EF\u4EE5\u4E3A\u7A7A\uFF0C\u5B58\u50A8\u5C42\u4FDD\u7559\u6709\u6548\u65E7\u603B\u89C8\u3002
+
+outputTokenBudget \u662F\u6574\u4E2A\u54CD\u5E94\u7684\u8F93\u51FA\u9884\u7B97\u3002\u4F18\u5148\u5B8C\u6574\u5206\u914D\u672C\u6279\u6240\u6709\u4E8B\u4EF6\u5230\u7AE0\u8282\u548C\u5C0F\u8282\uFF0C\u518D\u5199\u5FC5\u8981\u7684\u7B80\u77ED\u540D\u79F0\u3001\u8303\u56F4\u8BF4\u660E\u548C\u65B0\u589E\u6BB5\u3002\u5B58\u50A8\u5C42\u4F1A\u5728\u6700\u7EC8\u5C0F\u8282\u4ECD\u5B58\u5728\u65F6\u81EA\u52A8\u7EE7\u627F\u6709\u6548\u65E7\u6982\u8981\uFF0C\u65E0\u9700\u8F93\u51FA\u590D\u8FF0\uFF1B\u901A\u5E38\u53EA\u9700 0-2 \u6BB5\u65B0\u589E\u6982\u8981\uFF0C\u9884\u7B97\u4E0D\u8DB3\u65F6 overview \u53EF\u4E3A\u7A7A\uFF0Csections \u4ECD\u5FC5\u987B\u5B8C\u6574\u5F52\u7C7B\u672C\u6279\u4E8B\u4EF6\uFF0C\u4E0D\u622A\u65AD JSON \u6216\u9057\u6F0F\u4E8B\u4EF6\u3002
 \u6BCF\u6279\u6700\u591A 12 \u4E2A\u4E3B\u9898\uFF1Btitle \u6700\u591A 120 \u4E2A\u5B57\u7B26\uFF0Cdescription \u6700\u591A 400 \u4E2A\u5B57\u7B26\uFF0C\u4F46\u5C3D\u91CF\u7528\u77ED\u540D\u79F0\u548C\u4E00\u53E5\u8303\u56F4\u8BF4\u660E\uFF1B\u6BCF\u4E2A\u4E3B\u9898\u5728\u672C\u6B21\u54CD\u5E94\u6700\u591A 8 \u6BB5\u6982\u8981\uFF1B\u8FD9\u4E0D\u662F\u7D2F\u8BA1\u7AE0\u8282\u7684\u6BB5\u6570\u6216\u8282\u6570\u4E0A\u9650\uFF0C\u6709\u6548\u65E7\u6BB5\u7531\u5B58\u50A8\u5C42\u4FDD\u7559\u3002\u6BCF\u6BB5\u6700\u591A 600 \u4E2A\u5B57\u7B26\u300112 \u4E2A\u6765\u6E90\u3002\u4E0D\u8981\u91CD\u590D\u6807\u9898\u3001\u76EE\u5F55\u8BF4\u660E\u3001\u5DF2\u6709\u6982\u8981\u6216\u65E0\u5173\u80CC\u666F\u3002\u4E0D\u8981\u751F\u6210\u7ECF\u9A8C\u5C42\u6216\u53E6\u5199\u65B0\u7684\u4E8B\u4EF6\u3002`;
 var MAX_TOPIC_INPUT_TOKENS = 2e4;
 var EXTERNAL_MEMORY_DECIDER_PARAMETERS = {
@@ -7594,6 +7881,9 @@ function topicProjectionPayload(context, outputTokenBudget) {
   if (new Set(context.existingTopics.map(({ id }) => id)).size !== context.existingTopics.length) {
     throw new Error("Topic projection input contains duplicate candidate topic ids");
   }
+  if (context.sectionBackfillTopicId && !context.existingTopics.some(({ id }) => id === context.sectionBackfillTopicId)) {
+    throw new Error("Topic section backfill input must include its existing chapter");
+  }
   const events = context.events.map((event) => ({
     id: event.id,
     title: event.title,
@@ -7608,6 +7898,7 @@ function topicProjectionPayload(context, outputTokenBudget) {
   for (; ; ) {
     const payload = {
       jobId: context.jobId,
+      ...context.sectionBackfillTopicId ? { sectionBackfillTopicId: context.sectionBackfillTopicId } : {},
       evidenceCompleteness: "bounded-navigation-cards; retrieve Event and original-source evidence before relying on factual content",
       outputTokenBudget,
       events,
@@ -7619,7 +7910,8 @@ function topicProjectionPayload(context, outputTokenBudget) {
         overview: topic.overview,
         ...topic.sectionTitles ? { sectionTitles: topic.sectionTitles } : {},
         sourceEventIds: topic.sourceEventIds,
-        totalSourceEvents: topic.totalSourceEvents
+        totalSourceEvents: topic.totalSourceEvents,
+        ...topic.sectionTitlesOmitted ? { sectionTitlesOmitted: topic.sectionTitlesOmitted } : {}
       })),
       candidateTopicsOmitted: context.existingTopics.length - existingTopics.length
     };
@@ -7627,13 +7919,13 @@ function topicProjectionPayload(context, outputTokenBudget) {
 
 ${JSON_RETRY_INSTRUCTION}`, tool: toolSchema("topicProjector"), payload }));
     if (inputTokens <= MAX_TOPIC_INPUT_TOKENS) return { payload, shownContext: { ...context, existingTopics } };
-    if (existingTopics.length > 0) existingTopics.pop();
+    if (existingTopics.length > 0 && existingTopics.at(-1).id !== context.sectionBackfillTopicId) existingTopics.pop();
     else throw new Error(`Topic projection input exceeds ${MAX_TOPIC_INPUT_TOKENS} estimated tokens; split the Event batch instead of truncating evidence`);
   }
 }
 function parseTopicProjection(value, context) {
   const fail = (message) => {
-    throw new Error(`Topic projection validation failed: ${message}`);
+    throw new TopicProjectionError("validation-failed", message);
   };
   const raw = object(value);
   if (Object.keys(raw).some((key) => key !== "topics") || !Array.isArray(raw.topics) || raw.topics.length > 12) {
@@ -7655,14 +7947,18 @@ function parseTopicProjection(value, context) {
     }
     return value2;
   };
-  const topics = raw.topics.map((candidate) => {
+  const rawTopics = raw.topics;
+  const topics = rawTopics.map((candidate) => {
     const item = object(candidate);
     const title = boundedText(item.title, "topic.title", 120);
     const label = title.normalize("NFKC").replace(/\s+/g, " ").toLowerCase();
     if (usedLabels.has(label)) fail("duplicate chapter label; combine its batch assignments");
     usedLabels.add(label);
-    if (Object.keys(item).some((key) => !["topicId", "title", "description", "sourceEventIds", "overview"].includes(key))) fail("unexpected topic field");
+    if (Object.keys(item).some((key) => !["topicId", "title", "description", "sourceEventIds", "overview", "sections"].includes(key))) fail("unexpected topic field");
     const topicId = item.topicId === void 0 ? void 0 : boundedText(item.topicId, "topicId", 200);
+    if (context.sectionBackfillTopicId && (rawTopics.length !== 1 || topicId !== context.sectionBackfillTopicId)) {
+      fail("section backfill must update only its existing chapter");
+    }
     if (topicId !== void 0 && (!candidates.has(topicId) || usedTopicIds.has(topicId))) fail("unknown or repeated topicId");
     if (topicId !== void 0) usedTopicIds.add(topicId);
     const existing = topicId === void 0 ? void 0 : candidates.get(topicId);
@@ -7670,7 +7966,24 @@ function parseTopicProjection(value, context) {
     const sources2 = sourceIds(item.sourceEventIds, "topic.sourceEventIds", allowedIds);
     if (!sources2.some((id) => eventIds.has(id))) fail("every returned topic must cover a supplied batch Event");
     for (const id of sources2) if (eventIds.has(id)) covered.add(id);
+    if (!Array.isArray(item.sections) || item.sections.length === 0) fail("sections must assign batch Events independently of overview");
+    const sectionLabels = /* @__PURE__ */ new Set();
+    const sections = item.sections.map((candidateSection) => {
+      const section = object(candidateSection);
+      if (Object.keys(section).some((key2) => !["title", "sourceEventIds"].includes(key2))) fail("unexpected section field");
+      const title2 = boundedText(section.title, "section.title", 80);
+      const key = title2.normalize("NFKC").replace(/\s+/g, " ").toLowerCase();
+      if (sectionLabels.has(key)) fail("duplicate section title");
+      sectionLabels.add(key);
+      return { title: title2, sourceEventIds: sourceIds(section.sourceEventIds, "section.sourceEventIds", new Set(sources2.filter((id) => eventIds.has(id)))) };
+    });
+    const assigned = new Set(sections.flatMap((section) => section.sourceEventIds));
+    if (sources2.some((id) => eventIds.has(id) && !assigned.has(id))) fail("every topic batch Event must be assigned to a section");
     if (!Array.isArray(item.overview) || item.overview.length > 8) fail("overview must contain 0-8 source-grounded entries");
+    const overviewTitles = [
+      ...sections.map((section) => section.title),
+      ...existing?.sectionTitles ?? memoryTopicMembershipSections(existing ?? { overview: [] }).map((section) => section.title)
+    ];
     const overview2 = item.overview.map((candidateEntry) => {
       const entry = object(candidateEntry);
       if (Object.keys(entry).some((key) => !["kind", "title", "text", "sourceEventIds"].includes(key))) fail("unexpected overview field");
@@ -7679,22 +7992,27 @@ function parseTopicProjection(value, context) {
       const paragraph = boundedText(entry.text, "overview.text", 600);
       const paragraphSources = sourceIds(entry.sourceEventIds, "overview.sourceEventIds", new Set(sources2), 12);
       if (entry.kind !== "scope" && paragraphSources.some((id) => truncatedIds.has(id))) fail("truncated Event evidence may only support scope entries");
-      if (paragraphSources.some((id) => !eventIds.has(id)) && !existing?.overview.some((old) => old.kind === entry.kind && old.title === sectionTitle && old.text === paragraph && old.sourceEventIds.length === paragraphSources.length && old.sourceEventIds.every((id) => paragraphSources.includes(id)))) {
+      const preserved = existing?.overview.some((old) => old.kind === entry.kind && old.title === sectionTitle && old.text === paragraph && old.sourceEventIds.length === paragraphSources.length && old.sourceEventIds.every((id) => paragraphSources.includes(id)));
+      if (paragraphSources.some((id) => !eventIds.has(id)) && !preserved) {
         fail("old overview evidence may only be preserved verbatim; rewritten entries must cite batch Events only");
       }
-      return { kind: entry.kind, ...sectionTitle === void 0 ? {} : { title: sectionTitle }, text: paragraph, sourceEventIds: paragraphSources };
+      const part = { kind: entry.kind, ...sectionTitle === void 0 ? {} : { title: sectionTitle }, text: paragraph, sourceEventIds: paragraphSources };
+      if (!preserved && !memoryTopicOverviewMatchesSection(part, overviewTitles)) fail("new overview must match a declared or inherited section");
+      return part;
     });
     return {
       ...topicId === void 0 ? {} : { topicId },
       title,
       description: boundedText(item.description, "topic.description", 400),
       sourceEventIds: sources2,
+      sections,
       overview: overview2
     };
   });
   if ([...eventIds].some((id) => !covered.has(id))) fail("every supplied batch Event must be assigned to a topic");
   return { topics };
 }
+var TOPIC_OUTPUT_TOKEN_BUDGET = 32768;
 var DshModelBridge = class {
   constructor(ctx, config, liveStructuredReasoningEffort) {
     this.ctx = ctx;
@@ -7703,12 +8021,14 @@ var DshModelBridge = class {
     this.structuredReasoningEffort = config.structuredReasoningEffort ?? "auto";
     this.ctx.on?.("llm/adapters-updated", () => {
       this.offCapabilities.clear();
+      this.contextWindows.clear();
       for (const listener of this.adaptersUpdatedListeners) listener();
     });
   }
   ctx;
   config;
   liveStructuredReasoningEffort;
+  contextWindows = /* @__PURE__ */ new Map();
   sessions = new AsyncLocalStorage();
   successfulResponses = [];
   offCapabilities = /* @__PURE__ */ new Map();
@@ -7938,7 +8258,7 @@ Use project scope for repository decisions, user scope for stable preferences/id
     return { reason: text2(raw.reason, "Projected Event evidence into the Knowledge Graph."), nodes, edges };
   };
   topicProjector = async (context) => {
-    const { payload, shownContext } = topicProjectionPayload(context, this.config.maxOutputTokens);
+    const { payload, shownContext } = topicProjectionPayload(context, TOPIC_OUTPUT_TOKEN_BUDGET);
     try {
       const raw = await this.callStructured(
         "topicProjector",
@@ -7946,13 +8266,16 @@ Use project scope for repository decisions, user scope for stable preferences/id
         payload,
         (value) => {
           parseTopicProjection(value, shownContext);
-        }
+        },
+        { eventCount: shownContext.events.length, candidateTopicCount: shownContext.existingTopics.length }
       );
       return parseTopicProjection(raw, shownContext);
     } catch (error) {
-      if (error instanceof ModelJsonResponseError) throw new Error(error.message.split("\nRaw response preview")[0]);
-      if (error instanceof Error && /^StrataGate structured model task timed out after \d+ms$/.test(error.message)) throw new Error(error.message);
-      throw new Error("Topic projection model call failed (provider or route error); raw details omitted from diagnostics");
+      if (error instanceof TopicProjectionError) throw error;
+      if (error instanceof Error && /^StrataGate structured model task timed out after \d+ms$/.test(error.message)) {
+        throw new TopicProjectionError("timeout", "structured model task timed out");
+      }
+      throw new TopicProjectionError("provider-failed", "provider or route error");
     }
   };
   externalMemoryDecider = async (context) => {
@@ -8004,17 +8327,25 @@ Use project scope for repository decisions, user scope for stable preferences/id
     }
     return proposed;
   }
-  async callStructured(kind, system, payload, validate) {
+  async callStructured(kind, system, payload, validate, topicMetadata) {
     const execution = this.sessions.getStore();
     if (!execution) throw new Error("StrataGate model callback ran without an execution context");
     const baseRoute = this.resolveRoute(execution.session);
     const routeKey = `${baseRoute.provider}\0${baseRoute.model}`;
     let useOff = await this.shouldUseOff(baseRoute);
+    const isTopic = kind === "topicProjector";
+    const topicDiagnostics = {
+      ...topicMetadata,
+      requestedOutputTokens: TOPIC_OUTPUT_TOKEN_BUDGET,
+      modelCalls: 0
+    };
+    const topicError = (category, reason) => new TopicProjectionError(category, reason, topicDiagnostics);
     let lastError;
     let lastResponse = "";
     let attemptsUsed = 0;
     let noAdapterRetried = false;
     let graphRetryFeedback = "";
+    let offFallback = false;
     for (let attempt = 1; attempt <= JSON_RESPONSE_ATTEMPTS; attempt += 1) {
       attemptsUsed = attempt;
       const message = createUserMessage({
@@ -8038,10 +8369,33 @@ ${JSON_RETRY_INSTRUCTION}${graphRetryFeedback}`,
           type: "function",
           function: { name: STRUCTURED_TOOLS[kind].name }
         },
-        maxTokens: kind === "profileMaintenance" ? Math.max(this.config.maxOutputTokens, Math.min(12e3, 512 + 2 * Array.from(JSON.stringify(payload)).length)) : this.config.maxOutputTokens,
+        maxTokens: kind === "profileMaintenance" ? Math.max(this.config.maxOutputTokens, Math.min(12e3, 512 + 2 * Array.from(JSON.stringify(payload)).length)) : isTopic ? TOPIC_OUTPUT_TOKEN_BUDGET : this.config.maxOutputTokens,
         sessionId: execution.sessionId,
         purpose: "compaction"
       };
+      if (isTopic) {
+        const estimateInput = () => estimateTokens(JSON.stringify({ system: request.system, tools: request.tools, messages: request.messages }));
+        let inputTokens = estimateInput();
+        const window = this.contextWindows.get(routeKey);
+        if (window !== void 0 && window - inputTokens - 1024 < 256) {
+          Object.assign(topicDiagnostics, { estimatedInputTokens: inputTokens, maxOutputTokens: 0 });
+          throw topicError("validation-failed", "topic input exceeds model context capacity");
+        }
+        if (window !== void 0) request.maxTokens = Math.min(TOPIC_OUTPUT_TOKEN_BUDGET, Math.floor(window - inputTokens - 1024));
+        request.messages = [{ ...message, content: [{ type: "text", text: JSON.stringify({
+          ...payload,
+          outputTokenBudget: request.maxTokens
+        }) }] }];
+        inputTokens = estimateInput();
+        delete topicDiagnostics.finishReason;
+        delete topicDiagnostics.reasoningObserved;
+        Object.assign(topicDiagnostics, {
+          estimatedInputTokens: inputTokens,
+          maxOutputTokens: request.maxTokens,
+          modelCalls: (topicDiagnostics.modelCalls ?? 0) + 1,
+          reasoningOff: useOff ? "requested-unverified" : offFallback ? "fallback" : "unavailable"
+        });
+      }
       try {
         await this.consumeStructuredStream(request, assembler);
       } catch (error) {
@@ -8053,13 +8407,19 @@ ${JSON_RETRY_INSTRUCTION}${graphRetryFeedback}`,
         if (useOff && isOffRejection(error)) {
           this.offCapabilities.set(routeKey, "unsupported");
           useOff = false;
+          offFallback = true;
           this.warnOffFallbackOnce(routeKey, `${baseRoute.provider}/${baseRoute.model} rejected reasoningEffort=off; retrying once without it`);
           attempt -= 1;
           continue;
         }
+        if (isTopic) {
+          const timedOut = error instanceof Error && /^StrataGate structured model task timed out after \d+ms$/.test(error.message);
+          throw topicError(timedOut ? "timeout" : "provider-failed", timedOut ? "structured model task timed out" : "provider or route error");
+        }
         throw error;
       }
       const finish = assembler.finish;
+      if (isTopic) topicDiagnostics.finishReason = finish.kind;
       if (finish.kind === "error" || finish.kind === "aborted") {
         const failure = new Error(`StrataGate model call failed [${finish.failure.code}]: ${finish.failure.message}`);
         if (!noAdapterRetried && isNoAdapter(finish.failure)) {
@@ -8070,26 +8430,34 @@ ${JSON_RETRY_INSTRUCTION}${graphRetryFeedback}`,
         if (useOff && isOffRejection(finish.failure)) {
           this.offCapabilities.set(routeKey, "unsupported");
           useOff = false;
+          offFallback = true;
           this.warnOffFallbackOnce(routeKey, `${baseRoute.provider}/${baseRoute.model} rejected reasoningEffort=off; retrying once without it`);
           attempt -= 1;
           continue;
         }
+        if (isTopic) throw topicError("provider-failed", "provider or route error");
         throw failure;
       }
       if (useOff) this.offCapabilities.set(routeKey, "supported");
       const blocks = assembler.blocks();
       const calls = blocks.filter((block) => block.type === "tool-call");
-      const responseForError = `${renderBlocksForDiagnostics(blocks, finish.kind)}
+      if (isTopic) {
+        topicDiagnostics.reasoningObserved = blocks.some((block) => block.type === "reasoning" && block.text.trim().length > 0);
+        if (topicDiagnostics.reasoningObserved && useOff) topicDiagnostics.reasoningOff = "reasoning-observed";
+        if (finish.kind === "max-tokens") throw topicError("max-tokens", "output token limit reached");
+      }
+      const responseForError = isTopic ? "" : `${renderBlocksForDiagnostics(blocks, finish.kind)}
 [finish=${finish.kind}; toolCalls=${calls.length}]`;
       lastResponse = responseForError;
       try {
         const expectedTool = STRUCTURED_TOOLS[kind].name;
         let parsed;
         if (calls.length !== 1 || calls[0]?.name !== expectedTool) {
-          const textFallback = blocks.filter((block) => block.type === "text" || block.type === "reasoning").map((block) => block.text).join("\n");
+          const textFallback = blocks.filter((block) => block.type === "text" || !isTopic && block.type === "reasoning").map((block) => block.text).join("\n");
           try {
             parsed = parseJsonResponse(textFallback, STRUCTURED_FIELDS[kind]);
           } catch {
+            if (isTopic) throw topicError("schema-invalid", "expected exactly one structured topic call");
             throw new ModelJsonResponseError(
               `StrataGate model response did not call ${expectedTool} exactly once`,
               { response: responseForError }
@@ -8099,6 +8467,7 @@ ${JSON_RETRY_INSTRUCTION}${graphRetryFeedback}`,
           try {
             parsed = JSON.parse(calls[0].arguments);
           } catch {
+            if (isTopic) throw topicError("schema-invalid", "tool arguments are not valid JSON");
             throw new ModelJsonResponseError(
               `StrataGate ${expectedTool} arguments were not valid JSON`,
               { response: responseForError }
@@ -8108,13 +8477,14 @@ ${JSON_RETRY_INSTRUCTION}${graphRetryFeedback}`,
         if (kind === "graphProjector") parsed = normalizeGraphNameProvenance(parsed);
         const violations = validateArgs(STRUCTURED_TOOLS[kind].parameters, parsed);
         if (violations.length > 0) {
+          if (isTopic) throw topicError("schema-invalid", "structured topic schema mismatch");
           if (kind === "graphProjector") {
             const paths = violations.flatMap((violation) => violation.match(/nodes\[\d+\]\.metadataProvenance\.name(?:\[\d+\])?/g) ?? []);
             graphRetryFeedback = paths.length > 0 ? `
 Correct these canonical-name provenance fields: ${[...new Set(paths)].slice(0, 24).join(", ")}. metadataProvenance.name must be an array of supplied Event ID strings, e.g. ["evt_x"], supporting the actual node.name. Only aliases/tags use { value, sourceEventIds } objects. Do not substitute provenance for a different name.` : "";
           }
           throw new ModelJsonResponseError(
-            `StrataGate ${expectedTool} arguments were invalid: ${kind === "topicProjector" ? "structured topic schema mismatch" : violations.join("; ")}`,
+            `StrataGate ${expectedTool} arguments were invalid: ${violations.join("; ")}`,
             { response: responseForError }
           );
         }
@@ -8130,6 +8500,7 @@ Correct these canonical-name provenance fields: ${[...new Set(paths)].slice(0, 2
         try {
           validate?.(parsed);
         } catch (error) {
+          if (isTopic) throw topicError("validation-failed", error instanceof TopicProjectionError ? error.diagnostics.reason : "topic semantic validation failed");
           throw new ModelJsonResponseError(
             `StrataGate ${expectedTool} arguments were invalid: ${error instanceof Error ? error.message : String(error)}`,
             { cause: error, response: responseForError }
@@ -8146,7 +8517,7 @@ Correct these canonical-name provenance fields: ${[...new Set(paths)].slice(0, 2
         }
         return parsed;
       } catch (error) {
-        if (!(error instanceof ModelJsonResponseError)) throw error;
+        if (!(error instanceof ModelJsonResponseError) && !(isTopic && error instanceof TopicProjectionError)) throw error;
         lastError = finish.kind === "max-tokens" ? new ModelJsonResponseError(
           `StrataGate ${STRUCTURED_TOOLS[kind].name} call was truncated before valid arguments`,
           { cause: error, response: responseForError }
@@ -8157,6 +8528,7 @@ Correct these canonical-name provenance fields: ${[...new Set(paths)].slice(0, 2
         }
       }
     }
+    if (isTopic && lastError instanceof TopicProjectionError) throw lastError;
     const validationDetail = lastError?.message ? `: ${lastError.message}` : "";
     throw new ModelJsonResponseError(
       `StrataGate model did not produce a valid ${STRUCTURED_TOOLS[kind].name} call after ${attemptsUsed} attempt${attemptsUsed === 1 ? "" : "s"}${validationDetail}`,
@@ -8193,6 +8565,7 @@ Correct these canonical-name provenance fields: ${[...new Set(paths)].slice(0, 2
           timer.unref?.();
         })
       ]);
+      if (Number.isFinite(info.context?.contextWindow) && info.context.contextWindow > 0) this.contextWindows.set(key, info.context.contextWindow);
       if (!info.reasoning) return this.currentStructuredReasoningEffort() === "force-off";
       const supported = info.reasoning.efforts.some(({ id }) => String(id) === "off");
       this.offCapabilities.set(key, supported ? "supported" : "unsupported");
@@ -8562,6 +8935,12 @@ function memoryTopicSections(topic) {
     if (!memberPositions.has(id)) memberPositions.set(id, index);
   });
   const sections = /* @__PURE__ */ new Map();
+  for (const membership of memoryTopicMembershipSections(topic)) {
+    const key = memoryTopicSectionKey(membership.title);
+    const section = sections.get(key) ?? { key, title: membership.title, paragraphs: [], sourceEventIds: [] };
+    section.sourceEventIds.push(...membership.sourceEventIds.filter((id) => memberPositions.has(id)));
+    sections.set(key, section);
+  }
   for (const part of topic.overview) {
     const title = memoryTopicSectionTitle(part);
     const identity = memoryTopicSectionKey(title);
@@ -8571,7 +8950,6 @@ function memoryTopicSections(topic) {
       sections.set(identity, section);
     }
     section.paragraphs.push(part);
-    for (const id of part.sourceEventIds) if (memberPositions.has(id)) section.sourceEventIds.push(id);
   }
   return [...sections.values()].map((section) => ({
     section: {
@@ -8639,11 +9017,11 @@ function topicNavigation(topics, events) {
     coverage: topic.coverage,
     isFallback: topic.isFallback === true
   }));
-  const categories = CATEGORIES.map((category) => ({
+  const categories2 = CATEGORIES.map((category) => ({
     ...category,
     count: entries.filter((entry) => entry.category === category.id).length
   })).filter(({ count }) => count > 0);
-  return { entries, categories };
+  return { entries, categories: categories2 };
 }
 function topicPage(topics, events, options = {}) {
   const navigation = topicNavigation(topics, events);
@@ -8667,18 +9045,18 @@ function lineText(value, maximum) {
   return value.replace(/\s+/g, " ").trim().slice(0, maximum);
 }
 function renderMemoryDirectory(topics, events) {
-  const { entries, categories } = topicNavigation(topics, events);
+  const { entries, categories: categories2 } = topicNavigation(topics, events);
   if (entries.length === 0) return "";
   const header = "[StrataGate \u8BB0\u5FC6\u76EE\u5F55]\n\u4EC5\u4F9B\u5BFC\u822A\uFF0C\u6982\u89C8\u4E0D\u662F\u4E8B\u5B9E\u8BC1\u636E\u3002\u9700\u8981\u4E3B\u9898\u8109\u7EDC\u65F6\u7528 memory_expand_topic\uFF1B\u9700\u8981\u4E8B\u5B9E\u8BC1\u636E\u53EF\u76F4\u63A5 memory_search_events(topic_id)\uFF0C\u4E5F\u53EF\u76F4\u63A5\u641C\u7D22\u4E8B\u4EF6/\u56FE\u8C31\u3002";
   const lines = entries.map((entry) => `- ${entry.id}\uFF1A${lineText(entry.title, 64)}${entry.description ? `\uFF1B${lineText(entry.description, 48)}` : ""}`);
   const complete = `${header}
 ${lines.join("\n")}`;
   if (estimateTokens(complete) <= MEMORY_DIRECTORY_TOKEN_BUDGET) return complete;
-  const branches = categories.map(({ id, label, count }) => `${id}\uFF08${label} ${count}\uFF09`).join("\uFF1B");
+  const branches = categories2.map(({ id, label, count }) => `${id}\uFF08${label} ${count}\uFF09`).join("\uFF1B");
   const navigation = `${header}
 \u5171 ${entries.length} \u9879\uFF1B\u5206\u7C7B\uFF1A${branches}\u3002\u5B8C\u6574\u76EE\u5F55\u7528 memory_list_topics(category, offset) \u5206\u9875\uFF1Bquery \u53EF\u67E5\u4E3B\u9898\u3002\u4E0B\u5217\u4E3A\u90E8\u5206\u5165\u53E3\uFF1A`;
   const selected = [];
-  for (const category of categories) {
+  for (const category of categories2) {
     const entry = entries.find((item) => item.category === category.id);
     const line = `- ${entry.id}\uFF1A${lineText(entry.title, 40)}`;
     if (estimateTokens(`${navigation}
@@ -8690,16 +9068,26 @@ ${[...selected.map(({ line: line2 }) => line2), line].join("\n")}`) <= MEMORY_DI
 ${selected.map(({ line }) => line).join("\n")}`.trim();
 }
 function boundedTopic(topic, envelope = {}) {
+  const { sections: _sections, ...summaryTopic } = topic;
+  const sectionIndex = memoryTopicSections(topic).map(({ title, sourceEventIds: sourceEventIds2 }) => ({ title, sourceEventCount: sourceEventIds2.length }));
+  const sections = [];
   const overview2 = [];
   const sourceEventIds = topic.sourceEventIds.slice(0, 12);
-  const result = (parts) => ({
-    ...topic,
+  const result = (parts, selectedSections = sections) => ({
+    ...summaryTopic,
     sourceEventIds,
     overview: parts,
+    sections: selectedSections,
+    totalSections: sectionIndex.length,
+    omittedSections: sectionIndex.length - selectedSections.length,
     totalSourceEvents: topic.sourceEventIds.length,
     omittedSourceEvents: topic.sourceEventIds.length - sourceEventIds.length,
     omittedOverviewParagraphs: topic.overview.length - parts.length
   });
+  for (const section of sectionIndex) {
+    if (estimateTokens(JSON.stringify({ ...envelope, topic: result(overview2, [...sections, section]) })) > TOPIC_OVERVIEW_TOKEN_BUDGET) break;
+    sections.push(section);
+  }
   for (const paragraph of topic.overview) {
     if (estimateTokens(JSON.stringify({ ...envelope, topic: result([...overview2, paragraph]) })) <= TOPIC_OVERVIEW_TOKEN_BUDGET) overview2.push(paragraph);
   }
@@ -10306,6 +10694,7 @@ var StrataGateRuntime = class {
     const jobId = id.trim();
     if (!key) throw new TypeError("StrataGate admin namespace must not be empty");
     if (!jobId) throw new TypeError("StrataGate job id must not be empty");
+    if (kind === "topic-projection") return this.adminRetryTopicProjection(key, jobId);
     const retryKey = `${key}\0${kind}\0${jobId}`;
     const existing = this.adminJobRetryRuns.get(retryKey);
     if (existing) return existing;
@@ -11496,7 +11885,7 @@ function currentPluginVersion() {
   return "unknown";
 }
 var STRATAGATE_DSH_VERSION = currentPluginVersion();
-var TOPIC_DIRECTORY_VIEW_VERSION = 4;
+var TOPIC_DIRECTORY_VIEW_VERSION = 5;
 function graphProjectionIsProcessing(job) {
   return derivationJobState(job, false) === "processing" || derivationJobState(job, false) === "retryable";
 }
@@ -11802,26 +12191,44 @@ function topicDirectoryProjection(snapshot, agentMemoryWeight) {
   const pending = visibleEvents.filter(({ id }) => pendingIds.has(id)).sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id));
   const versions = new Map(visibleEvents.map((event) => [event.id, memoryTopicEventFingerprint(event)]));
   const frozen = state.bootstrap?.projectorVersion === MEMORY_TOPIC_PROJECTOR_VERSION ? state.bootstrap : null;
+  const relationKey = (topicId, id, version) => JSON.stringify([topicId ?? null, id, version]);
+  const backfillRelations = Object.entries(state.sectionBackfill ?? {}).flatMap(([topicId, pending2]) => Object.entries(pending2).filter(([id, version]) => versions.get(id) === version).map(([id, version]) => ({ topicId, id, version })));
   const budgetedVersions = { ...frozen?.sourceVersions ?? {}, ...state.rebuildVersions };
   const history = frozen ? Object.entries(budgetedVersions).filter(([id, version]) => versions.get(id) === version) : [];
-  const outstanding = new Set(history.filter(([id, version]) => state.projectedVersions[id] !== version).map(([id]) => id));
+  const ordinaryOutstanding = history.filter(([id, version]) => state.projectedVersions[id] !== version);
+  const outstanding = /* @__PURE__ */ new Set([...ordinaryOutstanding.map(([id]) => id), ...backfillRelations.map(({ id }) => id)]);
+  const outstandingWork = /* @__PURE__ */ new Set([
+    ...ordinaryOutstanding.map(([id, version]) => relationKey(void 0, id, version)),
+    ...backfillRelations.map(({ topicId, id, version }) => relationKey(topicId, id, version))
+  ]);
+  const failedWork = /* @__PURE__ */ new Set();
   const failures = state.jobs.flatMap((job) => {
     if (job.superseded || job.projectorVersion !== MEMORY_TOPIC_PROJECTOR_VERSION || job.status !== "failed" || job.attempts < TOPIC_MAX_ATTEMPTS || !Object.entries({ ...job.sourceVersions, ...job.dependencyVersions }).every(([id, version]) => versions.get(id) === version)) return [];
-    const ids = job.sourceEventIds.filter((id) => outstanding.has(id) && budgetedVersions[id] === job.sourceVersions[id]);
+    const diagnostics = safeTopicDiagnostics(job.diagnostics);
+    const ids = job.sourceEventIds.filter((id) => {
+      const key = relationKey(job.sectionBackfillTopicId, id, job.sourceVersions[id]);
+      if (!outstandingWork.has(key)) return false;
+      failedWork.add(key);
+      return true;
+    });
     return ids.length > 0 ? [{
       jobId: job.id,
       eventIds: ids,
       attempts: job.attempts,
       // Topic failures store reason codes, never raw model output.
-      lastError: ["timeout", "source-changed", "invalid-output", "worker-failed"].includes(job.lastError ?? "") ? job.lastError : "worker-failed",
+      diagnostics,
+      lastError: diagnostics ? `${diagnostics.category}: ${diagnostics.reason}` : ["timeout", "source-changed", "invalid-output", "worker-failed"].includes(job.lastError ?? "") ? job.lastError : "worker-failed",
       updatedAt: job.updatedAt
     }] : [];
   });
+  const total = (/* @__PURE__ */ new Set([...history.map(([id]) => id), ...backfillRelations.map(({ id }) => id)])).size;
+  const failedRelations = backfillRelations.filter(({ topicId, id, version }) => failedWork.has(relationKey(topicId, id, version))).length;
   const bootstrap = frozen ? {
-    status: Object.keys(state.rebuildVersions ?? {}).length > 0 ? outstanding.size === new Set(failures.flatMap(({ eventIds }) => eventIds)).size ? "completed" : "running" : frozen.status,
-    total: history.length,
-    completed: history.length - outstanding.size,
+    status: backfillRelations.length > 0 && outstandingWork.size === failedWork.size ? "failed" : Object.keys(state.rebuildVersions ?? {}).length > 0 || backfillRelations.length > 0 ? outstandingWork.size === failedWork.size ? "completed" : "running" : frozen.status,
+    total,
+    completed: total - outstanding.size,
     failedEvents: new Set(failures.flatMap(({ eventIds }) => eventIds)).size,
+    sectionBackfill: { pendingRelations: backfillRelations.length, failedRelations },
     failures
   } : null;
   const revision = createHash4("sha256").update(JSON.stringify({
@@ -11847,7 +12254,10 @@ function topicDirectoryProjection(snapshot, agentMemoryWeight) {
         description: topic.description,
         createdAt: topic.createdAt,
         updatedAt: topic.updatedAt,
-        coverage: { ...topic.coverage },
+        coverage: { ...topic.coverage, unassignedEvents: (() => {
+          const assigned = new Set(memoryTopicSections(topic).flatMap((section) => section.sourceEventIds));
+          return topic.sourceEventIds.filter((id) => !assigned.has(id)).length;
+        })() },
         sections: memoryTopicSectionNavigation(topic),
         overview: topic.overview.map((part) => ({
           kind: part.kind,
@@ -11924,7 +12334,7 @@ async function topicEvents(runtime, url) {
     if (!topic) throw new AdminHttpError(404, "Unknown or unavailable memory topic");
     if (sectionKey === null) ids = topic.sourceEventIds;
     else if (sectionKey === "uncovered") {
-      const covered = new Set(topic.overview.flatMap((part) => part.sourceEventIds));
+      const covered = new Set(memoryTopicSections(topic).flatMap((section) => section.sourceEventIds));
       ids = topic.sourceEventIds.filter((id) => !covered.has(id));
     } else {
       const section = memoryTopicSections(topic).find((candidate) => candidate.key === sectionKey);
@@ -12023,17 +12433,41 @@ async function overview(runtime, cachedEntries) {
         sourceEventIds: job.sourceEventIds
       };
     };
+    const topicJobs = (snapshot.memoryTopicState?.jobs ?? []).filter((job) => !job.superseded);
+    const describeTopicJob = (job) => {
+      const diagnostics = safeTopicDiagnostics(job.diagnostics);
+      const lastError = diagnostics ? `${diagnostics.category}: ${diagnostics.reason}` : ["timeout", "source-changed", "invalid-output", "worker-failed"].includes(job.lastError ?? "") ? job.lastError : "worker-failed";
+      return {
+        id: job.id,
+        kind: "topic-projection",
+        state: derivationJobState(job, job.status === "completed"),
+        status: job.status,
+        attempts: job.attempts,
+        nextRetryAt: job.nextRetryAt,
+        updatedAt: job.updatedAt,
+        lastError,
+        lastErrorFull: lastError,
+        diagnostics,
+        eventCount: job.sourceEventIds.length,
+        blockIds: [],
+        threadIds: [],
+        blockDetails: []
+      };
+    };
+    const topicStatus = summarizeDerivationJobs(topicJobs, (job) => job.status === "completed");
     const summaryStatus = summarizeDerivationJobs(snapshot.summaryJobs, (job) => job.status === "succeeded");
     const extractionStatus = summarizeDerivationJobs(snapshot.extractionJobs, (job) => job.status === "succeeded" || job.status === "skipped");
     const graphStatus = summarizeDerivationJobs(snapshot.graphProjectionJobs, (job) => job.status === "completed");
-    const failedJobs = summaryStatus.terminalFailed + extractionStatus.terminalFailed + graphStatus.terminalFailed;
-    const processingJobs = summaryStatus.processing + extractionStatus.processing + graphStatus.processing;
+    const failedJobs = summaryStatus.terminalFailed + extractionStatus.terminalFailed + graphStatus.terminalFailed + topicStatus.terminalFailed;
+    const processingJobs = summaryStatus.processing + extractionStatus.processing + graphStatus.processing + topicStatus.processing;
     const failedJobDetails = [
+      ...topicJobs.filter((job) => job.status === "failed").map(describeTopicJob),
       ...snapshot.summaryJobs.filter(({ status }) => status === "failed").map((job) => describeBlockJob("block-summary", job)),
       ...snapshot.extractionJobs.filter(({ status }) => status === "failed").map((job) => describeBlockJob("event-extraction", job)),
       ...snapshot.graphProjectionJobs.filter(({ status }) => status === "failed").map(describeGraphJob)
     ];
     const processingJobDetails = [
+      ...topicJobs.filter((job) => ["processing", "retryable"].includes(derivationJobState(job, job.status === "completed"))).map(describeTopicJob),
       ...snapshot.summaryJobs.filter((job) => derivationJobState(job, job.status === "succeeded") === "processing" || derivationJobState(job, job.status === "succeeded") === "retryable").map((job) => describeBlockJob("block-summary", job)),
       ...snapshot.extractionJobs.filter((job) => derivationJobState(job, job.status === "succeeded" || job.status === "skipped") === "processing" || derivationJobState(job, job.status === "succeeded" || job.status === "skipped") === "retryable").map((job) => describeBlockJob("event-extraction", job)),
       ...snapshot.graphProjectionJobs.filter(graphProjectionIsProcessing).map(describeGraphJob)
@@ -12063,7 +12497,8 @@ async function overview(runtime, cachedEntries) {
       taskStatus: {
         blockSummary: summaryStatus,
         eventExtraction: extractionStatus,
-        graphProjection: graphStatus
+        graphProjection: graphStatus,
+        topicProjection: topicStatus
       },
       graphMigration: (() => {
         const projected = new Set(snapshot.graphProjectionJobs.filter(({ status, projectorVersion }) => status === "completed" && projectorVersion === KNOWLEDGE_GRAPH_PROJECTOR_VERSION).flatMap(({ sourceEventIds }) => sourceEventIds)).size;
@@ -12704,13 +13139,13 @@ async function retryJob(runtime, url) {
   const kind = url.searchParams.get("kind")?.trim() ?? "";
   const jobId = url.searchParams.get("jobId")?.trim() ?? "";
   if (!namespace) throw new AdminHttpError(400, "namespace is required");
-  if (!["block-summary", "event-extraction", "graph-projection"].includes(kind)) {
-    throw new AdminHttpError(400, "kind must be block-summary, event-extraction, or graph-projection");
+  if (!["block-summary", "event-extraction", "graph-projection", "topic-projection"].includes(kind)) {
+    throw new AdminHttpError(400, "kind must be block-summary, event-extraction, graph-projection, or topic-projection");
   }
   if (!jobId) throw new AdminHttpError(400, "jobId is required");
   if (jobId.startsWith("virtual:")) throw new AdminHttpError(409, "Recovered legacy fragments cannot be retried");
   const snapshot = await requiredSnapshot(runtime, namespace);
-  const job = kind === "block-summary" ? snapshot.summaryJobs.find(({ blockId }) => blockId === jobId) : kind === "event-extraction" ? snapshot.extractionJobs.find(({ blockId }) => blockId === jobId) : snapshot.graphProjectionJobs.find(({ id }) => id === jobId);
+  const job = kind === "block-summary" ? snapshot.summaryJobs.find(({ blockId }) => blockId === jobId) : kind === "event-extraction" ? snapshot.extractionJobs.find(({ blockId }) => blockId === jobId) : kind === "topic-projection" ? snapshot.memoryTopicState?.jobs.find(({ id }) => id === jobId) : snapshot.graphProjectionJobs.find(({ id }) => id === jobId);
   if (!job) throw new AdminHttpError(404, `Unknown ${kind} job: ${jobId}`);
   if (job.status !== "failed") throw new AdminHttpError(409, `${kind} job is ${job.status}, not failed`);
   try {
@@ -12720,6 +13155,7 @@ async function retryJob(runtime, url) {
       jobId
     );
   } catch (error) {
+    if (kind === "topic-projection" && error instanceof Error && /Topic retry conflict|Unknown topic projection/.test(error.message)) throw new AdminHttpError(409, "\u6765\u6E90\u6216\u4EFB\u52A1\u5DF2\u66F4\u65B0\uFF0C\u8BF7\u91CD\u65B0\u8BFB\u53D6\u76EE\u5F55");
     throw new AdminHttpError(422, error instanceof Error ? error.message : String(error));
   }
 }
@@ -12813,7 +13249,7 @@ async function dashboard(runtime, url, ifNoneMatch) {
       namespace: selected.namespace,
       revision: selected.revision,
       overview: overviewValue,
-      processing: Number(selectedOverview?.processingJobs ?? 0) > 0 || topicDirectoryData.bootstrap !== null && topicDirectoryData.bootstrap.total > 0 && topicDirectoryData.bootstrap.status !== "completed",
+      processing: Number(selectedOverview?.processingJobs ?? 0) > 0 || topicDirectoryData.bootstrap !== null && topicDirectoryData.bootstrap.total > 0 && (topicDirectoryData.bootstrap.status === "pending" || topicDirectoryData.bootstrap.status === "running"),
       data: {
         events: eventResult.items ?? [],
         graph: graphResult,