stratagate-dsh 0.3.3 → 0.3.5

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;
@@ -3937,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));
@@ -3962,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;
@@ -3999,7 +4131,7 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
     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.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.status === "failed" && job.nextRetryAt !== null && Date.parse(job.nextRetryAt) <= now) && jobInputsCurrent(job, versions) && this.matchesMode(job.sourceEventIds, versions, mode, job.sectionBackfillTopicId));
+    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) {
@@ -4010,7 +4142,7 @@ 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, 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];
+    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]), 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") {
@@ -4134,6 +4266,7 @@ 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;
@@ -4149,15 +4282,15 @@ 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 Error("Topic projection must return 1-12 topics.");
+    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 Error("Invalid section backfill: explicit sections must cover the existing chapter.");
+      throw new TopicProjectionError("validation-failed", "Invalid section backfill: explicit sections must cover the existing chapter.");
     }
     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)]);
@@ -4167,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) {
@@ -4177,45 +4310,45 @@ 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 Error("Invalid topic sections.");
+      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 Error("Invalid or duplicate topic section title.");
+        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 Error("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 Error("Old section membership must be preserved; reassignment needs batch events.");
+        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 Error("Topic sections omitted 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) : [];
@@ -4231,7 +4364,7 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       const inherited = existing && !existing.invalidated ? existing.overview : [];
       if (proposal.sections !== void 0) for (const part of proposal.overview) {
         if (!inherited.some((old) => digest(old) === digest(part)) && !memoryTopicOverviewMatchesSection(part, titles)) {
-          throw new Error("New topic overview must match a final topic section.");
+          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));
@@ -4251,7 +4384,7 @@ 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);
@@ -4281,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);
@@ -4311,6 +4480,8 @@ var MemoryTopicDirectory = class _MemoryTopicDirectory {
       dependencyVersions: {},
       candidateVersions: {},
       topicIds: [],
+      diagnostics: void 0,
+      splitDepth: 0,
       lastError: null,
       nextRetryAt: null,
       leaseUntil: null,
@@ -7754,7 +7925,7 @@ ${JSON_RETRY_INSTRUCTION}`, tool: toolSchema("topicProjector"), payload }));
 }
 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) {
@@ -7841,6 +8012,7 @@ function parseTopicProjection(value, context) {
   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;
@@ -7849,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();
@@ -8084,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",
@@ -8092,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) => {
@@ -8150,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({
@@ -8184,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) {
@@ -8199,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)) {
@@ -8216,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 }
@@ -8245,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 }
@@ -8254,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 }
           );
         }
@@ -8276,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 }
@@ -8292,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 }
@@ -8303,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}`,
@@ -8339,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");
@@ -8790,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);
@@ -8818,27 +9045,58 @@ 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")}`;
+  const header = "[StrataGate \u8BB0\u5FC6\u76EE\u5F55]\n\u4EC5\u4F9B\u5BFC\u822A\uFF0C\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 byId = new Map(topics.map((topic) => [topic.id, topic]));
+  const chapters = entries.map((entry) => ({
+    ...entry,
+    line: `- ${entry.id}\uFF1A${lineText(entry.title, 64)}${entry.description ? `\uFF1B${lineText(entry.description, 48)}` : ""}`,
+    // Reuse the book's stable section order, including summary-free and legacy sections.
+    sections: memoryTopicSections(byId.get(entry.id)).map(({ title }) => `  - ${lineText(title, 64)}`)
+  }));
+  const render = (prefix, selected2) => `${prefix}
+${selected2.flatMap(({ line, sections }) => [line, ...sections]).join("\n")}`.trim();
+  const complete = render(header, chapters);
   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) {
-    const entry = entries.find((item) => item.category === category.id);
-    const line = `- ${entry.id}\uFF1A${lineText(entry.title, 40)}`;
-    if (estimateTokens(`${navigation}
-${[...selected.map(({ line: line2 }) => line2), line].join("\n")}`) <= MEMORY_DIRECTORY_TOKEN_BUDGET) selected.push({ id: entry.id, line });
+\u5171 ${entries.length} \u9879\uFF1B\u5206\u7C7B\uFF1A${branches}\u3002\u76EE\u5F55\u5DF2\u88C1\u526A\uFF1B\u5B8C\u6574\u76EE\u5F55\u7528 memory_list_topics(category, offset) \u5206\u9875\uFF1Bquery \u53EF\u67E5\u4E3B\u9898\uFF0C\u5C0F\u8282\u7528 memory_expand_topic(id)\u3002`;
+  let selected = chapters.map((chapter) => ({ ...chapter, sections: [] }));
+  if (estimateTokens(render(navigation, selected)) > MEMORY_DIRECTORY_TOKEN_BUDGET) {
+    selected = [];
+    const admit = (chapter) => {
+      for (const line of [chapter.line, `- ${chapter.id}\uFF1A${lineText(chapter.title, 64)}`]) {
+        const candidate = { ...chapter, line, sections: [] };
+        if (estimateTokens(render(navigation, [...selected, candidate])) <= MEMORY_DIRECTORY_TOKEN_BUDGET) {
+          selected.push(candidate);
+          return;
+        }
+      }
+    };
+    for (const category of categories2) admit(chapters.find((chapter) => chapter.category === category.id));
+    for (const chapter of chapters) if (!selected.some(({ id }) => id === chapter.id)) admit(chapter);
   }
   const order = new Map(entries.map(({ id }, index) => [id, index]));
   selected.sort((a, b) => order.get(a.id) - order.get(b.id));
-  return `${navigation}
-${selected.map(({ line }) => line).join("\n")}`.trim();
+  const sectionLines = new Map(chapters.map(({ id, sections }) => [id, sections]));
+  const exhausted = /* @__PURE__ */ new Set();
+  for (let index = 0; exhausted.size < selected.length; index++) {
+    for (const chapter of selected) {
+      if (exhausted.has(chapter.id)) continue;
+      const line = sectionLines.get(chapter.id)[index];
+      if (line === void 0) {
+        exhausted.add(chapter.id);
+        continue;
+      }
+      chapter.sections.push(line);
+      if (estimateTokens(render(navigation, selected)) > MEMORY_DIRECTORY_TOKEN_BUDGET) {
+        chapter.sections.pop();
+        exhausted.add(chapter.id);
+      }
+    }
+  }
+  return render(navigation, selected);
 }
 function boundedTopic(topic, envelope = {}) {
   const { sections: _sections, ...summaryTopic } = topic;
@@ -9384,9 +9642,21 @@ var StrataGateRuntime = class {
   }
   async buildMemoryDirectory(session) {
     await this.flush();
-    const memory = await this.space(session);
-    await this.refreshExternalImportMemory(this.namespaceFor(session), memory);
-    return renderMemoryDirectory(this.visibleTopics(memory), memory.listAllEvents());
+    const namespace = this.namespaceFor(session);
+    const active = this.spaces.get(namespace);
+    if (active) {
+      const memory = await active;
+      await this.refreshExternalImportMemory(namespace, memory);
+      return renderMemoryDirectory(this.visibleTopics(memory), memory.listAllEvents());
+    }
+    if (this.config.database === ":memory:" || !existsSync(this.config.database)) return "";
+    const storage = new SqliteStorage({ filename: this.config.database, readonly: true });
+    try {
+      const memory = await StrataGate.openWithStorage({ storage, namespace });
+      return renderMemoryDirectory(this.visibleTopics(memory), memory.listAllEvents());
+    } finally {
+      await storage.close();
+    }
   }
   visibleTopics(memory) {
     if (this.agentMemoryRetrievalWeight > 0) return memory.listMemoryTopics();
@@ -9663,6 +9933,7 @@ var StrataGateRuntime = class {
   async buildAutoContext(session) {
     await this.flush();
     const memory = await this.space(session);
+    await this.refreshExternalImportMemory(this.namespaceFor(session), memory);
     const threadId = String(session.id);
     const blockContexts = memory.getBlockContext(threadId);
     if (this.syncDecayedBlockSurface(session, memory, blockContexts)) {
@@ -10467,6 +10738,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;
@@ -11976,6 +12248,7 @@ function topicDirectoryProjection(snapshot, agentMemoryWeight) {
   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 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;
@@ -11987,7 +12260,8 @@ function topicDirectoryProjection(snapshot, agentMemoryWeight) {
       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
     }] : [];
   });
@@ -12203,17 +12477,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)
@@ -12243,7 +12541,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;
@@ -12884,13 +13183,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 {
@@ -12900,6 +13199,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));
   }
 }
@@ -13607,20 +13907,22 @@ async function apply(ctx, config) {
     }
     const session = context.agent?.session;
     if (!session) return { ...assembled, contexts };
+    let autoMemory;
     try {
-      const directory = await runtime.buildMemoryDirectory(session);
-      if (directory) contexts.push({ name: "stratagate:memory-directory", text: directory });
+      const text3 = await runtime.buildAutoContext(session);
+      autoMemory = { name: "stratagate:auto-memory", text: text3 };
     } catch (error) {
-      ctx.logger.warn(`stratagate-memory directory failed: ${renderError(error)}`);
+      ctx.logger.warn(`stratagate-memory auto-context failed: ${renderError(error)}`);
       runtime.notePluginError(session, error);
     }
     try {
-      const text3 = await runtime.buildAutoContext(session);
-      contexts.push({ name: "stratagate:auto-memory", text: text3 });
+      const directory = await runtime.buildMemoryDirectory(session);
+      if (directory) contexts.push({ name: "stratagate:memory-directory", text: directory });
     } catch (error) {
-      ctx.logger.warn(`stratagate-memory auto-context failed: ${renderError(error)}`);
+      ctx.logger.warn(`stratagate-memory directory failed: ${renderError(error)}`);
       runtime.notePluginError(session, error);
     }
+    if (autoMemory) contexts.push(autoMemory);
     const feedbackSuggestion = runtime.takeFeedbackSuggestion(session);
     if (feedbackSuggestion) contexts.push({ name: "stratagate:feedback-suggestion", text: feedbackSuggestion });
     return { ...assembled, contexts };