@fenglimg/fabric-shared 2.0.0-rc.28 → 2.0.0-rc.29

package/dist/index.js

@@ -1,12 +1,4 @@
-import {
-  BOOTSTRAP_CANONICAL,
-  BOOTSTRAP_MARKER_BEGIN,
-  BOOTSTRAP_MARKER_END,
-  BOOTSTRAP_REGEX,
-  LEGACY_KB_MARKER_BEGIN,
-  LEGACY_KB_MARKER_END,
-  LEGACY_KB_REGEX
-} from "./chunk-4OQXR6JW.js";
+import "./chunk-LXNCAKJZ.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -16,7 +8,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-DXQVLDEB.js";
+} from "./chunk-225L7D4T.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -58,8 +50,16 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "./chunk-G32HVF7H.js";
-import "./chunk-LXNCAKJZ.js";
+} from "./chunk-Y2YBFL2G.js";
+import {
+  BOOTSTRAP_CANONICAL,
+  BOOTSTRAP_MARKER_BEGIN,
+  BOOTSTRAP_MARKER_END,
+  BOOTSTRAP_REGEX,
+  LEGACY_KB_MARKER_BEGIN,
+  LEGACY_KB_MARKER_END,
+  LEGACY_KB_REGEX
+} from "./chunk-4OQXR6JW.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -79,7 +79,7 @@ var ruleDescriptionSchema = z.object({
   entities: z.array(z.string()).optional(),
   // v2.0 knowledge entry fields (TASK-002 schemas). All optional for backward compat.
   id: z.string().optional(),
-  knowledge_type: z.enum(["model", "decision", "guideline", "pitfall", "process"]).optional(),
+  knowledge_type: z.enum(["models", "decisions", "guidelines", "pitfalls", "processes"]).optional(),
   maturity: z.enum(["draft", "verified", "proven"]).optional(),
   knowledge_layer: z.enum(["personal", "team"]).optional(),
   layer_reason: z.string().optional(),
@@ -319,6 +319,7 @@ var mcpPayloadLimitsSchema = z5.object({
   warnBytes: z5.number().int().positive().optional(),
   hardBytes: z5.number().int().positive().optional()
 }).optional();
