@fenglimg/fabric-shared 2.0.0-rc.21 → 2.0.0-rc.23

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-VKCXD6CI.js";
+} from "./chunk-GYIALPMW.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -21,6 +21,8 @@ import {
   KnowledgeTypeSchema,
   LayerSchema,
   MaturitySchema,
+  ONBOARD_SLOT_NAMES,
+  ONBOARD_SLOT_TOTAL,
   PROPOSED_REASON_DESCRIPTIONS,
   ProposedReasonSchema,
   StableIdSchema,
@@ -28,9 +30,6 @@ import {
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   formatKnowledgeId,
-  getKnowledgeAnnotations,
-  getKnowledgeInputSchema,
-  getKnowledgeOutputSchema,
   historyStateQuerySchema,
   humanLockApproveRequestSchema,
   humanLockFileParamsSchema,
@@ -39,6 +38,7 @@ import {
   knowledgeSectionsOutputSchema,
   ledgerQuerySchema,
   ledgerSourceSchema,
+  onboardSlotSchema,
   parseKnowledgeId,
   planContextAnnotations,
   planContextHintNarrowEntrySchema,
@@ -46,7 +46,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "./chunk-NNDFOOBO.js";
+} from "./chunk-GDYPVGWT.js";
 import {
   BOOTSTRAP_CANONICAL,
   BOOTSTRAP_MARKER_BEGIN,
@@ -55,7 +55,7 @@ import {
   LEGACY_KB_MARKER_BEGIN,
   LEGACY_KB_MARKER_END,
   LEGACY_KB_REGEX
-} from "./chunk-QZNUUIL3.js";
+} from "./chunk-IP6VWOVE.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -450,7 +450,37 @@ var fabricConfigSchema = z5.object({
   // for explicit resolve-or-drop decision. Default 14; tighter than the
   // 7d Signal-B trigger because review specifically targets the long
   // tail. Large repos with slower cadence can raise to 30.
-  review_stale_pending_days: z5.number().int().positive().optional().default(14)
+  review_stale_pending_days: z5.number().int().positive().optional().default(14),
+  // v2.0.0-rc.22 Scope A T3: sliding-window retention (in days) for the
+  // event ledger rotation primitive (`rotateEventLedgerIfNeeded`). Lines
+  // whose `ts` is older than `now - fabric_event_retention_days * 86_400_000`
+  // are partitioned into `.fabric/events.archive/events-rotated-YYYY-MM-DD.jsonl`.
+  // Locked to 7/30/90 — three operator-friendly preset windows. Default 30
+  // is applied at the consumer site (rotateEventLedgerIfNeeded), so this
+  // field stays `.optional()` without a `.default()` to keep the schema
+  // surface honest: absence means "use the library default", not "schema
+  // default of 30 was injected." 7 = ~tight, 30 = balanced, 90 = forensic.
+  // Mirrors cite-policy precedent of locking enum-style numeric tunables
+  // to a small literal set (vs free `.positive()`) to prevent fat-finger
+  // misconfig.
+  fabric_event_retention_days: z5.union([z5.literal(7), z5.literal(30), z5.literal(90)]).optional(),
+  // v2.0.0-rc.23 TASK-014 (F8c): onboard slot opt-out list. Tracks slot
+  // names the user explicitly dismissed during fabric-archive's first-run
+  // onboard phase (or via `fab config dismiss-slot <slot>`). Dismissed
+  // slots are excluded from `fab onboard-coverage`'s `missing` set and the
+  // doctor `Onboard coverage` advisory's recompute, so the user is never
+  // re-prompted for slots they consciously declined.
+  //
+  // Re-opening a dismissed slot requires `fab config onboard-reset <slot>`
+  // — a deliberate two-command UX to keep the dismiss intent reversible
+  // but never silently undone. Schema is intentionally `z.array(z.string())`
+  // rather than `z.array(onboardSlotSchema)` so historical configs survive
+  // a slot rename without a Zod parse error; downstream consumers
+  // intersect against ONBOARD_SLOT_NAMES at read time.
+  //
+  // 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([])
 });
 
 // src/schemas/fabric-config-introspect.ts
