@fenglimg/fabric-shared 2.0.0-rc.10 → 2.0.0-rc.13

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-YGEE3WMC.js";
+} from "./chunk-WIH5HBKU.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -45,7 +45,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "./chunk-G4IKTNY4.js";
+} from "./chunk-NNDFOOBO.js";
 import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
@@ -306,7 +306,12 @@ var mcpPayloadLimitsSchema = z5.object({
   warnBytes: z5.number().int().positive().optional(),
   hardBytes: z5.number().int().positive().optional()
 }).optional();
-var knowledgeLanguageSchema = z5.enum(["match-existing", "zh-CN", "en"]);
+var fabricLanguageSchema = z5.enum([
+  "match-existing",
+  "zh-CN",
+  "en",
+  "zh-CN-hybrid"
+]);
 var defaultLayerFilterSchema = z5.enum(["team", "personal", "both"]);
 var fabricConfigSchema = z5.object({
   clientPaths: clientPathsSchema.optional(),
@@ -318,7 +323,7 @@ var fabricConfigSchema = z5.object({
   // Backward-compat: both fields are optional with defaults so existing
   // fabric-config.json files (pre-grill-followup) parse unchanged. The default
   // values themselves are load-bearing — see docs/data-schema.md.
-  knowledge_language: knowledgeLanguageSchema.optional().default("match-existing"),
+  fabric_language: fabricLanguageSchema.optional().default("match-existing"),
   default_layer_filter: defaultLayerFilterSchema.optional().default("both"),
   // Cooldown for the fabric-hint Stop hook (formerly archive-hint, renamed in
   // rc.5 TASK-010). After ANY of the three signals (archive / review / import)
@@ -373,7 +378,65 @@ var fabricConfigSchema = z5.object({
   // the user doesn't run doctor. Default 7 keeps the reminder weekly at
   // worst — pairing 14d trigger + 7d cooldown means at most ~2 reminders
   // per month for a workspace that ignores them.
-  maintenance_hint_cooldown_days: z5.number().int().positive().optional().default(7)
+  maintenance_hint_cooldown_days: z5.number().int().positive().optional().default(7),
+  // rc.9+ (skill-contract-fix B1): first-run import window in months. The
+  // `fabric-import` skill scans this many months of git history on the very
+  // first invocation (when no prior `import_run_completed` event exists).
+  // Default 60 (~5 years) captures the bulk of a mature repo's signal in
+  // one pass; small / fresh repos can lower to 12-24 with no loss.
+  import_window_first_run_months: z5.number().int().min(1).optional().default(60),
+  // rc.9+ (skill-contract-fix B1): rerun import window in months. After
+  // the first successful import, subsequent runs only scan this many
+  // recent months — assumed everything older has already been crystallized
+  // into pending or canonical knowledge. Default 2 keeps incremental cost
+  // low; raise to 6 if the workspace pauses fabric-import for long stretches.
+  import_window_rerun_months: z5.number().int().min(1).optional().default(2),
+  // rc.9+ (skill-contract-fix B1): hard cap on pending entries produced
+  // per fabric-import invocation. Prevents one run from dumping hundreds
+  // of proposals when a backfill window is wide open. Default 10 matches
+  // the rule-of-thumb "human can triage ~10 pending entries in one
+  // review pass." Range 1-50.
+  import_max_pending_per_run: z5.number().int().min(1).max(50).optional().default(10),
+  // rc.9+ (skill-contract-fix B1): hard cap on commits scanned per
+  // fabric-import invocation. Bounds runtime on monorepos with high
+  // commit velocity. Default 500 covers ~2 months of typical churn;
+  // range 50-2000. Hitting the cap mid-window is logged but non-fatal.
+  import_max_commits_scan: z5.number().int().min(50).max(2e3).optional().default(500),
+  // rc.9+ (skill-contract-fix B1): canonical-node count above which
+  // fabric-import's pre-flight should warn / suggest review instead of
+  // proceeding. A workspace with 50+ canonical entries usually benefits
+  // more from `fabric-review` to consolidate than from importing more.
+  // Default 50; raise to 100+ for large polyglot repos.
+  import_skip_canonical_threshold: z5.number().int().positive().optional().default(50),
+  // rc.9+ (skill-contract-fix B1): max candidate entries surfaced per
+  // fabric-archive batch (one invocation of the skill). Pagination knob
+  // for the archive UI flow. Default 8 keeps each batch reviewable in
+  // one sitting; raise for large repos with high archive throughput.
+  archive_max_candidates_per_batch: z5.number().int().positive().optional().default(8),
+  // rc.9+ (skill-contract-fix B1): max recently-touched paths included
+  // in fabric-archive's "relevant context" lookup. Limits the size of
+  // the path-relevance digest the skill emits when ranking candidates.
+  // Default 20; large repos with deep directory fan-out can raise to
+  // 50+ if archive candidates feel under-contextualized.
+  archive_max_recent_paths: z5.number().int().positive().optional().default(20),
+  // rc.9+ (skill-contract-fix B1): max prior fabric-archive sessions
+  // summarised in the digest the skill loads on start. Prevents the
+  // digest from ballooning past the model context budget on workspaces
+  // that have archived repeatedly. Default 10; lower if context pressure
+  // bites, raise if you want longer-range archive trend visibility.
+  archive_digest_max_sessions: z5.number().int().positive().optional().default(10),
+  // rc.9+ (skill-contract-fix B1): max review results returned per
+  // topic when `fabric-review` clusters pending entries. Pagination
+  // knob analogous to archive_max_candidates_per_batch but scoped to
+  // each topic cluster. Default 8; raise to 15-20 for large repos
+  // where each topic legitimately groups many pending entries.
+  review_topic_result_cap: z5.number().int().positive().optional().default(8),
+  // rc.9+ (skill-contract-fix B1): age threshold (in days) above which
+  // a pending entry is considered "stale" by fabric-review and surfaced
+  // 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)
 });
 
 // src/schemas/forensic-report.ts
@@ -791,6 +854,13 @@ var knowledgePathDangledEventSchema = z9.object({
   stable_id: z9.string(),
   removed_glob: z9.string()
 });
+var relevanceMigrationRunEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("relevance_migration_run"),
+  timestamp: z9.string().datetime(),
+  scanned_count: z9.number().int().nonnegative(),
+  touched_count: z9.number().int().nonnegative()
+});
 var pendingAutoArchivedEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
   event_type: z9.literal("pending_auto_archived"),
@@ -837,7 +907,10 @@ var eventLedgerEventSchema = z9.discriminatedUnion("event_type", [
   // #24 when a glob in relevance_paths resolves to zero filesystem matches.
   knowledgePathDangledEventSchema,
   // v2.0.0-rc.7 T10: doctor_run — emitted by `fabric doctor` to drive Signal D.
-  doctorRunEventSchema
+  doctorRunEventSchema,
+  // v2.0.0-rc.9 TASK-003 (A3): relevance_migration_run — emitted by
+  // `doctor --apply-lint` after the lint #26 frontmatter back-fill pass.
+  relevanceMigrationRunEventSchema
 ]);
 export {
   AGENTS_META_IDENTITY_SOURCES,
@@ -894,6 +967,7 @@ export {
   fabReviewAnnotations,
   fabricConfigSchema,
   fabricEventSchema,
+  fabricLanguageSchema,
   forensicAssertionCoverageSchema,
   forensicAssertionSchema,
   forensicCodeSampleSchema,
@@ -930,7 +1004,6 @@ export {
   knowledgeDeferredEventSchema,
   knowledgeDemotedEventSchema,
   knowledgeDriftDetectedEventSchema,
-  knowledgeLanguageSchema,
   knowledgeLayerChangedEventSchema,
   knowledgePathDangledEventSchema,
   knowledgePromoteFailedEventSchema,
@@ -969,6 +1042,7 @@ export {
   planContextInputSchema,
   planContextOutputSchema,
   reapplyCompletedEventSchema,
+  relevanceMigrationRunEventSchema,
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
   structuredWarningSchema,