/**
 * User-profile CRUD operations for the NEXUS user_profile table.
 *
 * Provides the 5 SDK functions for PSYCHE Wave 1 (T1078):
 *   - getUserProfileTrait    — fetch a single trait by key
 *   - upsertUserProfileTrait — create-or-update a trait
 *   - reinforceTrait         — increment reinforcement count + bump confidence
 *   - listUserProfile        — list all traits (with optional confidence filter)
 *   - supersedeTrait         — mark one trait as superseded by another
 *
 * All functions accept a `nexusDb` argument (NodeSQLiteDatabase<NexusSchema>)
 * to keep them unit-testable without touching the real nexus.db singleton.
 * Callers that do not need test isolation may use `getNexusDb()` from
 * `packages/core/src/store/nexus-sqlite.ts` directly.
 *
 * PSYCHE reference: `upstream psyche-lineage · crud/peer.py` (getOrCreate +
 * metadata merge pattern) and `models.py` (User metadata attributes).
 *
 * @task T1078
 * @epic T1076
 */
import type { NexusProfileExportResult, NexusProfileGetResult, NexusProfileImportResult, NexusProfileReinforceResult, NexusProfileSupersedeResult, NexusProfileUpsertResult, NexusProfileViewResult, UserProfileTrait } from '@cleocode/contracts';
import type { NodeSQLiteDatabase } from 'drizzle-orm/node-sqlite';
import { type EngineResult } from '../engine-result.js';
import * as nexusSchema from '../store/schema/nexus-schema.js';
/** Type alias for the Drizzle nexus database instance. */
type NexusDb = NodeSQLiteDatabase<typeof nexusSchema>;
/**
 * Fetch a single user-profile trait by its key.
 *
 * Returns `null` when no matching row exists.
 *
 * @param nexusDb - Drizzle nexus database handle.
 * @param traitKey - Semantic trait key to look up.
 * @returns The matching `UserProfileTrait`, or `null`.
 */
export declare function getUserProfileTrait(nexusDb: NexusDb, traitKey: string): Promise<UserProfileTrait | null>;
/**
 * Create or update a user-profile trait.
 *
 * When a row with the same `traitKey` already exists it is overwritten
 * in full — this is the "last writer wins" semantics used by `importUserProfile`
 * after the conflict-resolution step (higher confidence wins, see T1079).
 * The `firstObservedAt` field is preserved from the existing row on update.
 *
 * @param nexusDb - Drizzle nexus database handle.
 * @param trait   - Trait to insert or replace.  `firstObservedAt` and
 *                  `lastReinforcedAt` should be ISO 8601 strings; they are
 *                  stored as canonical TEXT ISO-8601 in the consolidated
 *                  `nexus_user_profile` table (T11578 · AC3).
 */
export declare function upsertUserProfileTrait(nexusDb: NexusDb, trait: UserProfileTrait): Promise<void>;
/**
 * Increment the reinforcement count for an existing trait and boost its
 * confidence.
 *
 * Reinforcement boost formula:
 *   newConfidence = existing + (1 − existing) × 0.1
 * Each reinforcement moves confidence 10% closer to 1.0 (asymptotic approach).
 * Capped at 1.0.
 *
 * No-ops silently when the traitKey does not exist.
 *
 * @param nexusDb  - Drizzle nexus database handle.
 * @param traitKey - Key of the trait to reinforce.
 * @param source   - Source identifier recorded on the update (e.g. "manual").
 */
export declare function reinforceTrait(nexusDb: NexusDb, traitKey: string, source: string): Promise<void>;
/**
 * List all user-profile traits, optionally filtered by minimum confidence.
 *
 * Only non-superseded traits are returned by default — pass
 * `opts.includeSuperseded = true` to include deprecated traits.
 *
 * @param nexusDb - Drizzle nexus database handle.
 * @param opts    - Optional filtering options.
 * @returns Array of traits ordered by confidence desc, then traitKey asc.
 */
export declare function listUserProfile(nexusDb: NexusDb, opts?: {
    /** Minimum confidence threshold (inclusive). Defaults to 0.0. */
    minConfidence?: number;
    /** Include superseded (deprecated) traits. Defaults to false. */
    includeSuperseded?: boolean;
}): Promise<UserProfileTrait[]>;
/**
 * Mark a trait as superseded by another, implementing the T1139 supersession
 * link for the profile domain.
 *
 * The old trait row has its `supersededBy` field set to `newKey`.
 * The new trait is not modified (it must already exist or be created separately
 * via `upsertUserProfileTrait`).
 *
 * No-ops silently when `oldKey` does not exist.
 *
 * @param nexusDb - Drizzle nexus database handle.
 * @param oldKey  - Trait key that is being deprecated.
 * @param newKey  - Trait key that replaces it.
 */
export declare function supersedeTrait(nexusDb: NexusDb, oldKey: string, newKey: string): Promise<void>;
export declare function nexusProfileView(minConfidence?: number, includeSuperseded?: boolean): Promise<EngineResult<NexusProfileViewResult>>;
export declare function nexusProfileGet(traitKey: string): Promise<EngineResult<NexusProfileGetResult>>;
export declare function nexusProfileImport(path?: string): Promise<EngineResult<NexusProfileImportResult>>;
export declare function nexusProfileExport(path?: string): Promise<EngineResult<NexusProfileExportResult>>;
export declare function nexusProfileReinforce(traitKey: string, source?: string): Promise<EngineResult<NexusProfileReinforceResult>>;
export declare function nexusProfileUpsert(trait: Pick<UserProfileTrait, 'traitKey' | 'traitValue' | 'confidence' | 'source' | 'derivedFromMessageId'>): Promise<EngineResult<NexusProfileUpsertResult>>;
export declare function nexusProfileSupersede(oldKey: string, newKey: string): Promise<EngineResult<NexusProfileSupersedeResult>>;
export {};
//# sourceMappingURL=user-profile.d.ts.map