@@ -875,8 +905,19 @@ var metaReconciledEventSchema = z10.object({
   event_type: z10.literal("meta_reconciled"),
   reconciled_files: z10.array(z10.string()),
   duration_ms: z10.number().int().nonnegative(),
-  trigger: z10.enum(["doctor", "manual"]),
-  source: z10.literal("reconcileKnowledge")
+  // v2.0.0-rc.23 TASK-005 (a-B): added `auto-heal-description` trigger so the
+  // read-path plan_context handler can drive a full reconcile when it detects
+  // any node carrying `description === undefined` (legacy meta drift that the
+  // revision-hash gate cannot catch — a missing description doesn't move the
+  // revision). Symmetric to rc.22 D2 read-side auto-heal but covers the
+  // description-undefined case which the revision drift gate misses.
+  trigger: z10.enum(["doctor", "manual", "auto-heal-description"]),
+  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).
+  // Distinguishes top-level schema/revision repair from the standard per-file
+  // drift path. Optional so existing emitters stay unchanged.
+  force_write_reason: z10.enum(["revision_drift"]).optional()
 });
 var claudeSkillPathMigratedEventSchema = z10.object({
   ...eventLedgerEnvelopeSchema,
@@ -1046,6 +1087,37 @@ var citePolicyActivatedEventSchema = z10.object({
   policy_version: z10.string(),
   timestamp: z10.string().datetime()
 });
+var eventsRotatedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("events_rotated"),
+  cutoff_ts: z10.string().datetime(),
+  archived_count: z10.number().int().nonnegative(),
+  kept_count: z10.number().int().nonnegative(),
+  archive_path: z10.string()
+});
+var knowledgeMetaAutoHealedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("knowledge_meta_auto_healed"),
+  previous_revision_hash: z10.string(),
+  revision_hash: z10.string(),
+  trigger: z10.literal("read"),
+  caller: z10.enum(["planContext", "getKnowledgeSections", "getKnowledge", "extractKnowledge"]).optional()
+});
+var serveLockClearedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("serve_lock_cleared"),
+  pid: z10.number().int().nonnegative(),
+  age_ms: z10.number().int().nonnegative(),
+  timestamp: z10.string().datetime()
+});
+var knowledgeEnrichedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  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"]),
+  timestamp: z10.string().datetime()
+});
 var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   knowledgeContextPlannedEventSchema,
   knowledgeSelectionEventSchema,
@@ -1097,7 +1169,23 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   assistantTurnObservedEventSchema,
   // v2.0.0-rc.20 TASK-02: cite_policy_activated — session/policy-bump
   // marker recording when a given policy_version became active.
