@fenglimg/fabric-shared 2.3.0-rc.1 → 2.3.0-rc.2

package/dist/index-BO7itJ8e.d.ts

@@ -0,0 +1,892 @@
+import { z } from 'zod';
+
+type AgentsTopologyType = "mirror" | "cross-cutting" | "domain" | "local" | "global";
+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";
+    semantic_scope?: string;
+    layer_reason?: string;
+    created_at?: string;
+    tags?: string[];
+    relevance_scope?: "narrow" | "broad";
+    relevance_paths?: string[];
+    related?: string[];
+}
+interface RuleDescriptionIndexItem {
+    stable_id: string;
+    description: RuleDescription;
+    always_active?: boolean;
+}
+interface RecallScore {
+    score: number;
+    score_breakdown: RecallScoreBreakdown;
+}
+interface RecallScoreBreakdown {
+    final: number;
+    bm25?: number;
+    bm25_rank?: number;
+    vector?: number;
+    vector_rank?: number;
+    salience: number;
+    recency: number;
+    locality: number;
+}
+interface AgentsMetaNode {
+    file: string;
+    content_ref?: string;
+    scope_glob: string;
+    hash: string;
+    stable_id?: string;
+    identity_source?: AgentsIdentitySource;
+    description?: RuleDescription;
+    sections?: string[];
+    deps?: string[];
+    priority?: "high" | "medium" | "low";
+    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 STORE_UUID_PATTERN: RegExp;
+declare const storeUuidSchema: z.ZodString;
+declare const STORE_ALIAS_PATTERN: RegExp;
+declare const storeAliasSchema: z.ZodString;
+declare const PERSONAL_STORE_SENTINEL: "$personal";
+declare const storeIdentitySchema: z.ZodObject<{
+    store_uuid: z.ZodString;
+    created_at: z.ZodString;
+    canonical_alias: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    allowed_scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    store_uuid: string;
+    created_at: string;
+    canonical_alias?: string | undefined;
+    description?: string | undefined;
+    allowed_scopes?: string[] | undefined;
+}, {
+    store_uuid: string;
+    created_at: string;
+    canonical_alias?: string | undefined;
+    description?: string | undefined;
+    allowed_scopes?: string[] | undefined;
+}>;
+type StoreIdentity = z.infer<typeof storeIdentitySchema>;
+declare const STORE_PROJECT_ID_PATTERN: RegExp;
+declare const STORE_MOUNT_NAME_PATTERN: RegExp;
+declare const storeMountNameSchema: z.ZodEffects<z.ZodString, string, string>;
+declare const storeProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    created_at: string;
+    id: string;
+    name?: string | undefined;
+}, {
+    created_at: string;
+    id: string;
+    name?: string | undefined;
+}>;
+type StoreProject = z.infer<typeof storeProjectSchema>;
+declare const storeProjectsFileSchema: z.ZodObject<{
+    projects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        created_at: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }, {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    projects: {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }[];
+}, {
+    projects?: {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }[] | undefined;
+}>;
+type StoreProjectsFile = z.infer<typeof storeProjectsFileSchema>;
+declare const requiredStoreEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    suggested_remote?: string | undefined;
+}, {
+    id: string;
+    suggested_remote?: string | undefined;
+}>;
+type RequiredStoreEntry = z.infer<typeof requiredStoreEntrySchema>;
+declare const STORE_KNOWLEDGE_TYPE_DIRS: readonly ["models", "decisions", "guidelines", "pitfalls", "processes"];
+declare const STORE_LAYOUT: {
+    readonly identityFile: "store.json";
+    readonly projectsFile: "projects.json";
+    readonly countersFile: "counters.json";
+    readonly knowledgeDir: "knowledge";
+    readonly bindingsDir: "bindings";
+    readonly stateDir: "state";
+};
+type StoreLayout = typeof STORE_LAYOUT;
+declare const STORES_ROOT_DIR = "stores";
+declare const GLOBAL_STATE_DIR = "state";
+declare const GLOBAL_BINDINGS_DIR = "bindings";
+declare function storeKnowledgeTypeDir(type: (typeof STORE_KNOWLEDGE_TYPE_DIRS)[number]): string;
+declare function storeRelativePath(storeUuid: string): string;
+declare const STORE_MOUNT_GROUPS: readonly ["personal", "team"];
+type StoreMountGroup = (typeof STORE_MOUNT_GROUPS)[number];
+declare function storeMountGroup(store: {
+    personal?: boolean;
+}): StoreMountGroup;
+declare function storeMountSubPath(store: {
+    store_uuid: string;
+    mount_name?: string;
+    personal?: boolean;
+}): string;
+declare function storeRelativePathForMount(store: {
+    store_uuid: string;
+    mount_name?: string;
+    personal?: boolean;
+}): string;
+declare function deriveMountLabel(input: {
+    remote?: string;
+    alias?: string;
+    store_uuid: string;
+}): string;
+declare const mountedStoreSchema: z.ZodObject<{
+    store_uuid: z.ZodString;
+    mount_name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    alias: z.ZodString;
+    display_name: z.ZodOptional<z.ZodString>;
+    remote: z.ZodOptional<z.ZodString>;
+    personal: z.ZodOptional<z.ZodBoolean>;
+    writable: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    store_uuid: string;
+    alias: string;
+    personal?: boolean | undefined;
+    mount_name?: string | undefined;
+    display_name?: string | undefined;
+    remote?: string | undefined;
+    writable?: boolean | undefined;
+}, {
+    store_uuid: string;
+    alias: string;
+    personal?: boolean | undefined;
+    mount_name?: string | undefined;
+    display_name?: string | undefined;
+    remote?: string | undefined;
+    writable?: boolean | undefined;
+}>;
+type MountedStore = z.infer<typeof mountedStoreSchema>;
+declare const globalConfigSchema: z.ZodObject<{
+    uid: z.ZodString;
+    language: z.ZodOptional<z.ZodEnum<["zh-CN", "en"]>>;
+    stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        store_uuid: z.ZodString;
+        mount_name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        alias: z.ZodString;
+        display_name: z.ZodOptional<z.ZodString>;
+        remote: z.ZodOptional<z.ZodString>;
+        personal: z.ZodOptional<z.ZodBoolean>;
+        writable: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        store_uuid: string;
+        alias: string;
+        personal?: boolean | undefined;
+        mount_name?: string | undefined;
+        display_name?: string | undefined;
+        remote?: string | undefined;
+        writable?: boolean | undefined;
+    }, {
+        store_uuid: string;
+        alias: string;
+        personal?: boolean | undefined;
+        mount_name?: string | undefined;
+        display_name?: string | undefined;
+        remote?: string | undefined;
+        writable?: boolean | undefined;
+    }>, "many">>>;
+    active_personal_store: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    uid: z.ZodString;
+    language: z.ZodOptional<z.ZodEnum<["zh-CN", "en"]>>;
+    stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        store_uuid: z.ZodString;
+        mount_name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        alias: z.ZodString;
+        display_name: z.ZodOptional<z.ZodString>;
+        remote: z.ZodOptional<z.ZodString>;
+        personal: z.ZodOptional<z.ZodBoolean>;
+        writable: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        store_uuid: string;
+        alias: string;
+        personal?: boolean | undefined;
+        mount_name?: string | undefined;
+        display_name?: string | undefined;
+        remote?: string | undefined;
+        writable?: boolean | undefined;
+    }, {
+        store_uuid: string;
+        alias: string;
+        personal?: boolean | undefined;
+        mount_name?: string | undefined;
+        display_name?: string | undefined;
+        remote?: string | undefined;
+        writable?: boolean | undefined;
+    }>, "many">>>;
+    active_personal_store: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    uid: z.ZodString;
+    language: z.ZodOptional<z.ZodEnum<["zh-CN", "en"]>>;
+    stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        store_uuid: z.ZodString;
+        mount_name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        alias: z.ZodString;
+        display_name: z.ZodOptional<z.ZodString>;
+        remote: z.ZodOptional<z.ZodString>;
+        personal: z.ZodOptional<z.ZodBoolean>;
+        writable: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        store_uuid: string;
+        alias: string;
+        personal?: boolean | undefined;
+        mount_name?: string | undefined;
+        display_name?: string | undefined;
+        remote?: string | undefined;
+        writable?: boolean | undefined;
+    }, {
+        store_uuid: string;
+        alias: string;
+        personal?: boolean | undefined;
+        mount_name?: string | undefined;
+        display_name?: string | undefined;
+        remote?: string | undefined;
+        writable?: boolean | undefined;
+    }>, "many">>>;
+    active_personal_store: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+type GlobalConfig = z.infer<typeof globalConfigSchema>;
+
+declare function isNonPersonalRequiredStore(entry: RequiredStoreEntry): boolean;
+declare function migrateRequiredStores(config: {
+    required_stores?: RequiredStoreEntry[];
+    active_write_store?: string;
+}): {
+    required_stores?: RequiredStoreEntry[];
+    active_write_store?: string;
+};
+declare const auditModeSchema: z.ZodEnum<["strict", "warn", "off"]>;
+declare const clientPathsSchema: z.ZodObject<{
+    claudeCodeCLI: z.ZodOptional<z.ZodString>;
+    claudeCodeDesktop: z.ZodOptional<z.ZodString>;
+    codexCLI: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    claudeCodeCLI?: string | undefined;
+    claudeCodeDesktop?: string | undefined;
+    codexCLI?: string | undefined;
+}, {
+    claudeCodeCLI?: string | undefined;
+    claudeCodeDesktop?: 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 planContextTopKSchema: z.ZodNumber;
+declare const fabricLanguageSchema: z.ZodEnum<["zh-CN", "en"]>;
+declare const defaultLayerFilterSchema: z.ZodEnum<["team", "personal", "both"]>;
+declare const nudgeModeSchema: z.ZodEnum<["silent", "minimal", "normal", "verbose"]>;
+declare const observeConfigSchema: z.ZodObject<{
+    session_start: z.ZodOptional<z.ZodBoolean>;
+    pre_tool_use: z.ZodOptional<z.ZodBoolean>;
+    stop: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    session_start?: boolean | undefined;
+    pre_tool_use?: boolean | undefined;
+    stop?: boolean | undefined;
+}, {
+    session_start?: boolean | undefined;
+    pre_tool_use?: boolean | undefined;
+    stop?: boolean | undefined;
+}>;
+declare const writeRouteSchema: z.ZodObject<{
+    scope: z.ZodString;
+    store: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    scope: string;
+    store: string;
+}, {
+    scope: string;
+    store: string;
+}>;
+declare const fabricConfigSchema: z.ZodObject<{
+    clientPaths: z.ZodOptional<z.ZodObject<{
+        claudeCodeCLI: z.ZodOptional<z.ZodString>;
+        claudeCodeDesktop: z.ZodOptional<z.ZodString>;
+        codexCLI: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    }, {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    }>>;
+    project_id: z.ZodOptional<z.ZodString>;
+    workspace_binding_id: z.ZodOptional<z.ZodString>;
+    required_stores: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        suggested_remote?: string | undefined;
+    }, {
+        id: string;
+        suggested_remote?: string | undefined;
+    }>, "many">, {
+        id: string;
+        suggested_remote?: string | undefined;
+    }[], {
+        id: string;
+        suggested_remote?: string | undefined;
+    }[]>>;
+    active_write_store: z.ZodOptional<z.ZodString>;
+    active_project: z.ZodOptional<z.ZodString>;
+    write_routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        scope: z.ZodString;
+        store: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        scope: string;
+        store: string;
+    }, {
+        scope: string;
+        store: string;
+    }>, "many">>;
+    default_write_store: z.ZodOptional<z.ZodString>;
+    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;
+    }>>;
+    default_layer_filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["team", "personal", "both"]>>>;
+    nudge_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["silent", "minimal", "normal", "verbose"]>>>;
+    observe: z.ZodOptional<z.ZodObject<{
+        session_start: z.ZodOptional<z.ZodBoolean>;
+        pre_tool_use: z.ZodOptional<z.ZodBoolean>;
+        stop: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    }, {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    }>>;
+    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>>;
+    review_stale_pending_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cite_recall_nudge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    cite_recall_window_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cite_nudge_ignore_globs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    conflict_lint_similarity_threshold: 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">>>;
+    broad_index_backstop: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance"]>, "many">>;
+    cite_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    self_archive_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    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_proven_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_verified_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
+    broad_review_recheck_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>;
+    plan_context_top_k: z.ZodOptional<z.ZodNumber>;
+    recall_relevance_ratio: z.ZodOptional<z.ZodNumber>;
+    embed_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    embed_weight: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    embed_model: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fast-bge-small-zh-v1.5", "fast-multilingual-e5-large", "fast-bge-small-en-v1.5", "fast-bge-small-en", "fast-bge-base-en-v1.5", "fast-bge-base-en", "fast-all-MiniLM-L6-v2"]>>>;
+    fusion: z.ZodDefault<z.ZodOptional<z.ZodEnum<["additive", "rrf"]>>>;
+}, "strip", z.ZodTypeAny, {
+    default_layer_filter: "personal" | "team" | "both";
+    nudge_mode: "silent" | "minimal" | "normal" | "verbose";
+    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;
+    review_stale_pending_days: number;
+    cite_recall_nudge: boolean;
+    cite_recall_window_minutes: number;
+    conflict_lint_similarity_threshold: number;
+    onboard_slots_opted_out: string[];
+    broad_index_backstop: number;
+    cite_policy_enabled: boolean;
+    self_archive_policy_enabled: boolean;
+    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;
+    embed_enabled: boolean;
+    embed_weight: number;
+    embed_model: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2";
+    fusion: "additive" | "rrf";
+    clientPaths?: {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    } | undefined;
+    project_id?: string | undefined;
+    workspace_binding_id?: string | undefined;
+    required_stores?: {
+        id: string;
+        suggested_remote?: string | undefined;
+    }[] | undefined;
+    active_write_store?: string | undefined;
+    active_project?: string | undefined;
+    write_routes?: {
+        scope: string;
+        store: string;
+    }[] | undefined;
+    default_write_store?: string | undefined;
+    scanIgnores?: string[] | undefined;
+    audit_mode?: "strict" | "warn" | "off" | undefined;
+    mcpPayloadLimits?: {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    } | undefined;
+    observe?: {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    } | undefined;
+    cite_nudge_ignore_globs?: string[] | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
+    hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
+    orphan_demote_proven_days?: number | undefined;
+    orphan_demote_verified_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
+    broad_review_recheck_days?: number | undefined;
+    selection_token_ttl_ms?: number | undefined;
+    plan_context_top_k?: number | undefined;
+    recall_relevance_ratio?: number | undefined;
+}, {
+    clientPaths?: {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    } | undefined;
+    project_id?: string | undefined;
+    workspace_binding_id?: string | undefined;
+    required_stores?: {
+        id: string;
+        suggested_remote?: string | undefined;
+    }[] | undefined;
+    active_write_store?: string | undefined;
+    active_project?: string | undefined;
+    write_routes?: {
+        scope: string;
+        store: string;
+    }[] | undefined;
+    default_write_store?: string | undefined;
+    scanIgnores?: string[] | undefined;
+    audit_mode?: "strict" | "warn" | "off" | undefined;
+    mcpPayloadLimits?: {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    } | undefined;
+    default_layer_filter?: "personal" | "team" | "both" | undefined;
+    nudge_mode?: "silent" | "minimal" | "normal" | "verbose" | undefined;
+    observe?: {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    } | 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;
+    review_stale_pending_days?: number | undefined;
+    cite_recall_nudge?: boolean | undefined;
+    cite_recall_window_minutes?: number | undefined;
+    cite_nudge_ignore_globs?: string[] | undefined;
+    conflict_lint_similarity_threshold?: number | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
+    onboard_slots_opted_out?: string[] | undefined;
+    broad_index_backstop?: number | undefined;
+    hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
+    cite_policy_enabled?: boolean | undefined;
+    self_archive_policy_enabled?: boolean | 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_proven_days?: number | undefined;
+    orphan_demote_verified_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
+    broad_review_recheck_days?: number | undefined;
+    hint_summary_max_len?: number | undefined;
+    hint_reminder_to_context?: boolean | undefined;
+    selection_token_ttl_ms?: number | undefined;
+    plan_context_top_k?: number | undefined;
+    recall_relevance_ratio?: number | undefined;
+    embed_enabled?: boolean | undefined;
+    embed_weight?: number | undefined;
+    embed_model?: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2" | undefined;
+    fusion?: "additive" | "rrf" | undefined;
+}>;
+declare const fabricConfigLoadSchema: z.ZodObject<{
+    clientPaths: z.ZodOptional<z.ZodObject<{
+        claudeCodeCLI: z.ZodOptional<z.ZodString>;
+        claudeCodeDesktop: z.ZodOptional<z.ZodString>;
+        codexCLI: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    }, {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    }>>;
+    project_id: z.ZodOptional<z.ZodString>;
+    workspace_binding_id: z.ZodOptional<z.ZodString>;
+    active_write_store: z.ZodOptional<z.ZodString>;
+    active_project: z.ZodOptional<z.ZodString>;
+    write_routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        scope: z.ZodString;
+        store: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        scope: string;
+        store: string;
+    }, {
+        scope: string;
+        store: string;
+    }>, "many">>;
+    default_write_store: z.ZodOptional<z.ZodString>;
+    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;
+    }>>;
+    default_layer_filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["team", "personal", "both"]>>>;
+    nudge_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["silent", "minimal", "normal", "verbose"]>>>;
+    observe: z.ZodOptional<z.ZodObject<{
+        session_start: z.ZodOptional<z.ZodBoolean>;
+        pre_tool_use: z.ZodOptional<z.ZodBoolean>;
+        stop: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    }, {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    }>>;
+    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>>;
+    review_stale_pending_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cite_recall_nudge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    cite_recall_window_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cite_nudge_ignore_globs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    conflict_lint_similarity_threshold: 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">>>;
+    broad_index_backstop: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance"]>, "many">>;
+    cite_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    self_archive_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    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_proven_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_verified_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
+    broad_review_recheck_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>;
+    plan_context_top_k: z.ZodOptional<z.ZodNumber>;
+    recall_relevance_ratio: z.ZodOptional<z.ZodNumber>;
+    embed_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    embed_weight: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    embed_model: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fast-bge-small-zh-v1.5", "fast-multilingual-e5-large", "fast-bge-small-en-v1.5", "fast-bge-small-en", "fast-bge-base-en-v1.5", "fast-bge-base-en", "fast-all-MiniLM-L6-v2"]>>>;
+    fusion: z.ZodDefault<z.ZodOptional<z.ZodEnum<["additive", "rrf"]>>>;
+} & {
+    required_stores: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        suggested_remote?: string | undefined;
+    }, {
+        id: string;
+        suggested_remote?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    default_layer_filter: "personal" | "team" | "both";
+    nudge_mode: "silent" | "minimal" | "normal" | "verbose";
+    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;
+    review_stale_pending_days: number;
+    cite_recall_nudge: boolean;
+    cite_recall_window_minutes: number;
+    conflict_lint_similarity_threshold: number;
+    onboard_slots_opted_out: string[];
+    broad_index_backstop: number;
+    cite_policy_enabled: boolean;
+    self_archive_policy_enabled: boolean;
+    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;
+    embed_enabled: boolean;
+    embed_weight: number;
+    embed_model: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2";
+    fusion: "additive" | "rrf";
+    clientPaths?: {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    } | undefined;
+    project_id?: string | undefined;
+    workspace_binding_id?: string | undefined;
+    required_stores?: {
+        id: string;
+        suggested_remote?: string | undefined;
+    }[] | undefined;
+    active_write_store?: string | undefined;
+    active_project?: string | undefined;
+    write_routes?: {
+        scope: string;
+        store: string;
+    }[] | undefined;
+    default_write_store?: string | undefined;
+    scanIgnores?: string[] | undefined;
+    audit_mode?: "strict" | "warn" | "off" | undefined;
+    mcpPayloadLimits?: {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    } | undefined;
+    observe?: {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    } | undefined;
+    cite_nudge_ignore_globs?: string[] | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
+    hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
+    orphan_demote_proven_days?: number | undefined;
+    orphan_demote_verified_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
+    broad_review_recheck_days?: number | undefined;
+    selection_token_ttl_ms?: number | undefined;
+    plan_context_top_k?: number | undefined;
+    recall_relevance_ratio?: number | undefined;
+}, {
+    clientPaths?: {
+        claudeCodeCLI?: string | undefined;
+        claudeCodeDesktop?: string | undefined;
+        codexCLI?: string | undefined;
+    } | undefined;
+    project_id?: string | undefined;
+    workspace_binding_id?: string | undefined;
+    required_stores?: {
+        id: string;
+        suggested_remote?: string | undefined;
+    }[] | undefined;
+    active_write_store?: string | undefined;
+    active_project?: string | undefined;
+    write_routes?: {
+        scope: string;
+        store: string;
+    }[] | undefined;
+    default_write_store?: string | undefined;
+    scanIgnores?: string[] | undefined;
+    audit_mode?: "strict" | "warn" | "off" | undefined;
+    mcpPayloadLimits?: {
+        warnBytes?: number | undefined;
+        hardBytes?: number | undefined;
+    } | undefined;
+    default_layer_filter?: "personal" | "team" | "both" | undefined;
+    nudge_mode?: "silent" | "minimal" | "normal" | "verbose" | undefined;
+    observe?: {
+        session_start?: boolean | undefined;
+        pre_tool_use?: boolean | undefined;
+        stop?: boolean | undefined;
+    } | 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;
+    review_stale_pending_days?: number | undefined;
+    cite_recall_nudge?: boolean | undefined;
+    cite_recall_window_minutes?: number | undefined;
+    cite_nudge_ignore_globs?: string[] | undefined;
+    conflict_lint_similarity_threshold?: number | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
+    onboard_slots_opted_out?: string[] | undefined;
+    broad_index_backstop?: number | undefined;
+    hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
+    cite_policy_enabled?: boolean | undefined;
+    self_archive_policy_enabled?: boolean | 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_proven_days?: number | undefined;
+    orphan_demote_verified_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
+    broad_review_recheck_days?: number | undefined;
+    hint_summary_max_len?: number | undefined;
+    hint_reminder_to_context?: boolean | undefined;
+    selection_token_ttl_ms?: number | undefined;
+    plan_context_top_k?: number | undefined;
+    recall_relevance_ratio?: number | undefined;
+    embed_enabled?: boolean | undefined;
+    embed_weight?: number | undefined;
+    embed_model?: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2" | undefined;
+    fusion?: "additive" | "rrf" | undefined;
+}>;
+
+interface ClientPaths {
+    claudeCodeCLI?: string;
+    claudeCodeDesktop?: 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 { planContextTopKSchema as $, type AgentsMetaNode as A, type StoreLayout as B, type ClientPaths as C, type DefaultLayerFilter as D, type StoreMountGroup as E, type FabricConfig as F, type GlobalConfig as G, type HumanLockEntry as H, type StoreProjectsFile as I, auditModeSchema as J, clientPathsSchema as K, type LedgerEntry as L, type MountedStore as M, defaultLayerFilterSchema as N, deriveMountLabel as O, PERSONAL_STORE_SENTINEL as P, fabricConfigLoadSchema as Q, type RequiredStoreEntry as R, type StoreIdentity as S, fabricLanguageSchema as T, globalConfigSchema as U, isNonPersonalRequiredStore as V, mcpPayloadLimitsSchema as W, migrateRequiredStores as X, mountedStoreSchema as Y, nudgeModeSchema as Z, observeConfigSchema as _, type AgentsIdentitySource as a, requiredStoreEntrySchema as a0, selectionTokenTtlMsSchema as a1, storeAliasSchema as a2, storeIdentitySchema as a3, storeKnowledgeTypeDir as a4, storeMountGroup as a5, storeMountNameSchema as a6, storeMountSubPath as a7, storeProjectSchema as a8, storeProjectsFileSchema as a9, storeRelativePath as aa, storeRelativePathForMount as ab, storeUuidSchema as ac, writeRouteSchema as ad, type AgentsTopologyType as b, type StoreProject as c, type AgentsMeta as d, type AgentsMetaCountersEnvelope as e, fabricConfigSchema as f, type AgentsMetaKnowledgeTypeCounters as g, type AiLedgerEntry as h, type AuditMode as i, type FabricLanguage as j, GLOBAL_BINDINGS_DIR as k, GLOBAL_STATE_DIR as l, type HumanLedgerEntry as m, type McpPayloadLimits as n, type RecallScore as o, type RecallScoreBreakdown as p, type RuleDescription as q, type RuleDescriptionIndexItem as r, STORES_ROOT_DIR as s, STORE_ALIAS_PATTERN as t, STORE_KNOWLEDGE_TYPE_DIRS as u, STORE_LAYOUT as v, STORE_MOUNT_GROUPS as w, STORE_MOUNT_NAME_PATTERN as x, STORE_PROJECT_ID_PATTERN as y, STORE_UUID_PATTERN as z };