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

package/dist/index.js

@@ -6,33 +6,46 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-KHIM6MWS.js";
+} from "./chunk-YGEE3WMC.js";
 import {
+  FabExtractKnowledgeInputSchema,
+  FabExtractKnowledgeInputShape,
+  FabExtractKnowledgeOutputSchema,
+  FabReviewInputSchema,
+  FabReviewInputShape,
+  FabReviewOutputSchema,
+  FabReviewOutputShape,
   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-G4IKTNY4.js";
 import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
@@ -59,7 +72,13 @@ var ruleDescriptionSchema = z.object({
   layer_reason: z.string().optional(),
   created_at: z.string().optional(),
   // v2/rc.2: flat flow-style YAML array; populated by init-scan from forensic tech stack and editable by user. Used by rc.3 review skill for tag-filter search.
-  tags: z.array(z.string()).default([]).optional()
+  tags: z.array(z.string()).default([]).optional(),
+  // v2.0-rc.5 (C1): relevance scope/paths drive plan-context-hint narrowing.
+  // Defaults applied so existing entries lacking these fields parse cleanly:
+  //   relevance_scope → 'broad'   (always-surface, safe default)
+  //   relevance_paths → []        (no path anchors)
+  relevance_scope: z.enum(["narrow", "broad"]).default("broad"),
+  relevance_paths: z.array(z.string()).default([])
 }).strict();
 var ruleDescriptionIndexItemSchema = z.object({
   stable_id: z.string(),
@@ -72,11 +91,6 @@ var agentsMetaNodeBaseSchema = z.object({
   file: z.string(),
   content_ref: z.string().optional(),
   scope_glob: z.string(),
-  deps: z.array(z.string()),
-  priority: z.enum(["high", "medium", "low"]),
-  level: agentsLayerSchema.optional(),
-  layer: agentsLayerSchema,
-  topology_type: agentsTopologyTypeSchema,
   hash: z.string(),
   stable_id: z.string().optional(),
   identity_source: agentsIdentitySourceSchema.optional(),
@@ -86,7 +100,7 @@ var agentsMetaNodeBaseSchema = z.object({
   }).optional(),
   description: ruleDescriptionSchema.optional(),
   sections: z.array(z.string()).optional()
-});
+}).passthrough();
 var agentsMetaNodeSchema = z.preprocess((value) => {
   if (!isRecord(value) || typeof value.file !== "string") {
     return value;
@@ -205,11 +219,11 @@ function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
 
-// src/schemas/rule-test-index.ts
+// src/schemas/knowledge-test-index.ts
 import { z as z2 } from "zod";
-var RULE_TEST_INDEX_SCHEMA_VERSION = 1;
+var KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION = 1;
 var hashSchema = z2.string().min(1);
-var ruleTestLinkSchema = z2.object({
+var knowledgeTestLinkSchema = z2.object({
   rule_stable_id: z2.string().min(1),
   rule_file: z2.string().min(1),
   rule_hash: hashSchema,
@@ -219,20 +233,20 @@ var ruleTestLinkSchema = z2.object({
   previous_test_hash: hashSchema.optional(),
   annotation_line: z2.number().int().positive()
 }).strict();
-var ruleTestOrphanAnnotationSchema = z2.object({
+var knowledgeTestOrphanAnnotationSchema = z2.object({
   rule_stable_id: z2.string().min(1),
   test_file: z2.string().min(1),
   test_hash: hashSchema,
   previous_test_hash: hashSchema.optional(),
   annotation_line: z2.number().int().positive()
 }).strict();
-var ruleTestIndexSchema = z2.object({
-  schema_version: z2.literal(RULE_TEST_INDEX_SCHEMA_VERSION),
+var knowledgeTestIndexSchema = z2.object({
+  schema_version: z2.literal(KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION),
   generated_at: z2.string().datetime({ offset: true }),
   revision: z2.string().min(1).optional(),
   previous_revision: z2.string().min(1).optional(),
-  links: z2.array(ruleTestLinkSchema),
-  orphan_annotations: z2.array(ruleTestOrphanAnnotationSchema)
+  links: z2.array(knowledgeTestLinkSchema),
+  orphan_annotations: z2.array(knowledgeTestOrphanAnnotationSchema)
 }).strict();
 
 // src/schemas/ledger-entry.ts
@@ -292,13 +306,74 @@ 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 defaultLayerFilterSchema = z5.enum(["team", "personal", "both"]);
 var fabricConfigSchema = z5.object({
   clientPaths: clientPathsSchema.optional(),
   externalFixturePath: z5.string().optional(),
   scanIgnores: z5.array(z5.string()).optional(),
   auditMode: auditModeSchema.optional(),
   audit_mode: auditModeSchema.optional(),
-  mcpPayloadLimits: mcpPayloadLimitsSchema
+  mcpPayloadLimits: mcpPayloadLimitsSchema,
+  // 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"),
+  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)
+  // fires, that signal stays silent for this many hours regardless of state
+  // drift — purely a reminder throttle. Default 12 means "at most twice per
+  // day if the user keeps ignoring it." Set to 24 to align with the archive
+  // trigger threshold. The legacy `archive_hint_` key is retained for backward
+  // compat with existing user fabric-config.json files.
+  archive_hint_cooldown_hours: z5.number().int().positive().optional().default(12),
+  // Underseed-node threshold for the fabric-hint Stop hook's import signal
+  // (rc.5 TASK-010). When the canonical knowledge node count is strictly less
+  // than this value AND a successful `init_scan_completed` event happened at
+  // least 24h ago AND no `knowledge_proposed` event has fired in the last 24h,
+  // the hook recommends running the fabric-import skill. Default 10 reflects
+  // the rule-of-thumb that a workspace with fewer than ten knowledge entries
+  // is below the floor for plan_context retrieval to be meaningful. Also
+  // consumed by `doctor` lint #22 (knowledge_underseeded).
+  underseed_node_threshold: z5.number().int().positive().optional().default(10),
+  // Edit-count threshold for the fabric-hint Stop hook's Signal A
+  // (rc.6 TASK-022 / E5). Signal A fires when EITHER (a) >=24h have elapsed
+  // since the last `knowledge_proposed` event, OR (b) >=archive_edit_threshold
+  // PreToolUse fires have been recorded in `.fabric/.cache/edit-counter` since
+  // the last `knowledge_proposed` event. The edit-counter sidecar is populated
+  // by the rc.6 PreToolUse hook (TASK-020 / E4) — one ISO-8601 line per fire.
+  // Default 20 reflects the rule-of-thumb "after ~20 Edit/Write operations
+  // there is probably something worth archiving"; lowered values nag more
+  // aggressively, higher values rely on the 24h fallback. Missing or absent
+  // edit-counter file degrades safely to the 24h-only path.
+  archive_edit_threshold: z5.number().int().positive().optional().default(20),
+  // rc.7 T7: hours-since-last-knowledge_proposed cutoff for Signal A's
+  // time branch. Was hardcoded as 24 in fabric-hint.cjs's THRESHOLD_HOURS;
+  // externalized so chatty workspaces can lower the bar and quiet ones can
+  // raise it. Default 24 preserves rc.6 behavior. See docs/configuration.md.
+  archive_hint_hours: z5.number().int().positive().optional().default(24),
+  // rc.7 T7: pending-count cutoff for Signal B (review skill). Was
+  // hardcoded as 10 in fabric-hint.cjs's THRESHOLD_PENDING_COUNT.
+  // Default 10 preserves rc.6 behavior. See docs/configuration.md for
+  // small/medium/large repo recommendations.
+  review_hint_pending_count: z5.number().int().positive().optional().default(10),
+  // rc.7 T7: pending-age cutoff (in days) for Signal B (review skill).
+  // Was hardcoded as 7 in fabric-hint.cjs's THRESHOLD_PENDING_AGE_DAYS.
+  // Default 7 preserves rc.6 behavior. See docs/configuration.md.
+  review_hint_pending_age_days: z5.number().int().positive().optional().default(7),
+  // rc.7 T7 + T10 pre-wiring: days-since-last-doctor cutoff for the future
+  // Signal D (maintenance hint). T10 will consume this to decide when the
+  // fabric-hint Stop hook surfaces a "run `fabric doctor`" reminder.
+  // Default 14 reflects a fortnightly cadence — long enough to avoid nag,
+  // short enough to catch index drift before it compounds.
+  maintenance_hint_days: z5.number().int().positive().optional().default(14),
+  // rc.7 T7 + T10 pre-wiring: cooldown between Signal D reminders, in
+  // days. Once Signal D fires, it stays silent for this many days even if
+  // 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)
 });
 
 // src/schemas/forensic-report.ts
@@ -569,7 +644,7 @@ var metaReconciledOnStartupEventSchema = z9.object({
   event_type: z9.literal("meta_reconciled_on_startup"),
   reconciled_files: z9.array(z9.string()),
   duration_ms: z9.number().int().nonnegative(),
-  source: z9.literal("reconcileRules")
+  source: z9.literal("reconcileKnowledge")
 });
 var metaReconciledEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
@@ -577,7 +652,7 @@ var metaReconciledEventSchema = z9.object({
   reconciled_files: z9.array(z9.string()),
   duration_ms: z9.number().int().nonnegative(),
   trigger: z9.enum(["doctor", "manual"]),
-  source: z9.literal("reconcileRules")
+  source: z9.literal("reconcileKnowledge")
 });
 var claudeSkillPathMigratedEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
@@ -604,6 +679,125 @@ var initScanCompletedEventSchema = z9.object({
   duration_ms: z9.number().int().nonnegative(),
   source: z9.enum(["init", "scan", "doctor_fix"]).optional()
 });
+var knowledgeProposedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_proposed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgePromoteStartedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_promote_started"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgePromotedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_promoted"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgePromoteFailedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_promote_failed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string()
+});
+var knowledgeLayerChangedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_layer_changed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional(),
+  from_layer: z9.enum(["team", "personal"]),
+  to_layer: z9.enum(["team", "personal"])
+});
+var knowledgeSlugRenamedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_slug_renamed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional(),
+  from_slug: z9.string(),
+  to_slug: z9.string()
+});
+var knowledgeDemotedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_demoted"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgeArchivedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_archived"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgeArchiveAttemptedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_archive_attempted"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgeDeferredEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_deferred"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional(),
+  until: z9.string().datetime().optional()
+});
+var knowledgeRejectedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_rejected"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string()
+});
+var knowledgeConsumedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_consumed"),
+  stable_id: z9.string(),
+  consumed_at: z9.string().datetime(),
+  client_hash: z9.string()
+});
+var knowledgeScopeDegradedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_scope_degraded"),
+  stable_id: z9.string(),
+  timestamp: z9.string().datetime(),
+  from_scope: z9.enum(["narrow", "broad"]),
+  to_scope: z9.enum(["narrow", "broad"]),
+  reason: z9.string()
+});
+var doctorRunEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("doctor_run"),
+  mode: z9.enum(["lint", "apply-lint"]),
+  issues: z9.number().int().nonnegative(),
+  mutations: z9.number().int().nonnegative().optional(),
+  timestamp: z9.string().datetime()
+});
+var knowledgePathDangledEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_path_dangled"),
+  stable_id: z9.string(),
+  removed_glob: z9.string()
+});
+var pendingAutoArchivedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("pending_auto_archived"),
+  pending_path: z9.string(),
+  archived_to: z9.string(),
+  reason: z9.string()
+});
 var eventLedgerEventSchema = z9.discriminatedUnion("event_type", [
   knowledgeContextPlannedEventSchema,
   knowledgeSelectionEventSchema,
@@ -619,20 +813,53 @@ var eventLedgerEventSchema = z9.discriminatedUnion("event_type", [
   claudeSkillPathMigratedEventSchema,
   claudeHookPathMigratedEventSchema,
   codexSkillPathMigratedEventSchema,
-  initScanCompletedEventSchema
+  initScanCompletedEventSchema,
+  // v2.0 rc.2 grill-followup TASK-004: knowledge.* lifecycle pre-registration
+  knowledgeProposedEventSchema,
+  knowledgePromoteStartedEventSchema,
+  knowledgePromotedEventSchema,
+  knowledgePromoteFailedEventSchema,
+  knowledgeLayerChangedEventSchema,
+  knowledgeSlugRenamedEventSchema,
+  knowledgeDemotedEventSchema,
+  knowledgeArchivedEventSchema,
+  knowledgeArchiveAttemptedEventSchema,
+  knowledgeDeferredEventSchema,
+  knowledgeRejectedEventSchema,
+  // v2.0 rc.5 TASK-014: knowledge_consumed (consumption tracking)
+  knowledgeConsumedEventSchema,
+  // v2.0 rc.5 TASK-012 (C3): knowledge_scope_degraded — narrow→broad auto-degrade
+  knowledgeScopeDegradedEventSchema,
+  // v2.0 rc.5 TASK-009 (B2): pending_auto_archived — doctor --apply-lint moves
+  // pending entries >30d old into the .archive/pending/ subtree.
+  pendingAutoArchivedEventSchema,
+  // v2.0 rc.5 TASK-013 (C4): knowledge_path_dangled — emitted by doctor lint
+  // #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
 ]);
 export {
   AGENTS_META_IDENTITY_SOURCES,
   AGENTS_META_LAYERS,
   AGENTS_META_TOPOLOGY_TYPES,
   AgentsMetaCountersSchema,
+  FabExtractKnowledgeInputSchema,
+  FabExtractKnowledgeInputShape,
+  FabExtractKnowledgeOutputSchema,
+  FabReviewInputSchema,
+  FabReviewInputShape,
+  FabReviewOutputSchema,
+  FabReviewOutputShape,
+  KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION,
   KNOWLEDGE_TYPE_CODES,
   KnowledgeEntryFrontmatterSchema,
   KnowledgeTypeSchema,
   LayerSchema,
   MaturitySchema,
+  PROPOSED_REASON_DESCRIPTIONS,
   PROTECTED_TOKENS,
-  RULE_TEST_INDEX_SCHEMA_VERSION,
+  ProposedReasonSchema,
   StableIdSchema,
   agentsIdentitySourceSchema,
   agentsLayerSchema,
@@ -650,17 +877,21 @@ export {
   codexSkillPathMigratedEventSchema,
   createTranslator,
   defaultAgentsMetaCounters,
+  defaultLayerFilterSchema,
   defaultMessages,
   deriveAgentsMetaIdentitySource,
   deriveAgentsMetaLayer,
   deriveAgentsMetaStableId,
   deriveAgentsMetaTopologyType,
   detectNodeLocale,
+  doctorRunEventSchema,
   driftDetectedEventSchema,
   editIntentCheckedEventSchema,
   enMessages,
   eventLedgerEventSchema,
   eventLedgerTruncatedEventSchema,
+  fabExtractKnowledgeAnnotations,
+  fabReviewAnnotations,
   fabricConfigSchema,
   fabricEventSchema,
   forensicAssertionCoverageSchema,
@@ -674,9 +905,9 @@ export {
   forensicSamplingBudgetSchema,
   forensicTopologySchema,
   formatKnowledgeId,
-  getRulesAnnotations,
-  getRulesInputSchema,
-  getRulesOutputSchema,
+  getKnowledgeAnnotations,
+  getKnowledgeInputSchema,
+  getKnowledgeOutputSchema,
   historyStateQuerySchema,
   humanLedgerEntrySchema,
   humanLockApproveRequestSchema,
@@ -692,10 +923,31 @@ export {
   initContextSourceEvidenceSchema,
   initScanCompletedEventSchema,
   isKnowledgeStableId,
+  knowledgeArchiveAttemptedEventSchema,
+  knowledgeArchivedEventSchema,
+  knowledgeConsumedEventSchema,
   knowledgeContextPlannedEventSchema,
+  knowledgeDeferredEventSchema,
+  knowledgeDemotedEventSchema,
   knowledgeDriftDetectedEventSchema,
+  knowledgeLanguageSchema,
+  knowledgeLayerChangedEventSchema,
+  knowledgePathDangledEventSchema,
+  knowledgePromoteFailedEventSchema,
+  knowledgePromoteStartedEventSchema,
+  knowledgePromotedEventSchema,
+  knowledgeProposedEventSchema,
+  knowledgeRejectedEventSchema,
+  knowledgeScopeDegradedEventSchema,
+  knowledgeSectionsAnnotations,
   knowledgeSectionsFetchedEventSchema,
+  knowledgeSectionsInputSchema,
+  knowledgeSectionsOutputSchema,
   knowledgeSelectionEventSchema,
+  knowledgeSlugRenamedEventSchema,
+  knowledgeTestIndexSchema,
+  knowledgeTestLinkSchema,
+  knowledgeTestOrphanAnnotationSchema,
   ledgerAppendedEventSchema,
   ledgerEntrySchema,
   ledgerQuerySchema,
@@ -710,18 +962,15 @@ export {
   metaUpdatedEventSchema,
   normalizeLocale,
   parseKnowledgeId,
+  pendingAutoArchivedEventSchema,
   planContextAnnotations,
+  planContextHintNarrowEntrySchema,
+  planContextHintOutputSchema,
   planContextInputSchema,
   planContextOutputSchema,
   reapplyCompletedEventSchema,
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
-  ruleSectionsAnnotations,
-  ruleSectionsInputSchema,
-  ruleSectionsOutputSchema,
-  ruleTestIndexSchema,
-  ruleTestLinkSchema,
-  ruleTestOrphanAnnotationSchema,
   structuredWarningSchema,
   withDerivedAgentsMetaNodeDefaults,
   zhCNMessages