@fenglimg/fabric-shared 2.0.0-rc.22 → 2.0.0-rc.25

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   LEGACY_KB_MARKER_BEGIN,
   LEGACY_KB_MARKER_END,
   LEGACY_KB_REGEX
-} from "./chunk-BEABJYVL.js";
+} from "./chunk-4OQXR6JW.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -15,7 +15,7 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-VKCXD6CI.js";
+} from "./chunk-AFUQKKGR.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -29,16 +29,18 @@ import {
   KnowledgeTypeSchema,
   LayerSchema,
   MaturitySchema,
+  ONBOARD_SLOT_NAMES,
+  ONBOARD_SLOT_TOTAL,
   PROPOSED_REASON_DESCRIPTIONS,
   ProposedReasonSchema,
   StableIdSchema,
   annotateIntentRequestSchema,
+  citeContractMetricsSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   formatKnowledgeId,
-  getKnowledgeAnnotations,
-  getKnowledgeInputSchema,
-  getKnowledgeOutputSchema,
   historyStateQuerySchema,
   humanLockApproveRequestSchema,
   humanLockFileParamsSchema,
@@ -47,6 +49,7 @@ import {
   knowledgeSectionsOutputSchema,
   ledgerQuerySchema,
   ledgerSourceSchema,
+  onboardSlotSchema,
   parseKnowledgeId,
   planContextAnnotations,
   planContextHintNarrowEntrySchema,
@@ -54,7 +57,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "./chunk-WK4WINAZ.js";
+} from "./chunk-3RSYWMQU.js";
 import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
@@ -463,7 +466,24 @@ var fabricConfigSchema = z5.object({
   // 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()
+  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
@@ -888,7 +908,13 @@ 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"]),
+  // 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).
@@ -1053,6 +1079,24 @@ var assistantTurnObservedEventSchema = z10.object({
   kb_line_raw: z10.string().nullable(),
   cite_ids: z10.array(z10.string()).default([]),
   cite_tags: z10.array(z10.enum(["planned", "recalled", "chained-from", "dismissed", "none"])).default([]),
+  // v2.0.0-rc.24 TASK-01: per-cite contract commitments. Index-aligned with
+  // cite_ids/cite_tags (commitments[i] belongs to cite_ids[i]). Each slot
+  // carries `operators[]` (kind + glob target) or `skip_reason` when the cite
+  // cannot be operator-ized. Old rc.20-rc.23 events naturally parse with an
+  // empty array via `.default([])` and are excluded from contract-policy
+  // audits by the marker-gate (see cite_contract_policy_activated below).
+  // Mirrors the rc.20 cite_tags parallel-array evolution exactly.
+  cite_commitments: z10.array(
+    z10.object({
+      operators: z10.array(
+        z10.object({
+          kind: z10.enum(["edit", "not_edit", "require", "forbid"]),
+          target: z10.string()
+        })
+      ),
+      skip_reason: z10.string().nullable()
+    })
+  ).default([]),
   client: z10.enum(["cc", "codex", "cursor"]).optional(),
   turn_id: z10.string(),
   envelope_index: z10.number().int().nonnegative().optional(),
@@ -1064,6 +1108,10 @@ var citePolicyActivatedEventSchema = z10.object({
   policy_version: z10.string(),
   timestamp: z10.string().datetime()
 });
+var citeContractPolicyActivatedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("cite_contract_policy_activated")
+});
 var eventsRotatedEventSchema = z10.object({
   ...eventLedgerEnvelopeSchema,
   event_type: z10.literal("events_rotated"),
@@ -1080,6 +1128,29 @@ var knowledgeMetaAutoHealedEventSchema = z10.object({
   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 sessionArchiveAttemptedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("session_archive_attempted"),
+  outcome: z10.enum(["proposed", "viability_failed", "user_dismissed", "skipped_no_signal"]),
+  covered_through_ts: z10.number().int().nonnegative(),
+  candidates_proposed: z10.number().int().nonnegative().default(0),
+  knowledge_proposed_ids: z10.array(z10.string()).default([])
+});
 var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   knowledgeContextPlannedEventSchema,
   knowledgeSelectionEventSchema,
@@ -1132,14 +1203,110 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   // v2.0.0-rc.20 TASK-02: cite_policy_activated — session/policy-bump
   // marker recording when a given policy_version became active.
   citePolicyActivatedEventSchema,
+  // v2.0.0-rc.24 TASK-01: cite_contract_policy_activated — drift-gated
+  // idempotent marker opening the contract-policy audit window. Distinct
+  // from cite_policy_activated so contract metrics get their own window.
+  citeContractPolicyActivatedEventSchema,
   // 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
+  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,
+  // v2.0.0-rc.25 TASK-01: session_archive_attempted — emitted by the
+  // fabric-archive skill at the end of every invocation. Drives Phase 0.0
+  // cross-session digest, outcome-based rescan filter (skips user_dismissed),
+  // covered_through_ts watermark, and `fab doctor --archive-history`.
+  sessionArchiveAttemptedEventSchema
+]);
+
+// src/cite-line-parser.ts
+var ID_RE = /^K[TP]-[A-Z]+-\d+$/;
+var SENTINEL_RE = /^KB:\s*none\b\s*(?:\[[^\]]*\])?\s*$/i;
+var FULL_RE = /^KB:\s+(K[TP]-[A-Z]+-\d+)(?:\s+\(([^)]*)\))?(?:\s+\[([^\]]+)\])?(?:\s+→\s*(.+))?\s*$/;
+var ALLOWED_TAGS = /* @__PURE__ */ new Set([
+  "planned",
+  "recalled",
+  "chained-from",
+  "dismissed",
+  "none"
 ]);
