@fenglimg/fabric-shared 2.0.0 → 2.0.1

package/dist/i18n/index.d.ts

@@ -10,13 +10,33 @@ declare function createTranslator(locale: Locale, messages?: Record<Locale, Mess
 
 declare function detectNodeLocale(): Locale;
 
+/**
+ * Resolve the effective runtime locale for a given project root.
+ *
+ * Resolution order (rc.26 — closes KT-DEC-9004 runtime gap):
+ *   1. Read `<projectRoot>/.fabric/fabric-config.json` and inspect
+ *      `fabric_language`.
+ *   2. If the value is `"en"` or `"zh-CN"` (the two concrete Locale members),
+ *      return it verbatim — this is the eager-resolved value `fabric init` is
+ *      supposed to write back per KT-DEC-9004.
+ *   3. If the value is `"match-existing"` or `"zh-CN-hybrid"` (placeholders
+ *      that should NEVER survive `fabric init` per KT-DEC-9004's invariant),
+ *      emit a `console.warn` and fall through to `detectNodeLocale()`.
+ *   4. If the file is missing, unreadable, malformed JSON, or `fabric_language`
+ *      is absent / has any other shape, silently fall through to
+ *      `detectNodeLocale()` (env-driven: `FAB_LANG` → `LANG` → `"en"`).
+ *
+ * Never throws — all failure paths degrade to `detectNodeLocale()`.
+ */
+declare function resolveFabricLocale(projectRoot: string): Locale;
+
 declare function normalizeLocale(raw: string | null | undefined): Locale;
 
-declare const PROTECTED_TOKENS: readonly ["fab_plan_context", "fab_get_knowledge_sections", "fab_extract_knowledge", "fab_review", "AGENTS.md", ".fabric/agents/", ".fabric/agents/_cross/", ".fabric/agents.meta.json", ".fabric/human-lock.json", ".fabric/events.jsonl", ".fabric/knowledge/", "knowledge_proposed", "@HUMAN", "MUST", "NEVER"];
+declare const PROTECTED_TOKENS: readonly ["fab_plan_context", "fab_get_knowledge_sections", "fab_extract_knowledge", "fab_review", "AGENTS.md", ".fabric/agents/", ".fabric/agents/_cross/", ".fabric/agents.meta.json", ".fabric/human-lock.json", ".fabric/events.jsonl", ".fabric/knowledge/", "knowledge_proposed", "relevance_scope", "relevance_paths", "narrow", "broad", "source_sessions", "proposed_reason", "session_context", "layer", "team", "personal", "pending_path", "knowledge_scope_degraded", "@HUMAN", "MUST", "NEVER"];
 type ProtectedToken = (typeof PROTECTED_TOKENS)[number];
 
 declare const enMessages: Messages;
 
 declare const zhCNMessages: Messages;
 
-export { type Locale, type Messages, PROTECTED_TOKENS, type ProtectedToken, type TranslationKey, type Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, zhCNMessages };
+export { type Locale, type Messages, PROTECTED_TOKENS, type ProtectedToken, type TranslationKey, type Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages };

package/dist/i18n/index.js

@@ -5,8 +5,9 @@ import {
   detectNodeLocale,
   enMessages,
   normalizeLocale,
+  resolveFabricLocale,
   zhCNMessages
-} from "../chunk-U2SR2M4L.js";
+} from "../chunk-7CX32MYL.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,
@@ -14,5 +15,6 @@ export {
   detectNodeLocale,
   enMessages,
   normalizeLocale,
+  resolveFabricLocale,
   zhCNMessages
 };

package/dist/index-UBqD9F0b.d.ts

