@fenglimg/fabric-shared 2.0.0-rc.1 → 2.0.0-rc.8

package/dist/schemas/api-contracts.js

@@ -1,52 +1,74 @@
 import {
+  FabExtractKnowledgeInputSchema,
+  FabExtractKnowledgeInputShape,
+  FabExtractKnowledgeOutputSchema,
+  FabReviewInputSchema,
+  FabReviewOutputSchema,
   KNOWLEDGE_TYPE_CODES,
   KnowledgeEntryFrontmatterSchema,
   KnowledgeTypeSchema,
   LayerSchema,
   MaturitySchema,
+  PROPOSED_REASON_DESCRIPTIONS,
+  ProposedReasonSchema,
   StableIdSchema,
   annotateIntentRequestSchema,
+  fabExtractKnowledgeAnnotations,
+  fabReviewAnnotations,
   formatKnowledgeId,
-  getRulesAnnotations,
-  getRulesInputSchema,
-  getRulesOutputSchema,
+  getKnowledgeAnnotations,
+  getKnowledgeInputSchema,
+  getKnowledgeOutputSchema,
   historyStateQuerySchema,
   humanLockApproveRequestSchema,
   humanLockFileParamsSchema,
+  knowledgeSectionsAnnotations,
+  knowledgeSectionsInputSchema,
+  knowledgeSectionsOutputSchema,
   ledgerQuerySchema,
   ledgerSourceSchema,
   parseKnowledgeId,
   planContextAnnotations,
+  planContextHintNarrowEntrySchema,
+  planContextHintOutputSchema,
   planContextInputSchema,
   planContextOutputSchema,
-  ruleSectionsAnnotations,
-  ruleSectionsInputSchema,
-  ruleSectionsOutputSchema,
   structuredWarningSchema
-} from "../chunk-HACPXMLL.js";
+} from "../chunk-VQDCDCJA.js";
 export {
+  FabExtractKnowledgeInputSchema,
+  FabExtractKnowledgeInputShape,
+  FabExtractKnowledgeOutputSchema,
+  FabReviewInputSchema,
+  FabReviewOutputSchema,
   KNOWLEDGE_TYPE_CODES,
   KnowledgeEntryFrontmatterSchema,
   KnowledgeTypeSchema,
   LayerSchema,
   MaturitySchema,
+  PROPOSED_REASON_DESCRIPTIONS,
+  ProposedReasonSchema,
   StableIdSchema,
   annotateIntentRequestSchema,
+  fabExtractKnowledgeAnnotations,
+  fabReviewAnnotations,
   formatKnowledgeId,
-  getRulesAnnotations,
-  getRulesInputSchema,
-  getRulesOutputSchema,
+  getKnowledgeAnnotations,
+  getKnowledgeInputSchema,
+  getKnowledgeOutputSchema,
   historyStateQuerySchema,
   humanLockApproveRequestSchema,
   humanLockFileParamsSchema,
+  knowledgeSectionsAnnotations,
+  knowledgeSectionsInputSchema,
+  knowledgeSectionsOutputSchema,
   ledgerQuerySchema,
   ledgerSourceSchema,
   parseKnowledgeId,
   planContextAnnotations,
+  planContextHintNarrowEntrySchema,
+  planContextHintOutputSchema,
   planContextInputSchema,
   planContextOutputSchema,
-  ruleSectionsAnnotations,
-  ruleSectionsInputSchema,
-  ruleSectionsOutputSchema,
   structuredWarningSchema
 };

package/dist/types/index.d.ts