+var selectionTokenTtlMsSchema = z5.number().int().min(3e4).max(36e5);
 var fabricLanguageSchema = z5.enum([
   "match-existing",
   "zh-CN",
@@ -484,7 +485,23 @@ var fabricConfigSchema = z5.object({
   //
   // Default `[]` keeps the field optional on existing configs — fresh
   // installs land with no opt-outs.
-  onboard_slots_opted_out: z5.array(z5.string()).optional().default([])
+  onboard_slots_opted_out: z5.array(z5.string()).optional().default([]),
+  // v2.0.0-rc.29 TASK-008 (BUG-F3): selection-token TTL override. The
+  // `fab_plan_context` MCP tool hands clients a `selection_token` whose default
+  // 5-minute lifetime (`SELECTION_TOKEN_TTL_MS` at
+  // packages/server/src/services/plan-context.ts:91) was hard-coded and could
+  // not be tuned for slow review cycles. Operators on long-running sessions
+  // (manual paste-and-review flows, debugger pauses, etc.) reported tokens
+  // expiring mid-review. Override here; absence means "use the library default
+  // of 5*60*1000 ms." Range 30s..1h keeps the value useful — below 30s the
+  // token expires before MCP round-trips finish; above 1h it stops being a
+  // meaningful liveness signal for the plan-context cache.
+  //
+  // The single-field schema is exported separately (`selectionTokenTtlMsSchema`)
+  // so the server-side per-field reader can validate without re-running the
+  // whole fabricConfigSchema on every plan_context call — that lets a corrupt
+  // unrelated field stay isolated from the hot read path.
+  selection_token_ttl_ms: selectionTokenTtlMsSchema.optional()
 });
 
 // src/schemas/fabric-config-introspect.ts
@@ -875,6 +892,13 @@ var reapplyCompletedEventSchema = z10.object({
   preserved_meta: z10.boolean(),
   rules_count: z10.number().int().nonnegative()
 });
+var installDiffAppliedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("install_diff_applied"),
+  applied: z10.array(z10.string()),
+  canonical: z10.array(z10.string()),
+  drifted: z10.array(z10.string())
+});
 var eventLedgerTruncatedEventSchema = z10.object({
   ...eventLedgerEnvelopeSchema,
   event_type: z10.literal("event_ledger_truncated"),
@@ -919,7 +943,17 @@ var metaReconciledEventSchema = z10.object({
   // `fab_review` write-actions can flush newly-promoted entries into
   // `agents.meta.json.nodes[id]` synchronously — without this the new entry
   // remains description-less until the next plan_context auto-heal.
-  trigger: z10.enum(["doctor", "manual", "auto-heal-description", "post-approve", "post-modify"]),
+  // v2.0.0-rc.29 TASK-005 (BUG-G1): `auto-heal-after-drift` added so
+  // `ensureKnowledgeFresh` hot-path can chain a paired reconcile (closing the
+  // drift→heal gap) when the caller opts in via `autoHealOnDrift: true`.
+  trigger: z10.enum([
+    "doctor",
+    "manual",
+    "auto-heal-description",
+    "auto-heal-after-drift",
+    "post-approve",
+    "post-modify"
+  ]),
   source: z10.literal("reconcileKnowledge"),
   // v2.0.0-rc.22 TASK-014 (Scope E): set when reconcileKnowledge forced a
   // writeKnowledgeMeta on revision drift alone (no per-file content drift).
@@ -1145,7 +1179,7 @@ var knowledgeEnrichedEventSchema = z10.object({
   event_type: z10.literal("knowledge_enriched"),
   path: z10.string(),
   added_fields: z10.array(z10.enum(["intent_clues", "tech_stack", "impact", "must_read_if"])),
-  mode: z10.enum(["auto", "interactive"]),
+  mode: z10.enum(["auto", "preview", "readonly", "interactive"]),
   timestamp: z10.string().datetime()
 });
 var sessionArchiveAttemptedEventSchema = z10.object({
@@ -1164,6 +1198,7 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   knowledgeDriftDetectedEventSchema,
   mcpEventLedgerEventSchema,
   reapplyCompletedEventSchema,
+  installDiffAppliedEventSchema,
   eventLedgerTruncatedEventSchema,
   mcpConfigMigratedEventSchema,
   // v2.0.0-rc.19 TASK-004: bootstrap_marker_migrated — one-time fabric:knowledge-base
@@ -1426,6 +1461,7 @@ export {
   initContextSchema,
   initContextSourceEvidenceSchema,
   initScanCompletedEventSchema,
+  installDiffAppliedEventSchema,
   isKnowledgeStableId,
   knowledgeArchiveAttemptedEventSchema,
   knowledgeArchivedEventSchema,
@@ -1480,6 +1516,7 @@ export {
   resolveFabricLocale,
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
+  selectionTokenTtlMsSchema,
   serveLockClearedEventSchema,
   sessionArchiveAttemptedEventSchema,
   structuredWarningSchema,

package/dist/node/mcp-payload-guard.d.ts

@@ -11,6 +11,8 @@ interface PayloadGuardResult {
         threshold: number;
     };
 }
+declare const PAYLOAD_LIMIT_DEFAULT_WARN_BYTES = 16384;
+declare const PAYLOAD_LIMIT_DEFAULT_HARD_BYTES = 65536;
 declare function enforcePayloadLimit(serializedPayload: string, opts?: PayloadGuardOptions): PayloadGuardResult;
 
-export { type PayloadGuardOptions, type PayloadGuardResult, enforcePayloadLimit };
+export { PAYLOAD_LIMIT_DEFAULT_HARD_BYTES, PAYLOAD_LIMIT_DEFAULT_WARN_BYTES, type PayloadGuardOptions, type PayloadGuardResult, enforcePayloadLimit };

package/dist/node/mcp-payload-guard.js

@@ -7,8 +7,10 @@ var McpPayloadTooLargeError = class extends MCPError {
   code = "MCP_PAYLOAD_TOO_LARGE";
   httpStatus = 413;
 };
-var DEFAULT_WARN = 16384;
-var DEFAULT_HARD = 65536;
+var PAYLOAD_LIMIT_DEFAULT_WARN_BYTES = 16384;
+var PAYLOAD_LIMIT_DEFAULT_HARD_BYTES = 65536;
+var DEFAULT_WARN = PAYLOAD_LIMIT_DEFAULT_WARN_BYTES;
+var DEFAULT_HARD = PAYLOAD_LIMIT_DEFAULT_HARD_BYTES;
 function enforcePayloadLimit(serializedPayload, opts) {
   const warnAt = opts?.warnBytes ?? DEFAULT_WARN;
   const hardAt = opts?.hardBytes ?? DEFAULT_HARD;
@@ -36,5 +38,7 @@ function enforcePayloadLimit(serializedPayload, opts) {
   return { bytes };
 }
 export {
+  PAYLOAD_LIMIT_DEFAULT_HARD_BYTES,
+  PAYLOAD_LIMIT_DEFAULT_WARN_BYTES,
   enforcePayloadLimit
 };