+function parseTag(rawTag) {
+  if (!rawTag) return "none";
+  const head = rawTag.trim().split(/[\s:]+/)[0].toLowerCase();
+  return ALLOWED_TAGS.has(head) ? head : "none";
+}
+function parseContractTail(tail) {
+  const result = { operators: [], skip_reason: null };
+  if (!tail) return result;
+  const tokens = tail.trim().split(/\s+/).filter((t) => t.length > 0);
+  for (const token of tokens) {
+    const skipMatch = token.match(/^skip:(.+)$/i);
+    if (skipMatch) {
+      if (result.skip_reason === null) result.skip_reason = skipMatch[1];
+      continue;
+    }
+    const notEditMatch = token.match(/^!edit:(.+)$/i);
+    if (notEditMatch) {
+      result.operators.push({ kind: "not_edit", target: notEditMatch[1] });
+      continue;
+    }
+    const opMatch = token.match(/^(edit|require|forbid):(.+)$/i);
+    if (opMatch) {
+      result.operators.push({
+        kind: opMatch[1].toLowerCase(),
+        target: opMatch[2]
+      });
+    }
+  }
+  return result;
+}
+function parseLine(line) {
+  const trimmed = line.trim();
+  if (trimmed.length === 0) return null;
+  if (SENTINEL_RE.test(trimmed)) {
+    return { id: null, tag: "none", commitment: null };
+  }
+  const fullMatch = trimmed.match(FULL_RE);
+  if (fullMatch) {
+    const id = fullMatch[1];
+    if (!ID_RE.test(id)) return null;
+    return {
+      id,
+      tag: parseTag(fullMatch[3]),
+      commitment: parseContractTail(fullMatch[4])
+    };
+  }
+  return null;
+}
+function parseCiteLine(raw) {
+  const result = {
+    cite_ids: [],
+    cite_tags: [],
+    cite_commitments: []
+  };
+  if (typeof raw !== "string") return result;
+  for (const line of raw.split(/\r?\n/)) {
+    const parsed = parseLine(line);
+    if (!parsed) continue;
+    result.cite_tags.push(parsed.tag);
+    if (parsed.id !== null) result.cite_ids.push(parsed.id);
+    if (parsed.commitment !== null) {
+      result.cite_commitments.push(parsed.commitment);
+    }
+  }
+  return result;
+}
 export {
   AGENTS_META_IDENTITY_SOURCES,
   AGENTS_META_LAYERS,
@@ -1165,6 +1332,8 @@ export {
   LEGACY_KB_REGEX,
   LayerSchema,
   MaturitySchema,
+  ONBOARD_SLOT_NAMES,
+  ONBOARD_SLOT_TOTAL,
   PROPOSED_REASON_DESCRIPTIONS,
   PROTECTED_TOKENS,
   ProposedReasonSchema,
@@ -1181,6 +1350,10 @@ export {
   auditModeSchema,
   bootstrapMarkerMigratedEventSchema,
   candidateFileEntrySchema,
+  citeContractMetricsSchema,
+  citeContractPolicyActivatedEventSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   citePolicyActivatedEventSchema,
   claudeHookPathMigratedEventSchema,
   claudeSkillPathMigratedEventSchema,
@@ -1218,9 +1391,6 @@ export {
   forensicSamplingBudgetSchema,
   forensicTopologySchema,
   formatKnowledgeId,
-  getKnowledgeAnnotations,
-  getKnowledgeInputSchema,
-  getKnowledgeOutputSchema,
   getPanelFieldByKey,
   getPanelFields,
   historyStateQuerySchema,
@@ -1245,6 +1415,7 @@ export {
   knowledgeDeferredEventSchema,
   knowledgeDemotedEventSchema,
   knowledgeDriftDetectedEventSchema,
+  knowledgeEnrichedEventSchema,
   knowledgeLayerChangedEventSchema,
   knowledgeMetaAutoHealedEventSchema,
   knowledgePathDangledEventSchema,
@@ -1276,6 +1447,8 @@ export {
   metaReconciledOnStartupEventSchema,
   metaUpdatedEventSchema,
   normalizeLocale,
+  onboardSlotSchema,
+  parseCiteLine,
   parseKnowledgeId,
   pendingAutoArchivedEventSchema,
   planContextAnnotations,
@@ -1287,6 +1460,8 @@ export {
   relevanceMigrationRunEventSchema,
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
+  serveLockClearedEventSchema,
+  sessionArchiveAttemptedEventSchema,
   structuredWarningSchema,
   withDerivedAgentsMetaNodeDefaults,
   zhCNMessages