-  citePolicyActivatedEventSchema
+  citePolicyActivatedEventSchema,
+  // v2.0.0-rc.22 Scope D T-D1: knowledge_meta_auto_healed — emitted by
+  // loadActiveMeta when read-path drift triggers an in-place meta rebuild.
+  knowledgeMetaAutoHealedEventSchema,
+  // v2.0.0-rc.22 Scope A T3: events_rotated — emitted as the first line of
+  // the post-rotation events.jsonl when sliding-window-by-age rotation moves
+  // stale entries to events.archive/events-rotated-YYYY-MM-DD.jsonl.
+  eventsRotatedEventSchema,
+  // v2.0.0-rc.23 TASK-010 (e): serve_lock_cleared — emitted by
+  // `fab doctor --fix` when a stale `.fabric/.serve.lock` with a dead PID is
+  // unlinked.
+  serveLockClearedEventSchema,
+  // v2.0.0-rc.23 TASK-007 (a-C2): knowledge_enriched — emitted by
+  // `fab doctor --enrich-descriptions` once per modified canonical knowledge
+  // file when one or more of the four rc.23 description-grade frontmatter
+  // fields is back-filled.
+  knowledgeEnrichedEventSchema
 ]);
 export {
   AGENTS_META_IDENTITY_SOURCES,
@@ -1124,6 +1212,8 @@ export {
   LEGACY_KB_REGEX,
   LayerSchema,
   MaturitySchema,
+  ONBOARD_SLOT_NAMES,
+  ONBOARD_SLOT_TOTAL,
   PROPOSED_REASON_DESCRIPTIONS,
   PROTECTED_TOKENS,
   ProposedReasonSchema,
@@ -1160,6 +1250,7 @@ export {
   enMessages,
   eventLedgerEventSchema,
   eventLedgerTruncatedEventSchema,
+  eventsRotatedEventSchema,
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   fabricConfigSchema,
@@ -1176,9 +1267,6 @@ export {
   forensicSamplingBudgetSchema,
   forensicTopologySchema,
   formatKnowledgeId,
-  getKnowledgeAnnotations,
-  getKnowledgeInputSchema,
-  getKnowledgeOutputSchema,
   getPanelFieldByKey,
   getPanelFields,
   historyStateQuerySchema,
@@ -1203,7 +1291,9 @@ export {
   knowledgeDeferredEventSchema,
   knowledgeDemotedEventSchema,
   knowledgeDriftDetectedEventSchema,
+  knowledgeEnrichedEventSchema,
   knowledgeLayerChangedEventSchema,
+  knowledgeMetaAutoHealedEventSchema,
   knowledgePathDangledEventSchema,
   knowledgePromoteFailedEventSchema,
   knowledgePromoteStartedEventSchema,
@@ -1233,6 +1323,7 @@ export {
   metaReconciledOnStartupEventSchema,
   metaUpdatedEventSchema,
   normalizeLocale,
+  onboardSlotSchema,
   parseKnowledgeId,
   pendingAutoArchivedEventSchema,
   planContextAnnotations,
@@ -1244,6 +1335,7 @@ export {
   relevanceMigrationRunEventSchema,
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
+  serveLockClearedEventSchema,
   structuredWarningSchema,
   withDerivedAgentsMetaNodeDefaults,
   zhCNMessages

package/dist/node/atomic-write.d.ts

@@ -8,6 +8,22 @@ declare function atomicWriteText(path: string, content: string, opts?: AtomicWri
 declare function atomicWriteJson(path: string, value: unknown, opts?: AtomicWriteJsonOptions): Promise<void>;
 interface LedgerWriteQueue {
     append(path: string, line: string): Promise<void>;
+    /**
+     * Run `fn` with exclusive access to `path` against all other queue operations
+     * (other `runExclusive` calls and `append` calls) on the same path within
+     * this LedgerWriteQueue instance.
+     *
+     * Scope: per-path, in-process (same Node process, same queue instance).
+     * Does NOT provide cross-process locking — separate concern.
+     *
+     * Error semantics: a rejection from `fn` is propagated to the returned
+     * Promise but does NOT poison the chain — subsequent `runExclusive` /
+     * `append` calls on the same path will still acquire and run.
+     *
+     * Ordering: submission-order FIFO. Calls on different paths run independently
+     * (in parallel where possible).
+     */
+    runExclusive<T>(path: string, fn: () => Promise<T>): Promise<T>;
 }
 declare function createLedgerWriteQueue(): LedgerWriteQueue;
 

package/dist/node/atomic-write.js

@@ -38,18 +38,27 @@ function createLedgerWriteQueue() {
     const normalized = line.endsWith("\n") ? line : line + "\n";
     await appendFile(path, normalized, "utf8");
   }
+  function enqueue(path, work) {
+    const prev = chains.get(path) ?? Promise.resolve();
+    const result = prev.catch(() => void 0).then(() => work());
+    const chainSlot = result.then(
+      () => void 0,
+      () => void 0
+    );
+    chains.set(path, chainSlot);
+    chainSlot.finally(() => {
+      if (chains.get(path) === chainSlot) {
+        chains.delete(path);
+      }
+    });
+    return result;
+  }
   return {
     append(path, line) {
-      const prev = chains.get(path) ?? Promise.resolve();
-      const next = prev.catch(() => void 0).then(() => doAppend(path, line));
-      chains.set(path, next);
-      const guarded = next.catch(() => void 0);
-      guarded.finally(() => {
-        if (chains.get(path) === next) {
-          chains.delete(path);
-        }
-      });
-      return next;
+      return enqueue(path, () => doAppend(path, line));
+    },
+    runExclusive(path, fn) {
+      return enqueue(path, fn);
     }
   };
 }