@@ -0,0 +1,304 @@
+import { z } from 'zod';
+
+type AgentsLayer = "L0" | "L1" | "L2";
+type AgentsTopologyType = "mirror" | "cross-cutting" | "domain" | "local" | "global";
+type AgentsActivationTier = "always" | "path" | "description";
+type AgentsIdentitySource = "declared" | "derived";
+interface RuleDescription {
+    summary: string;
+    intent_clues: string[];
+    tech_stack: string[];
+    impact: string[];
+    must_read_if: string;
+    entities?: string[];
+    id?: string;
+    knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
+    maturity?: "draft" | "verified" | "proven";
+    knowledge_layer?: "personal" | "team";
+    layer_reason?: string;
+    created_at?: string;
+    tags?: string[];
+    relevance_scope?: "narrow" | "broad";
+    relevance_paths?: string[];
+}
+interface RuleDescriptionIndexItem {
+    stable_id: string;
+    description: RuleDescription;
+}
+interface AgentsMetaNodeActivation {
+    tier: AgentsActivationTier;
+    description?: string;
+}
+interface AgentsMetaNode {
+    file: string;
+    content_ref?: string;
+    scope_glob: string;
+    hash: string;
+    stable_id?: string;
+    identity_source?: AgentsIdentitySource;
+    activation?: AgentsMetaNodeActivation;
+    description?: RuleDescription;
+    sections?: string[];
+    deps?: string[];
+    priority?: "high" | "medium" | "low";
+    level?: AgentsLayer;
+    topology_type?: AgentsTopologyType;
+}
+interface AgentsMetaKnowledgeTypeCounters {
+    MOD: number;
+    DEC: number;
+    GLD: number;
+    PIT: number;
+    PRO: number;
+}
+interface AgentsMetaCountersEnvelope {
+    KP: AgentsMetaKnowledgeTypeCounters;
+    KT: AgentsMetaKnowledgeTypeCounters;
+}
+interface AgentsMeta {
+    revision: string;
+    nodes: Record<string, AgentsMetaNode>;
+    counters?: AgentsMetaCountersEnvelope;
+}
+
+interface AiLedgerEntry {
+    id?: string;
+    ts: number;
+    source: "ai";
+    commit_sha?: string;
+    intent: string;
+    affected_paths: string[];
+}
+interface HumanLedgerEntry {
+    id?: string;
+    ts: number;
+    source: "human";
+    parent_sha: string;
+    parent_ledger_entry_id?: string;
+    intent: string;
+    affected_paths: string[];
+    diff_stat: string;
+    annotation?: string;
+}
+type LedgerEntry = AiLedgerEntry | HumanLedgerEntry;
+interface HumanLockEntry {
+    file: string;
+    start_line: number;
+    end_line: number;
+    hash: string;
+}
+
+declare const auditModeSchema: z.ZodEnum<["strict", "warn", "off"]>;
+declare const clientPathsSchema: z.ZodObject<{
+    claudeCodeCLI: z.ZodOptional<z.ZodString>;
+    claudeCodeDesktop: z.ZodOptional<z.ZodString>;
+    cursor: z.ZodOptional<z.ZodString>;
+    codexCLI: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    claudeCodeCLI?: string | undefined;
+    claudeCodeDesktop?: string | undefined;
+    cursor?: string | undefined;
+    codexCLI?: string | undefined;
+}, {
+    claudeCodeCLI?: string | undefined;
+    claudeCodeDesktop?: string | undefined;
+    cursor?: string | undefined;
+    codexCLI?: string | undefined;
+}>;
+declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
+    warnBytes: z.ZodOptional<z.ZodNumber>;
+    hardBytes: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    warnBytes?: number | undefined;
+    hardBytes?: number | undefined;
+}, {
+    warnBytes?: number | undefined;
+    hardBytes?: number | undefined;
+}>>;
+declare const selectionTokenTtlMsSchema: z.ZodNumber;
+declare const fabricLanguageSchema: z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>;
+declare const defaultLayerFilterSchema: z.ZodEnum<["team", "personal", "both"]>;
+declare const fabricConfigSchema: z.ZodObject<{
+    clientPaths: z.ZodOptional<z.ZodObject<{
+        claudeCodeCLI: z.ZodOptional<z.ZodString>;
+        claudeCodeDesktop: z.ZodOptional<z.ZodString>;
+        cursor: z.ZodOptional<z.ZodString>;
+        codexCLI: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        cursor?: string | undefined;
+        codexCLI?: string | undefined;
+    }, {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        cursor?: string | undefined;
+        codexCLI?: string | undefined;
+    }>>;
+    scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    audit_mode: z.ZodOptional<z.ZodEnum<["strict", "warn", "off"]>>;
+    mcpPayloadLimits: z.ZodOptional<z.ZodObject<{
+        warnBytes: z.ZodOptional<z.ZodNumber>;
+        hardBytes: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    }, {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    }>>;
+    fabric_language: z.ZodDefault<z.ZodOptional<z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>>>;
+    default_layer_filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["team", "personal", "both"]>>>;
+    archive_hint_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    underseed_node_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    archive_edit_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    archive_hint_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    review_hint_pending_count: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    review_hint_pending_age_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maintenance_hint_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maintenance_hint_cooldown_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    import_window_first_run_months: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    import_window_rerun_months: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    import_max_pending_per_run: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    import_max_commits_scan: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    import_skip_canonical_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    archive_max_candidates_per_batch: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    archive_max_recent_paths: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    archive_digest_max_sessions: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    review_topic_result_cap: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    review_stale_pending_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    reverse_unarchive_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    reverse_unarchive_dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    cite_evict_interval: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fabric_event_retention_days: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>>;
+    onboard_slots_opted_out: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    hint_broad_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance"]>, "many">>;
+    hint_narrow_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_narrow_dedup_window_turns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_broad_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_narrow_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    orphan_demote_stable_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_endorsed_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
+    hint_summary_max_len: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_reminder_to_context: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    selection_token_ttl_ms: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    fabric_language: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
+    default_layer_filter: "personal" | "team" | "both";
+    archive_hint_cooldown_hours: number;
+    underseed_node_threshold: number;
+    archive_edit_threshold: number;
+    archive_hint_hours: number;
+    review_hint_pending_count: number;
+    review_hint_pending_age_days: number;
+    maintenance_hint_days: number;
+    maintenance_hint_cooldown_days: number;
+    import_window_first_run_months: number;
+    import_window_rerun_months: number;
+    import_max_pending_per_run: number;
+    import_max_commits_scan: number;
+    import_skip_canonical_threshold: number;
+    archive_max_candidates_per_batch: number;
+    archive_max_recent_paths: number;
+    archive_digest_max_sessions: number;
+    review_topic_result_cap: number;
+    review_stale_pending_days: number;
+    reverse_unarchive_enabled: boolean;
+    reverse_unarchive_dry_run: boolean;
+    cite_evict_interval: number;
+    onboard_slots_opted_out: string[];
+    hint_broad_top_k: number;
+    hint_narrow_top_k: number;
+    hint_narrow_dedup_window_turns: number;
+    hint_broad_cooldown_hours: number;
+    hint_narrow_cooldown_hours: number;
+    hint_summary_max_len: number;
+    hint_reminder_to_context: boolean;
+    clientPaths?: {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        cursor?: string | undefined;
+        codexCLI?: string | undefined;
+    } | undefined;
+    scanIgnores?: string[] | undefined;
+    audit_mode?: "strict" | "warn" | "off" | undefined;
+    mcpPayloadLimits?: {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    } | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
+    hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
+    orphan_demote_stable_days?: number | undefined;
+    orphan_demote_endorsed_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
+    selection_token_ttl_ms?: number | undefined;
+}, {
+    clientPaths?: {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        cursor?: string | undefined;
+        codexCLI?: string | undefined;
+    } | undefined;
+    scanIgnores?: string[] | undefined;
+    audit_mode?: "strict" | "warn" | "off" | undefined;
+    mcpPayloadLimits?: {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    } | undefined;
+    fabric_language?: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid" | undefined;
+    default_layer_filter?: "personal" | "team" | "both" | undefined;
+    archive_hint_cooldown_hours?: number | undefined;
+    underseed_node_threshold?: number | undefined;
+    archive_edit_threshold?: number | undefined;
+    archive_hint_hours?: number | undefined;
+    review_hint_pending_count?: number | undefined;
+    review_hint_pending_age_days?: number | undefined;
+    maintenance_hint_days?: number | undefined;
+    maintenance_hint_cooldown_days?: number | undefined;
+    import_window_first_run_months?: number | undefined;
+    import_window_rerun_months?: number | undefined;
+    import_max_pending_per_run?: number | undefined;
+    import_max_commits_scan?: number | undefined;
+    import_skip_canonical_threshold?: number | undefined;
+    archive_max_candidates_per_batch?: number | undefined;
+    archive_max_recent_paths?: number | undefined;
+    archive_digest_max_sessions?: number | undefined;
+    review_topic_result_cap?: number | undefined;
+    review_stale_pending_days?: number | undefined;
+    reverse_unarchive_enabled?: boolean | undefined;
+    reverse_unarchive_dry_run?: boolean | undefined;
+    cite_evict_interval?: number | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
+    onboard_slots_opted_out?: string[] | undefined;
+    hint_broad_top_k?: number | undefined;
+    hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
+    hint_narrow_top_k?: number | undefined;
+    hint_narrow_dedup_window_turns?: number | undefined;
+    hint_broad_cooldown_hours?: number | undefined;
+    hint_narrow_cooldown_hours?: number | undefined;
+    orphan_demote_stable_days?: number | undefined;
+    orphan_demote_endorsed_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
+    hint_summary_max_len?: number | undefined;
+    hint_reminder_to_context?: boolean | undefined;
+    selection_token_ttl_ms?: number | undefined;
+}>;
+
+interface ClientPaths {
+    claudeCodeCLI?: string;
+    claudeCodeDesktop?: string;
+    cursor?: string;
+    codexCLI?: string;
+}
+type AuditMode = "strict" | "warn" | "off";
+interface McpPayloadLimits {
+    warnBytes?: number;
+    hardBytes?: number;
+}
+type FabricLanguage = "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
+type DefaultLayerFilter = "team" | "personal" | "both";
+type FabricConfig = z.input<typeof fabricConfigSchema>;
+
+export { type AgentsMetaNode as A, type ClientPaths as C, type DefaultLayerFilter as D, type FabricConfig as F, type HumanLockEntry as H, type LedgerEntry as L, type McpPayloadLimits as M, type RuleDescription as R, type AgentsIdentitySource as a, type AgentsLayer as b, type AgentsTopologyType as c, type AgentsMeta as d, type AgentsActivationTier as e, fabricConfigSchema as f, type AgentsMetaCountersEnvelope as g, type AgentsMetaKnowledgeTypeCounters as h, type AgentsMetaNodeActivation as i, type AiLedgerEntry as j, type AuditMode as k, type FabricLanguage as l, type HumanLedgerEntry as m, type RuleDescriptionIndexItem as n, auditModeSchema as o, clientPathsSchema as p, defaultLayerFilterSchema as q, fabricLanguageSchema as r, mcpPayloadLimitsSchema as s, selectionTokenTtlMsSchema as t };