@@ -16,6 +16,8 @@ interface RuleDescription {
     layer_reason?: string;
     created_at?: string;
     tags?: string[];
+    relevance_scope?: "narrow" | "broad";
+    relevance_paths?: string[];
 }
 interface RuleDescriptionIndexItem {
     stable_id: string;
@@ -27,6 +29,8 @@ interface RuleDescriptionIndexItem {
     maturity?: "draft" | "verified" | "proven";
     layer?: "personal" | "team";
     layer_reason?: string;
+    relevance_scope?: "narrow" | "broad";
+    relevance_paths?: string[];
 }
 interface AgentsMetaNodeActivation {
     tier: AgentsActivationTier;
@@ -36,17 +40,17 @@ interface AgentsMetaNode {
     file: string;
     content_ref?: string;
     scope_glob: string;
-    deps: string[];
-    priority: "high" | "medium" | "low";
-    level?: AgentsLayer;
-    layer: AgentsLayer;
-    topology_type: AgentsTopologyType;
     hash: string;
     stable_id?: string;
     identity_source?: AgentsIdentitySource;
     activation?: AgentsMetaNodeActivation;
     description?: RuleDescription;
     sections?: string[];
+    deps?: string[];
+    priority?: "high" | "medium" | "low";
+    level?: AgentsLayer;
+    layer?: AgentsLayer;
+    topology_type?: AgentsTopologyType;
 }
 interface AgentsMetaKnowledgeTypeCounters {
     MOD: number;
@@ -103,6 +107,8 @@ interface McpPayloadLimits {
     warnBytes?: number;
     hardBytes?: number;
 }
+type KnowledgeLanguage = "match-existing" | "zh-CN" | "en";
+type DefaultLayerFilter = "team" | "personal" | "both";
 interface FabricConfig {
     clientPaths?: ClientPaths;
     externalFixturePath?: string;
@@ -110,6 +116,8 @@ interface FabricConfig {
     auditMode?: AuditMode;
     audit_mode?: AuditMode;
     mcpPayloadLimits?: McpPayloadLimits;
+    knowledge_language?: KnowledgeLanguage;
+    default_layer_filter?: DefaultLayerFilter;
 }
 
-export type { AgentsActivationTier, AgentsIdentitySource, AgentsLayer, AgentsMeta, AgentsMetaCountersEnvelope, AgentsMetaKnowledgeTypeCounters, AgentsMetaNode, AgentsMetaNodeActivation, AgentsTopologyType, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry, HumanLockEntry, LedgerEntry, McpPayloadLimits, RuleDescription, RuleDescriptionIndexItem };
+export type { AgentsActivationTier, AgentsIdentitySource, AgentsLayer, AgentsMeta, AgentsMetaCountersEnvelope, AgentsMetaKnowledgeTypeCounters, AgentsMetaNode, AgentsMetaNodeActivation, AgentsTopologyType, AiLedgerEntry, AuditMode, ClientPaths, DefaultLayerFilter, FabricConfig, HumanLedgerEntry, HumanLockEntry, KnowledgeLanguage, LedgerEntry, McpPayloadLimits, RuleDescription, RuleDescriptionIndexItem };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0-rc.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/chunk-HACPXMLL.js

@@ -1,314 +0,0 @@
-// src/schemas/api-contracts.ts
-import { z } from "zod";
-var structuredWarningSchema = z.object({
-  code: z.string(),
-  file: z.string(),
-  line: z.number().optional(),
-  action_hint: z.string()
-});
-var _knowledgeTypeEnum = z.enum(["model", "decision", "guideline", "pitfall", "process"]);
-var _maturityEnum = z.enum(["draft", "verified", "proven"]);
-var _layerEnum = z.enum(["personal", "team"]);
-var _ruleDescriptionSchema = z.object({
-  summary: z.string(),
-  intent_clues: z.array(z.string()),
-  tech_stack: z.array(z.string()),
-  impact: z.array(z.string()),
-  must_read_if: z.string(),
-  entities: z.array(z.string()).optional(),
-  // v2.0: optional knowledge-entry fields. Absent for v1.x rules; present for
-  // entries that declare frontmatter `id/type/maturity/layer`.
-  id: z.string().optional(),
-  knowledge_type: _knowledgeTypeEnum.optional(),
-  maturity: _maturityEnum.optional(),
-  knowledge_layer: _layerEnum.optional(),
-  layer_reason: z.string().optional(),
-  created_at: z.string().optional()
-});
-var _descriptionIndexItemSchema = z.object({
-  stable_id: z.string(),
-  level: z.enum(["L0", "L1", "L2"]),
-  required: z.boolean(),
-  selectable: z.boolean(),
-  description: _ruleDescriptionSchema,
-  // v2.0: top-level knowledge surface for client-side filtering. Mirrors
-  // description.* — exposed here so MCP clients can filter without reaching
-  // into the nested payload.
-  type: _knowledgeTypeEnum.optional(),
-  maturity: _maturityEnum.optional(),
-  layer: _layerEnum.optional(),
-  layer_reason: z.string().optional()
-});
-var _requirementProfileSchema = z.object({
-  target_path: z.string(),
-  path_segments: z.array(z.string()),
-  extension: z.string(),
-  inferred_domain: z.array(z.string()),
-  known_tech: z.array(z.string()),
-  user_intent: z.string(),
-  intent_tokens: z.array(z.string()),
-  impact_hints: z.array(z.string()),
-  detected_entities: z.array(z.string())
-});
-var _selectionPolicySchema = z.object({
-  required_levels: z.tuple([z.literal("L0"), z.literal("L2")]),
-  ai_selectable_levels: z.tuple([z.literal("L1")]),
-  final_fetch_rule: z.literal("required_stable_ids + ai_selected_l1_stable_ids")
-});
-var planContextInputSchema = z.object({
-  paths: z.array(z.string()).min(1).describe("Candidate file paths to build neutral rule selection context for"),
-  intent: z.string().optional().describe("User-stated requirement or implementation intent; used only to build a neutral requirement profile"),
-  known_tech: z.array(z.string()).optional().describe("Known technologies involved in the requirement profile"),
-  detected_entities: z.record(z.array(z.string())).optional().describe("Optional path-keyed detected entities for the requirement profile"),
-  client_hash: z.string().optional().describe("Revision hash from a prior fab_plan_context response; enables stale detection"),
-  correlation_id: z.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
-  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records"),
-  include_deprecated: z.boolean().optional().describe(
-    "When true, include description_index entries with maturity='deprecated'. Defaults to false (deprecated entries hidden). Note: 'deprecated' is reserved future state \u2014 today this filter is a no-op until MaturitySchema is widened."
-  )
-});
-var planContextOutputSchema = z.object({
-  revision_hash: z.string(),
-  stale: z.boolean(),
-  selection_token: z.string(),
-  entries: z.array(
-    z.object({
-      path: z.string(),
-      requirement_profile: _requirementProfileSchema,
-      description_index: z.array(_descriptionIndexItemSchema),
-      required_stable_ids: z.array(z.string()),
-      ai_selectable_stable_ids: z.array(z.string()),
-      initial_selected_stable_ids: z.array(z.string()),
-      selection_policy: _selectionPolicySchema
-    })
-  ),
-  shared: z.object({
-    required_stable_ids: z.array(z.string()),
-    ai_selectable_stable_ids: z.array(z.string()),
-    description_index: z.array(_descriptionIndexItemSchema),
-    preflight_diagnostics: z.array(
-      z.object({
-        code: z.literal("missing_description"),
-        severity: z.literal("warn"),
-        message: z.string(),
-        stable_ids: z.array(z.string()).optional(),
-        path: z.string().optional()
-      })
-    )
-  }),
-  warnings: z.array(structuredWarningSchema).optional()
-});
-var planContextAnnotations = {
-  readOnlyHint: true,
-  idempotentHint: true,
-  destructiveHint: false,
-  openWorldHint: false,
-  title: "Plan rule context"
-};
-var _rulesEntrySchema = z.object({ path: z.string(), content: z.string() });
-var _humanLockedSchema = z.object({ file: z.string(), excerpt: z.string() });
-var _descriptionStubSchema = z.object({ path: z.string(), description: z.string() });
-var getRulesInputSchema = z.object({
-  path: z.string().describe("Target file path to query rules for"),
-  client_hash: z.string().optional().describe("Revision hash from prior fab_get_rules response; enables stale detection"),
-  correlation_id: z.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
-  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records")
-});
-var getRulesOutputSchema = z.object({
-  revision_hash: z.string(),
-  stale: z.boolean(),
-  rules: z.object({
-    L0: z.string(),
-    L1: z.array(_rulesEntrySchema),
-    L2: z.array(_rulesEntrySchema),
-    human_locked_nearby: z.array(_humanLockedSchema),
-    description_stubs: z.array(_descriptionStubSchema).optional()
-  }),
-  warnings: z.array(structuredWarningSchema).optional()
-});
-var getRulesAnnotations = {
-  readOnlyHint: true,
-  idempotentHint: true,
-  destructiveHint: false,
-  openWorldHint: false,
-  title: "Get rule content"
-};
-var RULE_SECTION_NAMES_TUPLE = ["MISSION_STATEMENT", "MANDATORY_INJECTION", "BUSINESS_LOGIC_CHUNKS", "CONTEXT_INFO"];
-var ruleSectionsInputSchema = z.object({
-  selection_token: z.string().min(1).describe("Selection token returned by fab_plan_context"),
-  sections: z.array(z.enum(RULE_SECTION_NAMES_TUPLE)).min(1).describe("Structured rule sections to fetch"),
-  ai_selected_stable_ids: z.array(z.string()).describe("AI-selected L1 stable_ids chosen from fab_plan_context ai_selectable_stable_ids"),
-  ai_selection_reasons: z.record(z.string().min(1)).describe("Reason for each AI-selected L1 stable_id"),
-  correlation_id: z.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
-  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records")
-});
-var ruleSectionsOutputSchema = z.object({
-  revision_hash: z.string(),
-  precedence: z.tuple([z.literal("L2"), z.literal("L1"), z.literal("L0")]),
-  selected_stable_ids: z.array(z.string()),
-  rules: z.array(
-    z.object({
-      stable_id: z.string(),
-      level: z.enum(["L0", "L1", "L2"]),
-      path: z.string(),
-      sections: z.record(z.string())
-    })
-  ),
-  diagnostics: z.array(
-    z.discriminatedUnion("code", [
-      z.object({
-        code: z.literal("missing_section"),
-        severity: z.literal("warn"),
-        stable_id: z.string(),
-        section: z.enum(RULE_SECTION_NAMES_TUPLE),
-        message: z.string()
-      }),
-      // v2.0: warn-level diagnostic for un-migrated v1.x entries (no
-      // knowledge_type and no knowledge_layer). Does NOT block selection.
-      z.object({
-        code: z.literal("missing_knowledge_metadata"),
-        severity: z.literal("warn"),
-        stable_id: z.string(),
-        message: z.string()
-      })
-    ])
-  ),
-  warnings: z.array(structuredWarningSchema).optional()
-});
-var ruleSectionsAnnotations = {
-  readOnlyHint: true,
-  idempotentHint: true,
-  destructiveHint: false,
-  openWorldHint: false,
-  title: "Filter rule sections"
-};
-var ledgerSourceSchema = z.enum(["ai", "human"]);
-var timestampFilterSchema = z.preprocess((value) => {
-  if (value === void 0 || value === null || value === "") {
-    return void 0;
-  }
-  if (typeof value === "number") {
-    return value;
-  }
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-      return void 0;
-    }
-    if (/^\d+$/.test(trimmed)) {
-      return Number.parseInt(trimmed, 10);
-    }
-    const parsed = Date.parse(trimmed);
-    return Number.isNaN(parsed) ? value : parsed;
-  }
-  return value;
-}, z.number().int().nonnegative());
-var ledgerQuerySchema = z.object({
-  source: ledgerSourceSchema.optional(),
-  since: timestampFilterSchema.optional()
-});
-var historyStateQuerySchema = z.object({
-  ledger_id: z.string().trim().min(1).optional(),
-  ts: timestampFilterSchema.optional()
-}).superRefine((value, ctx) => {
-  const provided = [value.ledger_id, value.ts].filter((entry) => entry !== void 0);
-  if (provided.length !== 1) {
-    ctx.addIssue({
-      code: z.ZodIssueCode.custom,
-      message: "Provide exactly one of ledger_id or ts.",
-      path: ["ledger_id"]
-    });
-  }
-});
-var humanLockApproveRequestSchema = z.object({
-  file: z.string().min(1),
-  start_line: z.number().int().positive(),
-  end_line: z.number().int().positive(),
-  new_hash: z.string().min(1)
-});
-var humanLockFileParamsSchema = z.object({
-  file: z.string().min(1)
-});
-var annotateIntentRequestSchema = z.object({
-  ledger_entry_id: z.string().min(1),
-  annotation: z.string().trim().min(1)
-});
-var KnowledgeTypeSchema = z.enum([
-  "model",
-  // entities, data structures, relationships
-  "decision",
-  // architectural/technical choices with rationale
-  "guideline",
-  // recommended practices (recommend) or anti-patterns (avoid)
-  "pitfall",
-  // known risks, failure modes, troubleshooting
-  "process"
-  // workflows, state machines, operational steps
-]);
-var MaturitySchema = z.enum(["draft", "verified", "proven"]);
-var LayerSchema = z.enum(["personal", "team"]);
-var StableIdSchema = z.string().regex(/^K[PT]-(MOD|DEC|GLD|PIT|PRO)-\d{4,}$/);
-var KnowledgeEntryFrontmatterSchema = z.object({
-  id: StableIdSchema,
-  // e.g., "KT-DEC-0042"
-  type: KnowledgeTypeSchema,
-  // one of 5 types
-  maturity: MaturitySchema,
-  // draft | verified | proven
-  layer: LayerSchema,
-  // personal | team
-  layer_reason: z.string().optional(),
-  // why this layer (for ambiguous cases)
-  created_at: z.string()
-  // ISO 8601 timestamp
-  // Note: 'tags' and other fields can be added later but core schema is these 6
-});
-var KNOWLEDGE_TYPE_CODES = {
-  model: "MOD",
-  decision: "DEC",
-  guideline: "GLD",
-  pitfall: "PIT",
-  process: "PRO"
-};
-function formatKnowledgeId(layer, type, counter) {
-  const layerPrefix = layer === "personal" ? "KP" : "KT";
-  const typeCode = KNOWLEDGE_TYPE_CODES[type];
-  return `${layerPrefix}-${typeCode}-${String(counter).padStart(4, "0")}`;
-}
-function parseKnowledgeId(id) {
-  const match = id.match(/^(KP|KT)-(MOD|DEC|GLD|PIT|PRO)-(\d+)$/);
-  if (!match) return null;
-  const layer = match[1] === "KP" ? "personal" : "team";
-  const typeCode = match[2];
-  const entry = Object.entries(KNOWLEDGE_TYPE_CODES).find(([, code]) => code === typeCode);
-  if (!entry) return null;
-  const type = entry[0];
-  return { layer, type, counter: parseInt(match[3], 10) };
-}
-
-export {
-  structuredWarningSchema,
-  planContextInputSchema,
-  planContextOutputSchema,
-  planContextAnnotations,
-  getRulesInputSchema,
-  getRulesOutputSchema,
-  getRulesAnnotations,
-  ruleSectionsInputSchema,
-  ruleSectionsOutputSchema,
-  ruleSectionsAnnotations,
-  ledgerSourceSchema,
-  ledgerQuerySchema,
-  historyStateQuerySchema,
-  humanLockApproveRequestSchema,
-  humanLockFileParamsSchema,
-  annotateIntentRequestSchema,
-  KnowledgeTypeSchema,
-  MaturitySchema,
-  LayerSchema,
-  StableIdSchema,
-  KnowledgeEntryFrontmatterSchema,
-  KNOWLEDGE_TYPE_CODES,
-  formatKnowledgeId,
-  parseKnowledgeId
-};