@fenglimg/fabric-server 2.0.0-rc.35 → 2.0.0-rc.36

package/dist/{chunk-DRIWYXFP.js → chunk-5XXH2VZZ.js}

@@ -1741,6 +1741,7 @@ var HINT_SILENCE_COUNTER_FILE_REL = posix.join(
 var MS_PER_DAY = 24 * 60 * 60 * 1e3;
 var MATURITY_LINE_PATTERN = /^maturity:\s*("?)(stable|endorsed|draft)\1\s*$/mu;
 var CREATED_AT_LINE_PATTERN = /^created_at:\s*("?)([^"\n]+)\1\s*$/mu;
+var TAGS_LINE_PATTERN = /^tags:\s*\[(.*)\]\s*$/mu;
 var RELEVANCE_SCOPE_LINE_PATTERN = /^relevance_scope:\s*("?)(narrow|broad)\1\s*$/mu;
 var RELEVANCE_PATHS_LINE_PATTERN = /^relevance_paths:\s*\[([^\]]*)\]\s*$/mu;
 var RELEVANCE_PATHS_DRIFT_WINDOW_DAYS = 90;
@@ -1830,6 +1831,8 @@ async function runDoctorReport(target) {
   const skillDescription = inspectSkillDescription(projectRoot);
   const citeGoodhart = await inspectCiteGoodhart(projectRoot);
   const draftBacklog = inspectDraftBacklog(projectRoot);
+  const knowledgeTagsEmpty = inspectKnowledgeTagsEmpty(projectRoot);
+  const driftUnconsumed = await inspectDriftUnconsumed(projectRoot);
   const metaManuallyDiverged = await inspectMetaManuallyDiverged(projectRoot);
   const knowledgeDirUnindexed = inspectKnowledgeDirUnindexed(projectRoot, meta);
   const knowledgeDirMissing = inspectKnowledgeDirMissing(projectRoot);
@@ -1904,6 +1907,8 @@ async function runDoctorReport(target) {
     createSkillDescriptionCheck(t, skillDescription),
     createCiteGoodhartCheck(t, citeGoodhart),
     createDraftBacklogCheck(t, draftBacklog),
+    createKnowledgeTagsEmptyCheck(t, knowledgeTagsEmpty),
+    createDriftUnconsumedCheck(t, driftUnconsumed),
     createMcpConfigInWrongFileCheck(t, mcpConfigInWrongFile),
     createMetaManuallyDivergedCheck(t, metaManuallyDiverged),
     createKnowledgeDirUnindexedCheck(t, knowledgeDirUnindexed),
@@ -2980,6 +2985,35 @@ function inspectDraftBacklog(projectRoot) {
     ratio
   };
 }
+function inspectKnowledgeTagsEmpty(projectRoot) {
+  const EMPTY_TAGS_RATIO_THRESHOLD = 0.5;
+  const MIN_TOTAL_FOR_RATIO = 10;
+  let emptyCount = 0;
+  let totalCount = 0;
+  for (const entry of iterateCanonicalEntries(projectRoot, /* @__PURE__ */ new Map())) {
+    let source;
+    try {
+      source = readFileSync3(entry.absPath, "utf8");
+    } catch {
+      continue;
+    }
+    const isEmpty = isKnowledgeFrontmatterTagsEmpty(source);
+    if (isEmpty === null || isEmpty === true) {
+      emptyCount += 1;
+    }
+    totalCount += 1;
+  }
+  if (totalCount < MIN_TOTAL_FOR_RATIO) {
+    return { status: "ok", emptyCount, totalCount, ratio: 0 };
+  }
+  const ratio = emptyCount / totalCount;
+  return {
+    status: ratio > EMPTY_TAGS_RATIO_THRESHOLD ? "warn" : "ok",
+    emptyCount,
+    totalCount,
+    ratio
+  };
+}
 async function inspectKnowledgeTestIndex(projectRoot) {
   const path2 = join7(projectRoot, ".fabric", ".cache", "knowledge-test.index.json");
   const built = await tryBuildRuleMeta(projectRoot);
@@ -3395,15 +3429,15 @@ function createMetaCheck(t, meta, globalCli) {
     );
   }
   if (meta.stale) {
+    const revision = meta.revision;
+    const computedRevision = meta.computedRevision ?? "<unknown>";
+    const messageKey = revision !== null && revision === meta.computedRevision ? "doctor.check.agents_meta.message.stale_hash_equal" : "doctor.check.agents_meta.message.stale";
     return issueCheck(
       t("doctor.check.agents_meta.name"),
       "warn",
       "warning",
       "agents_meta_stale",
-      t("doctor.check.agents_meta.message.stale", {
-        revision: meta.revision,
-        computedRevision: meta.computedRevision ?? "<unknown>"
-      }),
+      t(messageKey, { revision, computedRevision }),
       t("doctor.check.agents_meta.remediation.stale")
     );
   }
@@ -3645,6 +3679,71 @@ function createDraftBacklogCheck(t, inspection) {
     t("doctor.check.draft_backlog.remediation")
   );
 }
+async function inspectDriftUnconsumed(projectRoot) {
+  const WINDOW_MS = 30 * 24 * 60 * 60 * 1e3;
+  const MIN_DRIFT_FOR_WARN = 5;
+  const cutoffMs = Date.now() - WINDOW_MS;
+  let events = [];
+  try {
+    const result = await readEventLedger(projectRoot);
+    events = result.events;
+  } catch {
+    return { status: "ok", driftCount: 0, demoteCount: 0 };
+  }
+  let driftCount = 0;
+  let demoteCount = 0;
+  for (const e of events) {
+    if (e.ts < cutoffMs) continue;
+    if (e.event_type === "knowledge_drift_detected") driftCount += 1;
+    else if (e.event_type === "knowledge_demoted") demoteCount += 1;
+  }
+  const unconsumed = driftCount - demoteCount;
+  return {
+    status: unconsumed >= MIN_DRIFT_FOR_WARN ? "warn" : "ok",
+    driftCount,
+    demoteCount
+  };
+}
+function createDriftUnconsumedCheck(t, inspection) {
+  if (inspection.status === "ok") {
+    return okCheck(
+      t("doctor.check.drift_unconsumed.name"),
+      t("doctor.check.drift_unconsumed.ok")
+    );
+  }
+  return issueCheck(
+    t("doctor.check.drift_unconsumed.name"),
+    "warn",
+    "warning",
+    "knowledge_drift_unconsumed",
+    t("doctor.check.drift_unconsumed.message", {
+      driftCount: String(inspection.driftCount),
+      demoteCount: String(inspection.demoteCount)
+    }),
+    t("doctor.check.drift_unconsumed.remediation")
+  );
+}
+function createKnowledgeTagsEmptyCheck(t, inspection) {
+  if (inspection.status === "ok") {
+    return okCheck(
+      t("doctor.check.knowledge_tags_empty.name"),
+      t("doctor.check.knowledge_tags_empty.ok")
+    );
+  }
+  const pct = Math.round(inspection.ratio * 100);
+  return issueCheck(
+    t("doctor.check.knowledge_tags_empty.name"),
+    "warn",
+    "warning",
+    "knowledge_tags_empty_ratio",
+    t("doctor.check.knowledge_tags_empty.message", {
+      emptyCount: String(inspection.emptyCount),
+      totalCount: String(inspection.totalCount),
+      pct: String(pct)
+    }),
+    t("doctor.check.knowledge_tags_empty.remediation")
+  );
+}
 function createCiteGoodhartCheck(t, inspection) {
   if (inspection.status === "ok") {
     return okCheck(
@@ -4565,6 +4664,19 @@ function extractKnowledgeFrontmatterMaturity(source) {
   const match = MATURITY_LINE_PATTERN.exec(fm[1]);
   return match === null ? null : match[2];
 }
+function isKnowledgeFrontmatterTagsEmpty(source) {
+  const FM_PATTERN = /^(?:)?---\r?\n([\s\S]*?)\r?\n---/u;
+  const fm = FM_PATTERN.exec(source);
+  if (fm === null) {
+    return null;
+  }
+  const match = TAGS_LINE_PATTERN.exec(fm[1]);
+  if (match === null) {
+    return null;
+  }
+  const inner = match[1].replace(/[\s,]/g, "");
+  return inner === "";
+}
 function extractKnowledgeFrontmatterCreatedAt(source) {
   const FM_PATTERN = /^(?:\uFEFF)?---\r?\n([\s\S]*?)\r?\n---/u;
   const fm = FM_PATTERN.exec(source);

package/dist/{http-OHY2I6ZY.js → http-ZRVOXE6C.js}

@@ -14,7 +14,7 @@ import {
   readEventLedger,
   runDoctorReport,
   sha256
-} from "./chunk-DRIWYXFP.js";
+} from "./chunk-5XXH2VZZ.js";
 
 // src/http.ts
 import { randomUUID as randomUUID2 } from "crypto";

package/dist/index.js

@@ -39,7 +39,7 @@ import {
   sha256,
   stableStringify,
   writeKnowledgeMeta
-} from "./chunk-DRIWYXFP.js";
+} from "./chunk-5XXH2VZZ.js";
 
 // src/index.ts
 import { existsSync as existsSync3 } from "fs";
@@ -2091,7 +2091,7 @@ function formatPreexistingRootMessage(projectRoot) {
 function createFabricServer(tracker) {
   const server = new McpServer({
     name: "fabric-knowledge-server",
-    version: "2.0.0-rc.35"
+    version: "2.0.0-rc.36"
   });
   registerPlanContext(server, tracker);
   registerKnowledgeSections(server, tracker);
@@ -2199,7 +2199,7 @@ function createShutdownHandler(deps) {
   };
 }
 async function startHttpServer(options) {
-  const { createFabricHttpApp } = await import("./http-OHY2I6ZY.js");
+  const { createFabricHttpApp } = await import("./http-ZRVOXE6C.js");
   const { port, projectRoot, host = "127.0.0.1", authToken, allowLoopbackNoAuth } = options;
   const app = createFabricHttpApp({ projectRoot, host, authToken, allowLoopbackNoAuth });
   return await new Promise((resolveServer, rejectServer) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-server",
-  "version": "2.0.0-rc.35",
+  "version": "2.0.0-rc.36",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,7 +13,7 @@
     "express": "^5.2.1",
     "minimatch": "^10.0.1",
     "zod": "^3.25.0",
-    "@fenglimg/fabric-shared": "2.0.0-rc.35"
+    "@fenglimg/fabric-shared": "2.0.0-rc.36"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",