@fenglimg/fabric-shared 2.3.0-rc.10 → 2.3.0-rc.12

package/dist/{chunk-TV264D7E.js → chunk-TEITGZY3.js}

@@ -49,16 +49,24 @@ var _knowledgeTypeEnum = z3.enum(["models", "decisions", "guidelines", "pitfalls
 var _maturityEnum = z3.enum(["draft", "verified", "proven"]);
 var _ruleDescriptionSchema = z3.object({
   summary: z3.string(),
-  intent_clues: z3.array(z3.string()),
+  // TASK-005 wire thinning: intent_clues dropped from recall wire (0 hook
+  // consumers grep-verified). Selection signal is summary + must_read_if
+  // (when distinct) + knowledge_type; intent_clues is preserved in the on-disk
+  // .md frontmatter (KB source-of-truth) and reachable via read_path.
+  intent_clues: z3.array(z3.string()).optional(),
   // wire-slim (payload): fab_recall projects a LEAN description (summary +
-  // must_read_if + intent_clues + knowledge_type — the selection signal), leaving
-  // tech_stack/impact to be Read on demand via read_path (KT-DEC-0026 lean
+  // must_read_if + knowledge_type — the selection signal), leaving tech_stack/
+  // impact/intent_clues to be Read on demand via read_path (KT-DEC-0026 lean
   // contract at the field level). So they are optional on the wire. plan-context
-  // still returns them in full — zod keeps optional-present values, only ABSENT is
-  // now allowed, so no plan-context consumer regresses.
+  // still returns them in full — zod keeps optional-present values, only ABSENT
+  // is now allowed, so no plan-context consumer regresses.
   tech_stack: z3.array(z3.string()).optional(),
   impact: z3.array(z3.string()).optional(),
-  must_read_if: z3.string(),
+  // TASK-002 wire dedup: omitted when identical to `summary` (~40% of KB entries
+  // — knowledge-meta-builder.ts:212/:248 `?? summary` fallback). Consumers may
+  // fall back to `summary` when absent. KB source-of-truth (the .md frontmatter)
+  // stays unchanged; this optionality is a WIRE-only projection.
+  must_read_if: z3.string().optional(),
   // v2.0: optional knowledge-entry fields. Absent for v1.x rules; present for
   // entries that declare frontmatter `id/type/maturity`. W4/Track1: the redundant
   // `knowledge_layer` field was removed — a candidate's layer is derived from its
@@ -310,28 +318,40 @@ var recallInputSchema = z3.object({
   // W1-3 / KT-DEC-0031: graph expansion (surface related read paths, no body).
   include_related: z3.boolean().optional().describe(
     "When true, also surface the one-hop `related` graph neighbours (of the surfaced entries) that are present in the candidate set \u2014 their descriptions and read paths, NOT their bodies."
+  ),
+  // TASK-006 (KT-PIT-0036 observability opt-in): score_breakdown carries the
+  // numbers-only signal decomposition (bm25/vector/salience/recency/locality/
+  // proximity/credibility → final). Emitted per-entry ONLY when this flag is
+  // true — the debug/tuning surface. Steady-state recall omits it to stay lean
+  // (~4.8KB saved on a 24-entry sample). final===score invariant still enforced
+  // at the plan-context service layer (candidate_scores Map) regardless.
+  include_score_breakdown: z3.boolean().optional().describe(
+    "When true, populate `entry.score_breakdown` (numbers-only signal decomposition \u2014 bm25/vector/salience/recency/locality/proximity/credibility \u2192 final). Off by default for wire efficiency. Enable when debugging ranking or tuning scoring weights."
   )
 });
+var _recallEntryDescriptionSchema = z3.object({
+  summary: z3.string(),
+  // TASK-002: omitted when identical to summary (~40% dedup).
+  must_read_if: z3.string().optional(),
+  // Semantic-preservation (PLN-002 F1 restored): knowledge-hint-narrow.cjs
+  // consumes this for the "⚠️ 后果" narrow-hint line.
+  impact: z3.array(z3.string()).optional(),
+  // Semantic-preservation (PLN-002): cite-contract-reminder.cjs consumes it.
+  knowledge_type: _knowledgeTypeEnum.optional()
+});
 var _recallEntrySchema = z3.object({
   stable_id: z3.string(),
-  // 1-based relevance rank (entries are returned best-first). The surfaced
-  // ranking signal — entries are already sorted, rank makes the order explicit.
-  rank: z3.number().int().positive(),
-  // The DESCRIPTION (summary / intent_clues / must_read_if / related ...). No body.
-  description: _ruleDescriptionSchema,
+  // The projected DESCRIPTION (recall-specific slim contract, not the shared
+  // frontmatter shape). Codex review F6: dedicated schema locks the wire contract.
+  description: _recallEntryDescriptionSchema,
   // on-disk knowledge file to Read for the full body. Omitted when the entry has
   // no resolvable file (description-only discovery) or was scoped out by `ids`.
   read_path: z3.string().optional(),
   // originating store alias (omitted for unqualified / single-store entries).
-  store: z3.object({ alias: z3.string() }).optional(),
+  store_alias: z3.string().optional(),
   // true when this entry's body is ALSO injected at SessionStart (broad
   // model/guideline "ALWAYS-ACTIVE") — skip the Read, it is already in context.
   body_in_context: z3.boolean().optional(),
-  // P1 recall-observability: the fused relevance score this entry scored during
-  // the plan-context sort (was computed internally but dropped before this wave).
-  // Optional + additive — backward-compatible. MUST be declared here or zod
-  // .strip() silently drops it at the MCP boundary (KT-PIT-0005).
-  score: z3.number().optional(),
   // P1 recall-observability: numbers-only decomposition of `score` into its
   // weighted signal contributions. NEVER carries body/description text — preserves
   // the lean read_path contract (KT-DEC-0019 / KT-GLD-0005). bm25_rank/vector_rank
@@ -355,25 +375,24 @@ var _recallEntrySchema = z3.object({
   }).optional()
 });
 var recallOutputSchema = z3.object({
+  // Retained: client hook cache key (packages/cli/.claude/hooks/knowledge-hint-narrow.cjs)
   revision_hash: z3.string(),
-  stale: z3.boolean(),
   // ux-w2-4: single unified entry list (was candidates[] + paths[] + per-path
   // requirement-profile entries[]). Each item carries description + read_path +
   // rank + body_in_context, so the agent never joins two arrays on stable_id.
   entries: z3.array(_recallEntrySchema),
-  // v2.2 payload de-dup: single top-level echo of the caller's `intent`.
-  // Omitted when no intent.
-  intent: z3.string().optional(),
   // K6 (W3-K): structured list of lower-ranked candidates dropped by the
-  // retrieval pipeline, each tagged with WHY (`retrieval_budget` = top_k cap +
-  // ratio-to-top floor; `payload_budget` = MCP payload-byte trim). Present (and
-  // non-empty) ONLY when truncation fired — keeps the steady-state wire shape
-  // unchanged while signalling which entries exist ("narrow your intent"), now
-  // with a controlled reason instead of a bare count. Reuses the archive-scan
-  // {key,reason} omission convention (_recallDropReasonSchema, keyed on id).
-  dropped: z3.array(z3.object({ id: z3.string(), reason: _recallDropReasonSchema })).optional(),
-  preflight_diagnostics: z3.array(_preflightDiagnosticSchema),
+  // retrieval pipeline. dropped_ids preserves per-id transparency (KT-DEC-0028);
+  // dropped_reasons hoists the reason to a top-level count map (68/68 same-reason
+  // observation from ANL-002). Present ONLY when truncation fired.
+  dropped_ids: z3.array(z3.string()).optional(),
+  dropped_reasons: z3.object({
+    retrieval_budget: z3.number().int().nonnegative().optional(),
+    payload_budget: z3.number().int().nonnegative().optional()
+  }).optional(),
+  preflight_diagnostics: z3.array(_preflightDiagnosticSchema).optional(),
   warnings: z3.array(structuredWarningSchema).optional(),
+  // Auto-heal banner pair (consumed by knowledge-hint-broad.cjs:711-729).
   auto_healed: z3.boolean().optional(),
   previous_revision_hash: z3.string().optional(),
   // v2.0.0-rc.37 NEW-24: parallel to planContextOutputSchema.redirects — stale
@@ -384,9 +403,6 @@ var recallOutputSchema = z3.object({
   // (appended id → surfaced source id). Present only when include_related
   // appended an in-corpus neighbour. Omitted on the steady-state path.
   related_appended: z3.record(z3.string()).optional(),
-  // v2.2 MC1-recall-pack: standing behavioral directive (cite-before-edit) +
-  // dynamic discovery hints, so the one-call recall is self-describing.
-  directive: z3.string(),
   next_steps: z3.array(z3.string()).optional()
 });
 var recallAnnotations = {
@@ -728,11 +744,45 @@ var FabReviewInputSchema = z3.discriminatedUnion("action", [
       layer: z3.enum(["team", "personal"])
     })
   }),
+  // v2.3 batch content-modify: array-native flush for the fabric-review maintain
+  // loop. Each item is an INDEPENDENT content edit — unlike approve/reject/defer
+  // (which share one reason/until over pending_paths[]), modify needs its OWN
+  // changes per entry, so the shape is items[] not paths[]. Layer is stripped
+  // per item (content-only; layer-flips stay on the single interactive
+  // modify-layer path). Per-item failure is isolated: a bad item reports
+  // {ok:false, error} in modified[] without aborting its siblings.
+  z3.object({
+    action: z3.literal("modify-content-batch"),
+    items: z3.array(
+      z3.object({
+        pending_path: z3.string().min(1),
+        changes: _fabReviewModifyChangesSchema
+      })
+    ).min(1)
+  }),
   z3.object({
     action: z3.literal("defer"),
     pending_paths: z3.array(z3.string()).min(1),
     until: z3.string().datetime().optional(),
     reason: z3.string().optional()
+  }),
+  // retire (W3-C: fabric-review retire-mode landing surface). Semantically
+  // deprecates one or more CANONICAL knowledge entries so they stop surfacing in
+  // recall candidates / broad SessionStart indexes — WITHOUT deleting the file
+  // (red line: deprecate-over-delete). The service writes `deprecated: true`
+  // (+ `superseded_by: <id>` when the entry is replaced) into the entry's
+  // frontmatter via the same in-place merge path modify uses; body + stable_id
+  // are preserved so the "当时为什么这么决策" rationale stays inspectable.
+  z3.object({
+    action: z3.literal("retire"),
+    // Canonical entry paths (store-absolute, from fab_pending list/search).
+    pending_paths: z3.array(z3.string()).min(1),
+    // Optional stable_id of the entry that supersedes these (bare `KT-DEC-0001`
+    // or store-qualified `alias:KT-DEC-0001`). Written as `superseded_by`
+    // frontmatter so the supersession chain is recoverable.
+    superseded_by: z3.string().optional(),
+    // Optional human reason recorded on the knowledge_modified ledger event.
+    reason: z3.string().optional()
   })
 ]);
 var FabPendingInputSchema = z3.discriminatedUnion("action", [
@@ -758,11 +808,20 @@ var FabPendingInputShape = {
   )
 };
 var FabReviewInputShape = {
-  action: z3.enum(["approve", "reject", "modify", "modify-content", "modify-layer", "defer"]).describe(
-    "Action selector. Discriminates the per-action fields below; required. modify-content edits scalars (no layer); modify-layer is the layer-flip path (changes.layer required); modify is the legacy combined alias. (list/search moved to the read-only fab_pending tool.)"
+  action: z3.enum([
+    "approve",
+    "reject",
+    "modify",
+    "modify-content",
+    "modify-layer",
+    "modify-content-batch",
+    "defer",
+    "retire"
+  ]).describe(
+    "Action selector. Discriminates the per-action fields below; required. modify-content edits scalars (no layer); modify-layer is the layer-flip path (changes.layer required); modify is the legacy combined alias; modify-content-batch flushes an array of independent content edits (items[]) in one call; retire marks canonical entries deprecated (deprecate-over-delete) so they stop surfacing. (list/search moved to the read-only fab_pending tool.)"
   ),
   pending_paths: z3.array(z3.string()).min(1).optional().describe(
-    "Workspace-relative pending entry paths. Required when action=approve|reject|defer (non-empty array)."
+    "Workspace-relative pending entry paths (or canonical entry paths for action=retire). Required when action=approve|reject|defer|retire (non-empty array)."
   ),
   pending_path: z3.string().min(1).optional().describe(
     "Workspace-relative pending OR canonical entry path. Required when action=modify."
@@ -773,8 +832,19 @@ var FabReviewInputShape = {
   changes: _fabReviewModifyChangesSchema.optional().describe(
     "Frontmatter scalar patches (title/summary/layer/maturity/tags/relevance_*/semantic_scope/related). Required when action=modify. semantic_scope re-scopes the entry's resolution coordinate in place (e.g. team \u2192 project:<id>) without moving stores; personal-root coordinates are rejected (use modify-layer)."
   ),
+  items: z3.array(
+    z3.object({
+      pending_path: z3.string().min(1),
+      changes: _fabReviewModifyChangesSchema
+    })
+  ).min(1).optional().describe(
+    "Batch of independent content edits \u2014 required (non-empty) when action=modify-content-batch. Each item {pending_path, changes} is applied content-only (layer stripped); per-item failures surface in modified[] without aborting siblings."
+  ),
   until: z3.string().datetime().optional().describe(
     "ISO-8601 datetime upper bound for the deferral. Optional; used only when action=defer."
+  ),
+  superseded_by: z3.string().optional().describe(
+    "Stable_id (bare or store-qualified) of the entry that supersedes the retired one, written as `superseded_by` frontmatter. Optional; used only when action=retire."
   )
 };
 var _fabReviewListItemSchema = z3.object({
@@ -851,10 +921,39 @@ var FabReviewOutputSchema = z3.discriminatedUnion("action", [
     new_stable_id: z3.string().optional(),
     warnings: z3.array(structuredWarningSchema).optional()
   }),
+  // v2.3 batch content-modify result: per-item {pending_path, ok, error?}. No
+  // prior/new_stable_id — content edits strip layer, so no id reallocation can
+  // occur. ok=false items carry the failure message; siblings still applied
+  // (partial failure is reported per-item, never thrown for the whole batch).
+  z3.object({
+    action: z3.literal("modify-content-batch"),
+    modified: z3.array(
+      z3.object({
+        pending_path: z3.string(),
+        ok: z3.boolean(),
+        error: z3.string().optional()
+      })
+    ),
+    warnings: z3.array(structuredWarningSchema).optional()
+  }),
   z3.object({
     action: z3.literal("defer"),
     deferred: z3.array(z3.string()),
     warnings: z3.array(structuredWarningSchema).optional()
+  }),
+  z3.object({
+    action: z3.literal("retire"),
+    // Each retired canonical entry: its echoed path + (when the frontmatter
+    // carried one) its stable_id, plus the superseded_by id when supplied. The
+    // file is NOT deleted — only marked `deprecated: true` in place.
+    retired: z3.array(
+      z3.object({
+        path: z3.string(),
+        stable_id: z3.string().optional(),
+        superseded_by: z3.string().optional()
+      })
+    ),
+    warnings: z3.array(structuredWarningSchema).optional()
   })
 ]);
 var FabPendingOutputSchema = z3.discriminatedUnion("action", [
@@ -879,7 +978,7 @@ var FabPendingOutputShape = {
   warnings: z3.array(structuredWarningSchema).optional()
 };
 var FabReviewOutputShape = {
-  action: z3.enum(["approve", "reject", "modify", "defer"]).describe(
+  action: z3.enum(["approve", "reject", "modify", "modify-content-batch", "defer", "retire"]).describe(
     "Echoes the input action; clients can switch on it for per-variant fields below. (list/search results moved to the read-only fab_pending tool.)"
   ),
   approved: z3.array(z3.object({ pending_path: z3.string(), stable_id: z3.string() })).optional().describe(
@@ -897,9 +996,27 @@ var FabReviewOutputShape = {
   new_stable_id: z3.string().optional().describe(
     "New stable id after reallocation. Present when action=modify AND a layer-flip reallocated the id."
   ),
+  modified: z3.array(
+    z3.object({
+      pending_path: z3.string(),
+      ok: z3.boolean(),
+      error: z3.string().optional()
+    })
+  ).optional().describe(
+    "Per-item results for action=modify-content-batch: {pending_path, ok, error?}. ok=false items carry the error; siblings still applied."
+  ),
   deferred: z3.array(z3.string()).optional().describe(
     "Pending paths that were deferred (files retained on disk). Present when action=defer."
   ),
+  retired: z3.array(
+    z3.object({
+      path: z3.string(),
+      stable_id: z3.string().optional(),
+      superseded_by: z3.string().optional()
+    })
+  ).optional().describe(
+    "Canonical entries marked deprecated in place (files retained \u2014 deprecate-over-delete). Present when action=retire."
+  ),
   // v2.0.0-rc.23 TASK-009 (d): optional warnings surface for the first-reconcile
   // gate (`meta_stale` / `reconcile_failed`). Absent on the steady-state path.
   warnings: z3.array(structuredWarningSchema).optional()

package/dist/{chunk-XRX6RVZY.js → chunk-YLIWE46B.js}

@@ -648,6 +648,13 @@ var enMessages = {
   "doctor.check.write_route_target_unbound.ok": "Every write_routes[*].store is present in required_stores; the scope\u2192store routing is statically consistent.",
   "doctor.check.write_route_target_unbound.message": '{count} write_route(s) point at an unbound store ({routes}); fab_propose on those scopes will report "no write-target store resolved".',
   "doctor.check.write_route_target_unbound.remediation": "Either \u2460 `fabric store bind <store>` to add the target to required_stores (under the single team slot rule this replaces the current one), or \u2461 edit `.fabric/fabric-config.json` to remove the stale write_route.",
+  // stray_fabric_dir_detected — rc.11 root-cause fix: server-side resolveProjectRoot used cwd,
+  // so a subprocess launched from a subdirectory created .fabric/ in the wrong place. This
+  // lint walks the project tree and reports every .fabric/ other than <root>/.fabric.
+  "doctor.check.stray_fabric_dir_detected.name": "Stray .fabric directories",
+  "doctor.check.stray_fabric_dir_detected.ok": "No stray .fabric directories under the project root \u2014 the only authoritative anchor is <projectRoot>/.fabric.",
+  "doctor.check.stray_fabric_dir_detected.message": "Found {count} stray .fabric director(ies) ({dirs}) left by subprocesses that mistook a subdirectory for the project root (pre-rc.10 hooks / pre-rc.11 server-side). These scatter events.jsonl / metrics.jsonl / .cache across the source tree.",
+  "doctor.check.stray_fabric_dir_detected.remediation": "Run `fabric doctor --fix` to rename each stray dir to `.fabric.stale-<timestamp>` (rescue-before-delete \u2014 never a hard delete). Review the renamed dirs before merging events. Also upgrade global fabric-cli to rc.11+ so the server-side git-anchor resolver is active.",
   "doctor.check.skill_md_yaml_invalid.name": "Skill markdown YAML",
   "doctor.check.skill_md_yaml_invalid.ok": "All .claude/.codex SKILL.md frontmatter values parse as strict YAML.",
   "doctor.check.skill_md_yaml_invalid.message.singular": "{count} SKILL.md frontmatter value contains an unquoted ': ' that strict YAML parsers reject (Claude Code tolerates it; Codex CLI drops the skill at load). First: {detail}.",
@@ -1962,6 +1969,12 @@ var zhCNMessages = {
   "doctor.check.write_route_target_unbound.ok": "\u6240\u6709 write_routes \u7684\u76EE\u6807 store \u90FD\u5728 required_stores \u5185,scope\u2192store \u8DEF\u7531\u9759\u6001\u4E00\u81F4\u3002",
   "doctor.check.write_route_target_unbound.message": '{count} \u6761 write_route \u6307\u5411\u672A\u7ED1\u5B9A\u7684 store({routes});fab_propose \u5728\u8FD9\u4E9B scope \u4E0A\u4F1A\u62A5 "no write-target store resolved"\u3002',
   "doctor.check.write_route_target_unbound.remediation": "\u4E8C\u9009\u4E00:\u2460 `fabric store bind <store>` \u628A\u76EE\u6807 store \u52A0\u8FDB required_stores(\u5355 team \u69FD = \u9700\u66FF\u6362\u6389\u5F53\u524D\u7684),\u6216 \u2461 \u7F16\u8F91 `.fabric/fabric-config.json` \u5220\u6389\u8FD9\u6761 write_route\u3002",
+  // stray_fabric_dir_detected — rc.11 root-cause fix: server-side resolveProjectRoot 之前用 cwd,
+  // 从子目录起的子进程会把 .fabric/ 建在错误的路径。此 lint 扫描项目树,找出 <root>/.fabric 之外的所有 .fabric/。
+  "doctor.check.stray_fabric_dir_detected.name": "\u6E38\u79BB .fabric \u76EE\u5F55",
+  "doctor.check.stray_fabric_dir_detected.ok": "\u9879\u76EE\u4E0B\u672A\u53D1\u73B0\u6E38\u79BB .fabric \u76EE\u5F55,\u552F\u4E00\u6743\u5A01\u6839 .fabric \u5C31\u662F <projectRoot>/.fabric\u3002",
+  "doctor.check.stray_fabric_dir_detected.message": "\u53D1\u73B0 {count} \u4E2A\u6E38\u79BB .fabric \u76EE\u5F55({dirs}),\u5B83\u4EEC\u662F\u5B50\u8FDB\u7A0B\u5728\u5B50\u76EE\u5F55\u88AB\u8BEF\u8BA4\u4F5C project root \u7684\u5386\u53F2\u9057\u7559(rc.10 \u4E4B\u524D\u7684 hook / rc.11 \u4E4B\u524D\u7684 server \u4FA7),\u4F1A\u5BFC\u81F4 events.jsonl / metrics.jsonl / .cache \u6563\u843D\u3002",
+  "doctor.check.stray_fabric_dir_detected.remediation": "\u8DD1 `fabric doctor --fix` \u4F1A\u628A\u6BCF\u4E2A\u6E38\u79BB dir \u6539\u540D\u4E3A `.fabric.stale-<timestamp>`(rescue-before-delete,\u4E0D\u786C\u5220)\u3002\u6539\u540D\u540E\u53EF\u4EBA\u5DE5\u6838\u5BF9\u662F\u5426\u9700\u8981\u5408\u5E76 events \u518D\u5220\u3002\u540C\u65F6\u5347\u7EA7\u672C\u673A fabric-cli \u81F3 rc.11+ \u8BA9 server \u4FA7 git-anchor \u751F\u6548\u3002",
   "doctor.check.skill_md_yaml_invalid.name": "Skill markdown YAML",
   "doctor.check.skill_md_yaml_invalid.ok": "\u6240\u6709 .claude/.codex SKILL.md frontmatter values \u90FD\u80FD\u6309 strict YAML \u89E3\u6790\u3002",
   "doctor.check.skill_md_yaml_invalid.message.singular": "{count} \u4E2A SKILL.md frontmatter value \u5305\u542B\u672A\u52A0\u5F15\u53F7\u7684 ': '\uFF0Cstrict YAML parsers \u4F1A\u62D2\u7EDD\uFF08Claude Code tolerates it\uFF1BCodex CLI drops the skill at load\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",

package/dist/i18n/index.js

@@ -5,7 +5,7 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "../chunk-XRX6RVZY.js";
+} from "../chunk-YLIWE46B.js";
 import {
   detectNodeLocale,
   normalizeLocale,

package/dist/index.d.ts

@@ -8431,7 +8431,6 @@ declare const llmJudgeRunEventSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     version: string;
-    score: number;
     ts: number;
     model: string;
     schema_version: 1;
@@ -8440,12 +8439,12 @@ declare const llmJudgeRunEventSchema: z.ZodObject<{
     event_type: "llm_judge_run";
     prompt: string;
     input_trace_id: string;
+    score: number;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }, {
     id: string;
     version: string;
-    score: number;
     ts: number;
     model: string;
     schema_version: 1;
@@ -8454,6 +8453,7 @@ declare const llmJudgeRunEventSchema: z.ZodObject<{
     event_type: "llm_judge_run";
     prompt: string;
     input_trace_id: string;
+    score: number;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
@@ -10599,7 +10599,6 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
 }, "strip", z.ZodTypeAny, {
     id: string;
     version: string;
-    score: number;
     ts: number;
     model: string;
     schema_version: 1;
@@ -10608,12 +10607,12 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     event_type: "llm_judge_run";
     prompt: string;
     input_trace_id: string;
+    score: number;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }, {
     id: string;
     version: string;
-    score: number;
     ts: number;
     model: string;
     schema_version: 1;
@@ -10622,6 +10621,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     event_type: "llm_judge_run";
     prompt: string;
     input_trace_id: string;
+    score: number;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>, z.ZodObject<{

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-XRX6RVZY.js";
+} from "./chunk-YLIWE46B.js";
 import {
   GLOBAL_BINDINGS_DIR,
   GLOBAL_STATE_DIR,
@@ -116,7 +116,7 @@ import {
   scopeCoordinateSchema,
   scopeRoot,
   structuredWarningSchema
-} from "./chunk-TV264D7E.js";
+} from "./chunk-TEITGZY3.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";

package/dist/schemas/api-contracts.d.ts

@@ -90,10 +90,10 @@ declare const planContextOutputSchema: z.ZodObject<{
         stable_id: z.ZodString;
         description: z.ZodObject<{
             summary: z.ZodString;
-            intent_clues: z.ZodArray<z.ZodString, "many">;
+            intent_clues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            must_read_if: z.ZodString;
+            must_read_if: z.ZodOptional<z.ZodString>;
             id: z.ZodOptional<z.ZodString>;
             knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
@@ -105,14 +105,14 @@ declare const planContextOutputSchema: z.ZodObject<{
             aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            intent_clues?: string[] | undefined;
             tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
@@ -120,14 +120,14 @@ declare const planContextOutputSchema: z.ZodObject<{
             aliases?: string[] | undefined;
         }, {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            intent_clues?: string[] | undefined;
             tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
@@ -138,14 +138,14 @@ declare const planContextOutputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            intent_clues?: string[] | undefined;
             tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
@@ -157,14 +157,14 @@ declare const planContextOutputSchema: z.ZodObject<{
     }, {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            intent_clues?: string[] | undefined;
             tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
@@ -241,14 +241,14 @@ declare const planContextOutputSchema: z.ZodObject<{
     candidates: {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            intent_clues?: string[] | undefined;
             tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
@@ -296,14 +296,14 @@ declare const planContextOutputSchema: z.ZodObject<{
     candidates: {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            intent_clues?: string[] | undefined;
             tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
@@ -568,6 +568,7 @@ declare const recallInputSchema: z.ZodObject<{
     target_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     include_related: z.ZodOptional<z.ZodBoolean>;
+    include_score_breakdown: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     paths: string[];
     known_tech?: string[] | undefined;
@@ -580,6 +581,7 @@ declare const recallInputSchema: z.ZodObject<{
     target_paths?: string[] | undefined;
     ids?: string[] | undefined;
     include_related?: boolean | undefined;
+    include_score_breakdown?: boolean | undefined;
 }, {
     paths: string[];
     known_tech?: string[] | undefined;
@@ -592,69 +594,31 @@ declare const recallInputSchema: z.ZodObject<{
     target_paths?: string[] | undefined;
     ids?: string[] | undefined;
     include_related?: boolean | undefined;
+    include_score_breakdown?: boolean | undefined;
 }>;
 declare const recallOutputSchema: z.ZodObject<{
     revision_hash: z.ZodString;
-    stale: z.ZodBoolean;
     entries: z.ZodArray<z.ZodObject<{
         stable_id: z.ZodString;
-        rank: z.ZodNumber;
         description: z.ZodObject<{
             summary: z.ZodString;
-            intent_clues: z.ZodArray<z.ZodString, "many">;
-            tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            must_read_if: z.ZodOptional<z.ZodString>;
             impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            must_read_if: z.ZodString;
-            id: z.ZodOptional<z.ZodString>;
             knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
-            maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
-            created_at: z.ZodOptional<z.ZodString>;
-            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
-            relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
-            created_at?: string | undefined;
-            id?: string | undefined;
-            relevance_scope?: "narrow" | "broad" | undefined;
-            relevance_paths?: string[] | undefined;
-            tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
-            maturity?: "draft" | "verified" | "proven" | undefined;
-            tags?: string[] | undefined;
-            related?: string[] | undefined;
-            aliases?: string[] | undefined;
         }, {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
-            created_at?: string | undefined;
-            id?: string | undefined;
-            relevance_scope?: "narrow" | "broad" | undefined;
-            relevance_paths?: string[] | undefined;
-            tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
-            maturity?: "draft" | "verified" | "proven" | undefined;
-            tags?: string[] | undefined;
-            related?: string[] | undefined;
-            aliases?: string[] | undefined;
         }>;
         read_path: z.ZodOptional<z.ZodString>;
-        store: z.ZodOptional<z.ZodObject<{
-            alias: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            alias: string;
-        }, {
-            alias: string;
-        }>>;
+        store_alias: z.ZodOptional<z.ZodString>;
         body_in_context: z.ZodOptional<z.ZodBoolean>;
-        score: z.ZodOptional<z.ZodNumber>;
         score_breakdown: z.ZodOptional<z.ZodObject<{
             final: z.ZodNumber;
             bm25: z.ZodOptional<z.ZodNumber>;
@@ -692,28 +656,14 @@ declare const recallOutputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
-            created_at?: string | undefined;
-            id?: string | undefined;
-            relevance_scope?: "narrow" | "broad" | undefined;
-            relevance_paths?: string[] | undefined;
-            tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
-            maturity?: "draft" | "verified" | "proven" | undefined;
-            tags?: string[] | undefined;
-            related?: string[] | undefined;
-            aliases?: string[] | undefined;
         };
         stable_id: string;
-        rank: number;
-        store?: {
-            alias: string;
-        } | undefined;
         read_path?: string | undefined;
+        store_alias?: string | undefined;
         body_in_context?: boolean | undefined;
-        score?: number | undefined;
         score_breakdown?: {
             final: number;
             salience: number;
@@ -729,28 +679,14 @@ declare const recallOutputSchema: z.ZodObject<{
     }, {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
-            created_at?: string | undefined;
-            id?: string | undefined;
-            relevance_scope?: "narrow" | "broad" | undefined;
-            relevance_paths?: string[] | undefined;
-            tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
-            maturity?: "draft" | "verified" | "proven" | undefined;
-            tags?: string[] | undefined;
-            related?: string[] | undefined;
-            aliases?: string[] | undefined;
         };
         stable_id: string;
-        rank: number;
-        store?: {
-            alias: string;
-        } | undefined;
         read_path?: string | undefined;
+        store_alias?: string | undefined;
         body_in_context?: boolean | undefined;
-        score?: number | undefined;
         score_breakdown?: {
             final: number;
             salience: number;
@@ -764,18 +700,18 @@ declare const recallOutputSchema: z.ZodObject<{
             credibility?: number | undefined;
         } | undefined;
     }>, "many">;
-    intent: z.ZodOptional<z.ZodString>;
-    dropped: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        reason: z.ZodEnum<["retrieval_budget", "payload_budget"]>;
+    dropped_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dropped_reasons: z.ZodOptional<z.ZodObject<{
+        retrieval_budget: z.ZodOptional<z.ZodNumber>;
+        payload_budget: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        id: string;
-        reason: "retrieval_budget" | "payload_budget";
+        retrieval_budget?: number | undefined;
+        payload_budget?: number | undefined;
     }, {
-        id: string;
-        reason: "retrieval_budget" | "payload_budget";
-    }>, "many">>;
-    preflight_diagnostics: z.ZodArray<z.ZodObject<{
+        retrieval_budget?: number | undefined;
+        payload_budget?: number | undefined;
+    }>>;
+    preflight_diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodEnum<["missing_description", "empty_shell_suppressed"]>;
         severity: z.ZodLiteral<"warn">;
         message: z.ZodString;
@@ -793,7 +729,7 @@ declare const recallOutputSchema: z.ZodObject<{
         severity: "warn";
         path?: string | undefined;
         stable_ids?: string[] | undefined;
-    }>, "many">;
+    }>, "many">>;
     warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         file: z.ZodString;
@@ -817,34 +753,19 @@ declare const recallOutputSchema: z.ZodObject<{
     previous_revision_hash: z.ZodOptional<z.ZodString>;
     redirects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     related_appended: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    directive: z.ZodString;
     next_steps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     entries: {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
-            created_at?: string | undefined;
-            id?: string | undefined;
-            relevance_scope?: "narrow" | "broad" | undefined;
-            relevance_paths?: string[] | undefined;
-            tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
-            maturity?: "draft" | "verified" | "proven" | undefined;
-            tags?: string[] | undefined;
-            related?: string[] | undefined;
-            aliases?: string[] | undefined;
         };
         stable_id: string;
-        rank: number;
-        store?: {
-            alias: string;
-        } | undefined;
         read_path?: string | undefined;
+        store_alias?: string | undefined;
         body_in_context?: boolean | undefined;
-        score?: number | undefined;
         score_breakdown?: {
             final: number;
             salience: number;
@@ -858,20 +779,13 @@ declare const recallOutputSchema: z.ZodObject<{
             credibility?: number | undefined;
         } | undefined;
     }[];
-    stale: boolean;
     revision_hash: string;
-    preflight_diagnostics: {
+    preflight_diagnostics?: {
         code: "missing_description" | "empty_shell_suppressed";
         message: string;
         severity: "warn";
         path?: string | undefined;
         stable_ids?: string[] | undefined;
-    }[];
-    directive: string;
-    intent?: string | undefined;
-    dropped?: {
-        id: string;
-        reason: "retrieval_budget" | "payload_budget";
     }[] | undefined;
     warnings?: {
         code: string;
@@ -884,33 +798,24 @@ declare const recallOutputSchema: z.ZodObject<{
     previous_revision_hash?: string | undefined;
     redirects?: Record<string, string> | undefined;
     related_appended?: Record<string, string> | undefined;
+    dropped_ids?: string[] | undefined;
+    dropped_reasons?: {
+        retrieval_budget?: number | undefined;
+        payload_budget?: number | undefined;
+    } | undefined;
     next_steps?: string[] | undefined;
 }, {
     entries: {
         description: {
             summary: string;
-            intent_clues: string[];
-            must_read_if: string;
-            created_at?: string | undefined;
-            id?: string | undefined;
-            relevance_scope?: "narrow" | "broad" | undefined;
-            relevance_paths?: string[] | undefined;
-            tech_stack?: string[] | undefined;
             impact?: string[] | undefined;
+            must_read_if?: string | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
-            maturity?: "draft" | "verified" | "proven" | undefined;
-            tags?: string[] | undefined;
-            related?: string[] | undefined;
-            aliases?: string[] | undefined;
         };
         stable_id: string;
-        rank: number;
-        store?: {
-            alias: string;
-        } | undefined;
         read_path?: string | undefined;
+        store_alias?: string | undefined;
         body_in_context?: boolean | undefined;
-        score?: number | undefined;
         score_breakdown?: {
             final: number;
             salience: number;
@@ -924,20 +829,13 @@ declare const recallOutputSchema: z.ZodObject<{
             credibility?: number | undefined;
         } | undefined;
     }[];
-    stale: boolean;
     revision_hash: string;
-    preflight_diagnostics: {
+    preflight_diagnostics?: {
         code: "missing_description" | "empty_shell_suppressed";
         message: string;
         severity: "warn";
         path?: string | undefined;
         stable_ids?: string[] | undefined;
-    }[];
-    directive: string;
-    intent?: string | undefined;
-    dropped?: {
-        id: string;
-        reason: "retrieval_budget" | "payload_budget";
     }[] | undefined;
     warnings?: {
         code: string;
@@ -950,6 +848,11 @@ declare const recallOutputSchema: z.ZodObject<{
     previous_revision_hash?: string | undefined;
     redirects?: Record<string, string> | undefined;
     related_appended?: Record<string, string> | undefined;
+    dropped_ids?: string[] | undefined;
+    dropped_reasons?: {
+        retrieval_budget?: number | undefined;
+        payload_budget?: number | undefined;
+    } | undefined;
     next_steps?: string[] | undefined;
 }>;
 declare const recallAnnotations: {
@@ -1463,6 +1366,121 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
         related?: string[] | undefined;
         title?: string | undefined;
     };
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"modify-content-batch">;
+    items: z.ZodArray<z.ZodObject<{
+        pending_path: z.ZodString;
+        changes: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
+            maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
+            relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            semantic_scope: z.ZodOptional<z.ZodString>;
+            related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            must_read_if: z.ZodOptional<z.ZodString>;
+            intent_clues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        }, {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        pending_path: string;
+        changes: {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        };
+    }, {
+        pending_path: string;
+        changes: {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        };
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    action: "modify-content-batch";
+    items: {
+        pending_path: string;
+        changes: {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        };
+    }[];
+}, {
+    action: "modify-content-batch";
+    items: {
+        pending_path: string;
+        changes: {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        };
+    }[];
 }>, z.ZodObject<{
     action: z.ZodLiteral<"defer">;
     pending_paths: z.ZodArray<z.ZodString, "many">;
@@ -1478,6 +1496,21 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
     pending_paths: string[];
     reason?: string | undefined;
     until?: string | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"retire">;
+    pending_paths: z.ZodArray<z.ZodString, "many">;
+    superseded_by: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "retire";
+    pending_paths: string[];
+    reason?: string | undefined;
+    superseded_by?: string | undefined;
+}, {
+    action: "retire";
+    pending_paths: string[];
+    reason?: string | undefined;
+    superseded_by?: string | undefined;
 }>]>;
 type FabReviewInput = z.infer<typeof FabReviewInputSchema>;
 declare const FabPendingInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
@@ -1626,7 +1659,7 @@ declare const FabPendingInputShape: {
     readonly query: z.ZodOptional<z.ZodString>;
 };
 declare const FabReviewInputShape: {
-    readonly action: z.ZodEnum<["approve", "reject", "modify", "modify-content", "modify-layer", "defer"]>;
+    readonly action: z.ZodEnum<["approve", "reject", "modify", "modify-content", "modify-layer", "modify-content-batch", "defer", "retire"]>;
     readonly pending_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     readonly pending_path: z.ZodOptional<z.ZodString>;
     readonly reason: z.ZodOptional<z.ZodString>;
@@ -1670,7 +1703,83 @@ declare const FabReviewInputShape: {
         related?: string[] | undefined;
         title?: string | undefined;
     }>>;
+    readonly items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pending_path: z.ZodString;
+        changes: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
+            maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
+            relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            semantic_scope: z.ZodOptional<z.ZodString>;
+            related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            must_read_if: z.ZodOptional<z.ZodString>;
+            intent_clues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        }, {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        pending_path: string;
+        changes: {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        };
+    }, {
+        pending_path: string;
+        changes: {
+            semantic_scope?: string | undefined;
+            relevance_scope?: "narrow" | "broad" | undefined;
+            relevance_paths?: string[] | undefined;
+            layer?: "personal" | "team" | undefined;
+            summary?: string | undefined;
+            intent_clues?: string[] | undefined;
+            impact?: string[] | undefined;
+            must_read_if?: string | undefined;
+            maturity?: "draft" | "verified" | "proven" | undefined;
+            tags?: string[] | undefined;
+            related?: string[] | undefined;
+            title?: string | undefined;
+        };
+    }>, "many">>;
     readonly until: z.ZodOptional<z.ZodString>;
+    readonly superseded_by: z.ZodOptional<z.ZodString>;
 };
 declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
     action: z.ZodLiteral<"approve">;
@@ -1819,6 +1928,68 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
     }[] | undefined;
     prior_stable_id?: string | undefined;
     new_stable_id?: string | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"modify-content-batch">;
+    modified: z.ZodArray<z.ZodObject<{
+        pending_path: z.ZodString;
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ok: boolean;
+        pending_path: string;
+        error?: string | undefined;
+    }, {
+        ok: boolean;
+        pending_path: string;
+        error?: string | undefined;
+    }>, "many">;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodOptional<z.ZodString>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }, {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    action: "modify-content-batch";
+    modified: {
+        ok: boolean;
+        pending_path: string;
+        error?: string | undefined;
+    }[];
+    warnings?: {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }[] | undefined;
+}, {
+    action: "modify-content-batch";
+    modified: {
+        ok: boolean;
+        pending_path: string;
+        error?: string | undefined;
+    }[];
+    warnings?: {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }[] | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"defer">;
     deferred: z.ZodArray<z.ZodString, "many">;
@@ -1861,6 +2032,68 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         message?: string | undefined;
         line?: number | undefined;
     }[] | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"retire">;
+    retired: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        stable_id: z.ZodOptional<z.ZodString>;
+        superseded_by: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        stable_id?: string | undefined;
+        superseded_by?: string | undefined;
+    }, {
+        path: string;
+        stable_id?: string | undefined;
+        superseded_by?: string | undefined;
+    }>, "many">;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodOptional<z.ZodString>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }, {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    action: "retire";
+    retired: {
+        path: string;
+        stable_id?: string | undefined;
+        superseded_by?: string | undefined;
+    }[];
+    warnings?: {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }[] | undefined;
+}, {
+    action: "retire";
+    retired: {
+        path: string;
+        stable_id?: string | undefined;
+        superseded_by?: string | undefined;
+    }[];
+    warnings?: {
+        code: string;
+        file: string;
+        action_hint: string;
+        message?: string | undefined;
+        line?: number | undefined;
+    }[] | undefined;
 }>]>;
 type FabReviewOutput = z.infer<typeof FabReviewOutputSchema>;
 declare const FabPendingOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
@@ -2197,7 +2430,7 @@ declare const FabPendingOutputShape: {
     }>, "many">>;
 };
 declare const FabReviewOutputShape: {
-    readonly action: z.ZodEnum<["approve", "reject", "modify", "defer"]>;
+    readonly action: z.ZodEnum<["approve", "reject", "modify", "modify-content-batch", "defer", "retire"]>;
     readonly approved: z.ZodOptional<z.ZodArray<z.ZodObject<{
         pending_path: z.ZodString;
         stable_id: z.ZodString;
@@ -2212,7 +2445,33 @@ declare const FabReviewOutputShape: {
     readonly pending_path: z.ZodOptional<z.ZodString>;
     readonly prior_stable_id: z.ZodOptional<z.ZodString>;
     readonly new_stable_id: z.ZodOptional<z.ZodString>;
+    readonly modified: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pending_path: z.ZodString;
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ok: boolean;
+        pending_path: string;
+        error?: string | undefined;
+    }, {
+        ok: boolean;
+        pending_path: string;
+        error?: string | undefined;
+    }>, "many">>;
     readonly deferred: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    readonly retired: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        stable_id: z.ZodOptional<z.ZodString>;
+        superseded_by: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        stable_id?: string | undefined;
+        superseded_by?: string | undefined;
+    }, {
+        path: string;
+        stable_id?: string | undefined;
+        superseded_by?: string | undefined;
+    }>, "many">>;
     readonly warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         file: z.ZodString;

package/dist/schemas/api-contracts.js

@@ -47,7 +47,7 @@ import {
   recallInputSchema,
   recallOutputSchema,
   structuredWarningSchema
-} from "../chunk-TV264D7E.js";
+} from "../chunk-TEITGZY3.js";
 export {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.3.0-rc.10",
+  "version": "2.3.0-rc.12",
   "description": "Fabric shared types — Zod schemas, i18n, atomic-write helpers, MCP payload guard, error classes. Consumed by @fenglimg/fabric-server + @fenglimg/fabric-cli.",
   "license": "MIT",
   "author": "wangzhichao <fenglimg90@gmail.com>",