@cleocode/core 2026.9.19 → 2026.9.21

package/dist/nexus/user-profile-hygiene.d.ts

@@ -0,0 +1,168 @@
+/**
+ * User-profile hygiene: keep operation receipts out of `nexus_user_profile`
+ * and repair the rows that already got in (T12543).
+ *
+ * ## The defect
+ *
+ * The dialectic hook in the CQRS dispatcher fed every successful mutate
+ * operation to the evaluator as a "turn": `cleo <domain> <op> {params}` paired
+ * with `Operation succeeded in domain "<domain>"`. The evaluator minted
+ * user traits from those envelopes — "Operation succeeded in domain 'check'",
+ * "gate set to true for T1655" — and, because the table is GLOBAL, facts
+ * lifted from one project's task params were injected into every other
+ * project's spawn prompts. Measured 2026-09-27: 399 of 404 rows were
+ * `dialectic:<session>` rows, each seen exactly once.
+ *
+ * ## What this module provides
+ *
+ * - {@link classifyReceiptTrait} — the text classifier for status lines and
+ *   operation receipts. REPAIR ONLY: at write time the structural signal
+ *   (`DialecticTurn.origin === 'operation-envelope'`) is the guard, because a
+ *   text rule at write time would also block legitimate preferences.
+ * - {@link pruneReceiptTraits} — dry-run / apply repair. Apply writes a
+ *   backup file FIRST (a `user_profile.json`-shaped envelope carrying the full
+ *   rows), then deletes each row only if it is unchanged since it was read.
+ * - {@link restorePrunedTraits} — re-inserts rows from that backup, never
+ *   overwriting a row that was re-created since.
+ *
+ * @task T12543
+ * @epic T12515
+ */
+import type { NodeSQLiteDatabase } from 'drizzle-orm/node-sqlite';
+/** Drizzle handle over a database holding `nexus_user_profile`. */
+type NexusDb = NodeSQLiteDatabase;
+/**
+ * Classify a trait as an operation receipt / status line.
+ *
+ * @param traitKey - Trait key (kebab-case semantic key).
+ * @param traitValue - Trait value text.
+ * @returns The id of the first matching rule, or `null` when the trait does
+ *   not look like a receipt.
+ *
+ * @example
+ * ```ts
+ * classifyReceiptTrait('task-successful', 'Cleo tasks update operation succeeded'); // 'operation-status'
+ * classifyReceiptTrait('strict-typescript', 'never use any');                        // null
+ * ```
+ *
+ * @task T12543
+ */
+export declare function classifyReceiptTrait(traitKey: string, traitValue: string): string | null;
+/**
+ * Structural rule id: a legacy `dialectic:*` row with no project stamp. Before
+ * T12543 the only writer of dialectic global traits was the dispatcher hook,
+ * whose "turn" was always an operation envelope — so every such row is a
+ * receipt by construction, whatever its text says.
+ */
+export declare const OPERATION_ENVELOPE_RULE: "operation-envelope";
+/** One trait matched by the repair. */
+export interface TraitPruneCandidate {
+    /** Trait key (primary key). */
+    readonly traitKey: string;
+    /** Trait value at read time. */
+    readonly traitValue: string;
+    /** Trait source (e.g. `dialectic:<sessionId>`). */
+    readonly source: string;
+    /** Originating project id, or `null` for unknown origin. */
+    readonly projectId: string | null;
+    /** Matching rule id (a receipt rule, or {@link OPERATION_ENVELOPE_RULE}). */
+    readonly rule: string;
+}
+/** Options for {@link pruneReceiptTraits}. */
+export interface TraitPruneOptions {
+    /** Delete matched rows (after writing a backup). Default: dry run. */
+    readonly apply?: boolean;
+    /**
+     * Also match every legacy `dialectic:*` row with no project stamp
+     * ({@link OPERATION_ENVELOPE_RULE}). Default: receipt-text rules only.
+     */
+    readonly includeEnvelopeDerived?: boolean;
+    /** Directory for the backup file. Default: `<cleoHome>/backups/user-profile`. */
+    readonly backupDir?: string;
+}
+/** Outcome (and, when applied, receipt) of {@link pruneReceiptTraits}. */
+export interface TraitPruneResult {
+    /** Whether rows were deleted (`false` = dry run). */
+    readonly applied: boolean;
+    /** Row count before the run. */
+    readonly before: number;
+    /** Row count after the run (equals `before` on a dry run). */
+    readonly after: number;
+    /** Number of rows matched. */
+    readonly matched: number;
+    /** Per-rule match counts. */
+    readonly byRule: Record<string, number>;
+    /** Every matched trait key, in key order. */
+    readonly candidateKeys: readonly string[];
+    /** Up to 10 matched rows, so a dry run shows what would go. */
+    readonly sample: readonly TraitPruneCandidate[];
+    /**
+     * Unknown-origin rows (`project_id IS NULL`, scope `project`) that this run
+     * leaves in place. They are excluded from every spawn prompt and remain
+     * queryable via the `nexus.profile.view` operation.
+     */
+    readonly unknownOriginRetained: number;
+    /** Keys actually deleted (apply only). */
+    readonly removedKeys?: readonly string[];
+    /** Keys skipped because the row changed after it was read (apply only). */
+    readonly changedSkipped?: readonly string[];
+    /** ISO-8601 instant of the deletion (apply only). */
+    readonly removedAt?: string;
+    /** Absolute path of the backup written BEFORE any deletion (apply only). */
+    readonly backupPath?: string;
+    /** SHA-256 of the backup file bytes (apply only). */
+    readonly backupSha256?: string;
+    /** Command that reverses the apply (apply only). */
+    readonly restoreCommand?: string;
+}
+/**
+ * List — and with `apply`, remove — receipt-style user-profile traits.
+ *
+ * Apply is reversible: the full matched rows are written to a backup file
+ * before anything is deleted, and each delete is guarded on the row being
+ * unchanged since it was read (a re-derived or edited row is skipped and
+ * reported). Reverse with {@link restorePrunedTraits} /
+ * `cleo memory prune-traits --restore <backupPath>`.
+ *
+ * @param nexusDb - Drizzle handle over the database holding `nexus_user_profile`.
+ * @param options - Apply flag, rule selection and backup location.
+ * @returns Counts, per-rule breakdown, sample, and — when applied — the receipt.
+ *
+ * @example
+ * ```ts
+ * const preview = await pruneReceiptTraits(db);
+ * if (preview.matched > 0) await pruneReceiptTraits(db, { apply: true });
+ * ```
+ *
+ * @task T12543
+ */
+export declare function pruneReceiptTraits(nexusDb: NexusDb, options?: TraitPruneOptions): Promise<TraitPruneResult>;
+/** Outcome of {@link restorePrunedTraits}. */
+export interface TraitRestoreResult {
+    /** Backup file read. */
+    readonly backupPath: string;
+    /** SHA-256 of the backup bytes read (compare with the prune receipt). */
+    readonly backupSha256: string;
+    /** Keys re-inserted. */
+    readonly restoredKeys: readonly string[];
+    /** Keys skipped because a row with that key exists again. */
+    readonly skippedExisting: readonly string[];
+}
+/**
+ * Reverse a {@link pruneReceiptTraits} apply from its backup file.
+ *
+ * Re-inserts each backed-up row verbatim (value, provenance, project stamp,
+ * scope, timestamps). A key that exists again is left untouched — a newer
+ * row always wins over a restore.
+ *
+ * @param nexusDb - Drizzle handle over the database holding `nexus_user_profile`.
+ * @param backupPath - Path from the prune receipt's `backupPath`.
+ * @param expectedSha256 - The receipt's `backupSha256`. When given, a backup
+ *   whose bytes differ is refused before anything is written.
+ * @returns The restored and skipped keys plus the backup digest.
+ *
+ * @task T12543
+ */
+export declare function restorePrunedTraits(nexusDb: NexusDb, backupPath: string, expectedSha256?: string): Promise<TraitRestoreResult>;
+export {};
+//# sourceMappingURL=user-profile-hygiene.d.ts.map

package/dist/nexus/user-profile-hygiene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile-hygiene.d.ts","sourceRoot":"","sources":["../../src/nexus/user-profile-hygiene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAKlE,mEAAmE;AACnE,KAAK,OAAO,GAAG,kBAAkB,CAAC;AAgElC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxF;AAMD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAG,oBAA6B,CAAC;AAErE,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAyDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAiG3B;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA0B7B"}

package/dist/nexus/user-profile-hygiene.js

@@ -0,0 +1,305 @@
+/**
+ * User-profile hygiene: keep operation receipts out of `nexus_user_profile`
+ * and repair the rows that already got in (T12543).
+ *
+ * ## The defect
+ *
+ * The dialectic hook in the CQRS dispatcher fed every successful mutate
+ * operation to the evaluator as a "turn": `cleo <domain> <op> {params}` paired
+ * with `Operation succeeded in domain "<domain>"`. The evaluator minted
+ * user traits from those envelopes — "Operation succeeded in domain 'check'",
+ * "gate set to true for T1655" — and, because the table is GLOBAL, facts
+ * lifted from one project's task params were injected into every other
+ * project's spawn prompts. Measured 2026-09-27: 399 of 404 rows were
+ * `dialectic:<session>` rows, each seen exactly once.
+ *
+ * ## What this module provides
+ *
+ * - {@link classifyReceiptTrait} — the text classifier for status lines and
+ *   operation receipts. REPAIR ONLY: at write time the structural signal
+ *   (`DialecticTurn.origin === 'operation-envelope'`) is the guard, because a
+ *   text rule at write time would also block legitimate preferences.
+ * - {@link pruneReceiptTraits} — dry-run / apply repair. Apply writes a
+ *   backup file FIRST (a `user_profile.json`-shaped envelope carrying the full
+ *   rows), then deletes each row only if it is unchanged since it was read.
+ * - {@link restorePrunedTraits} — re-inserts rows from that backup, never
+ *   overwriting a row that was re-created since.
+ *
+ * @task T12543
+ * @epic T12515
+ */
+import { createHash } from 'node:crypto';
+import { mkdir, open, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { and, eq, isNull } from 'drizzle-orm';
+import { getCleoHome } from '../paths.js';
+import * as nexusSchema from '../store/schema/nexus-schema.js';
+import { getUserProfileTrait, listUserProfile, upsertUserProfileTrait } from './user-profile.js';
+/**
+ * Status-line / operation-receipt rules. A trait matches when ANY rule's key
+ * OR value pattern matches. Each targets a shape that states what an operation
+ * DID, which is never a durable fact about the user.
+ */
+const RECEIPT_RULES = [
+    {
+        // "Operation succeeded in domain 'check'", "Cleo tasks update operation
+        // succeeded". Singular `operation` only: "Operations team review
+        // completed" is prose, not a receipt.
+        id: 'operation-status',
+        value: /\boperation\b[^.\n]{0,30}\b(succeeded|was successful|failed)\b|\b(succeeded|success)\b[^.\n]{0,20}\b(in|for)\b[^.\n]{0,12}\bdomain\b/i,
+    },
+    {
+        // `gate.set-success`, `task-successful`, `succeeded-in-domain-check`.
+        // A leading `success-` followed by other words ("success-criteria-first")
+        // is a preference, not a receipt.
+        id: 'success-key',
+        key: /(^|[-_.])succeed(ed|s)?([-_.]|$)|[-_.]success(ful)?$|^success(ful)?$|^success-in-|(gate|task|ops|operation)[-_.]success/i,
+    },
+    {
+        // An echoed dispatch: `cleo tasks update {…}` / "cleo tasks update
+        // request", or "cleo successfully set …". A sentence that merely names a
+        // command ("cleo memory find is used before…") is not an echo.
+        id: 'command-echo',
+        value: /^\s*cleo\s+[a-z-]+\s+[a-z.-]+\s*(\{|request\b|operation\b|$)|\bcleo (successfully|set|completed|executed|interacted)\b/i,
+    },
+    {
+        // A gate write names a task id or a value ("gate set to true for T122").
+        // "insists every gate is set before complete" names neither.
+        id: 'gate-receipt',
+        value: /\bgate\b[^.\n]{0,80}\bto true\b|\bgate\b[^.\n]{0,60}\bT\d{2,}\b|\bT\d{2,}\b[^.\n]{0,40}\bgate\b|\bgate\.(set|implemented)\b/i,
+    },
+    {
+        id: 'task-receipt',
+        value: /\b(completed|created|added|updated|closed|marked|recorded|passed)\b[^.\n]{0,40}\bT\d{2,}\b|\bT\d{2,}\b[^.\n]{0,40}\b(has been|was|were)\b[^.\n]{0,20}\b(completed|created|added|updated|marked|set)\b/i,
+    },
+    {
+        id: 'session-status',
+        value: /\bactive peer\b|\bglobal peer\b/i,
+        key: /(^|-)active-peer(-|$)/i,
+    },
+];
+/**
+ * Classify a trait as an operation receipt / status line.
+ *
+ * @param traitKey - Trait key (kebab-case semantic key).
+ * @param traitValue - Trait value text.
+ * @returns The id of the first matching rule, or `null` when the trait does
+ *   not look like a receipt.
+ *
+ * @example
+ * ```ts
+ * classifyReceiptTrait('task-successful', 'Cleo tasks update operation succeeded'); // 'operation-status'
+ * classifyReceiptTrait('strict-typescript', 'never use any');                        // null
+ * ```
+ *
+ * @task T12543
+ */
+export function classifyReceiptTrait(traitKey, traitValue) {
+    for (const rule of RECEIPT_RULES) {
+        if (rule.value?.test(traitValue) || rule.key?.test(traitKey))
+            return rule.id;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Repair: prune + restore
+// ---------------------------------------------------------------------------
+/**
+ * Structural rule id: a legacy `dialectic:*` row with no project stamp. Before
+ * T12543 the only writer of dialectic global traits was the dispatcher hook,
+ * whose "turn" was always an operation envelope — so every such row is a
+ * receipt by construction, whatever its text says.
+ */
+export const OPERATION_ENVELOPE_RULE = 'operation-envelope';
+/**
+ * Match one trait against the enabled rules.
+ *
+ * @param trait - Row to classify.
+ * @param includeEnvelopeDerived - Whether the structural rule is enabled.
+ * @returns The matching rule id, or `null`.
+ */
+function matchTrait(trait, includeEnvelopeDerived) {
+    const textRule = classifyReceiptTrait(trait.traitKey, trait.traitValue);
+    if (textRule)
+        return textRule;
+    if (includeEnvelopeDerived &&
+        trait.source.startsWith('dialectic:') &&
+        (trait.projectId ?? null) === null) {
+        return OPERATION_ENVELOPE_RULE;
+    }
+    return null;
+}
+/**
+ * Write `bytes` to a new file and fsync both the file and its directory, so
+ * the backup survives a crash that happens after the deletes commit.
+ *
+ * @param path - New file path (must not exist).
+ * @param dir - Parent directory to fsync.
+ * @param bytes - UTF-8 content.
+ */
+async function writeDurably(path, dir, bytes) {
+    const file = await open(path, 'wx');
+    try {
+        await file.writeFile(bytes, 'utf8');
+        await file.sync();
+    }
+    finally {
+        await file.close();
+    }
+    const dirHandle = await open(dir, 'r');
+    try {
+        await dirHandle.sync();
+    }
+    catch {
+        // Some platforms/filesystems refuse fsync on a directory handle; the file
+        // itself is already synced.
+    }
+    finally {
+        await dirHandle.close();
+    }
+}
+/**
+ * List — and with `apply`, remove — receipt-style user-profile traits.
+ *
+ * Apply is reversible: the full matched rows are written to a backup file
+ * before anything is deleted, and each delete is guarded on the row being
+ * unchanged since it was read (a re-derived or edited row is skipped and
+ * reported). Reverse with {@link restorePrunedTraits} /
+ * `cleo memory prune-traits --restore <backupPath>`.
+ *
+ * @param nexusDb - Drizzle handle over the database holding `nexus_user_profile`.
+ * @param options - Apply flag, rule selection and backup location.
+ * @returns Counts, per-rule breakdown, sample, and — when applied — the receipt.
+ *
+ * @example
+ * ```ts
+ * const preview = await pruneReceiptTraits(db);
+ * if (preview.matched > 0) await pruneReceiptTraits(db, { apply: true });
+ * ```
+ *
+ * @task T12543
+ */
+export async function pruneReceiptTraits(nexusDb, options = {}) {
+    const includeEnvelopeDerived = options.includeEnvelopeDerived === true;
+    const all = await listUserProfile(nexusDb, { includeSuperseded: true });
+    const matchedRows = [];
+    const byRule = {};
+    for (const trait of all) {
+        const rule = matchTrait(trait, includeEnvelopeDerived);
+        if (!rule)
+            continue;
+        matchedRows.push({ trait, rule });
+        byRule[rule] = (byRule[rule] ?? 0) + 1;
+    }
+    matchedRows.sort((a, b) => a.trait.traitKey.localeCompare(b.trait.traitKey));
+    const matchedKeys = new Set(matchedRows.map((m) => m.trait.traitKey));
+    const unknownOriginRetained = all.filter((t) => (t.projectId ?? null) === null &&
+        (t.scope ?? 'project') === 'project' &&
+        !matchedKeys.has(t.traitKey)).length;
+    const report = {
+        before: all.length,
+        matched: matchedRows.length,
+        byRule,
+        candidateKeys: matchedRows.map((m) => m.trait.traitKey),
+        sample: matchedRows.slice(0, 10).map(({ trait, rule }) => ({
+            traitKey: trait.traitKey,
+            traitValue: trait.traitValue,
+            source: trait.source,
+            projectId: trait.projectId ?? null,
+            rule,
+        })),
+        unknownOriginRetained,
+    };
+    if (!options.apply || matchedRows.length === 0) {
+        return { applied: false, after: all.length, ...report };
+    }
+    // 1. Backup FIRST — nothing is deleted unless the backup is durable on disk.
+    const removedAt = new Date().toISOString();
+    const backupDir = options.backupDir ?? join(getCleoHome(), 'backups', 'user-profile');
+    await mkdir(backupDir, { recursive: true });
+    const backupPath = join(backupDir, `receipt-traits-${removedAt.replace(/[:.]/g, '-')}.json`);
+    const backup = {
+        $schema: 'https://cleocode.dev/schemas/user-profile/v1.json',
+        exportedAt: removedAt,
+        reason: `T12543 prune-traits (${includeEnvelopeDerived ? 'receipt-text + operation-envelope' : 'receipt-text'})`,
+        traits: matchedRows.map((m) => m.trait),
+    };
+    const bytes = `${JSON.stringify(backup, null, 2)}\n`;
+    await writeDurably(backupPath, backupDir, bytes);
+    const backupSha256 = createHash('sha256').update(bytes).digest('hex');
+    // 2. One transaction of guarded deletes: a row is removed only if EVERY
+    //    field the backup captured is unchanged since the read above.
+    const removedKeys = [];
+    const changedSkipped = [];
+    const table = nexusSchema.userProfile;
+    nexusDb.transaction((tx) => {
+        for (const { trait } of matchedRows) {
+            const deleted = tx
+                .delete(table)
+                .where(and(eq(table.traitKey, trait.traitKey), eq(table.traitValue, trait.traitValue), eq(table.source, trait.source), eq(table.confidence, trait.confidence), eq(table.scope, trait.scope ?? 'project'), trait.projectId == null
+                ? isNull(table.projectId)
+                : eq(table.projectId, trait.projectId), trait.supersededBy == null
+                ? isNull(table.supersededBy)
+                : eq(table.supersededBy, trait.supersededBy), eq(table.lastReinforcedAt, new Date(trait.lastReinforcedAt).toISOString())))
+                .returning({ traitKey: table.traitKey })
+                .all();
+            if (deleted.length > 0)
+                removedKeys.push(trait.traitKey);
+            else
+                changedSkipped.push(trait.traitKey);
+        }
+    });
+    const after = (await listUserProfile(nexusDb, { includeSuperseded: true })).length;
+    return {
+        applied: true,
+        after,
+        ...report,
+        removedKeys,
+        changedSkipped,
+        removedAt,
+        backupPath,
+        backupSha256,
+        restoreCommand: `cleo memory prune-traits --restore '${backupPath}' --sha256 ${backupSha256}`,
+    };
+}
+/**
+ * Reverse a {@link pruneReceiptTraits} apply from its backup file.
+ *
+ * Re-inserts each backed-up row verbatim (value, provenance, project stamp,
+ * scope, timestamps). A key that exists again is left untouched — a newer
+ * row always wins over a restore.
+ *
+ * @param nexusDb - Drizzle handle over the database holding `nexus_user_profile`.
+ * @param backupPath - Path from the prune receipt's `backupPath`.
+ * @param expectedSha256 - The receipt's `backupSha256`. When given, a backup
+ *   whose bytes differ is refused before anything is written.
+ * @returns The restored and skipped keys plus the backup digest.
+ *
+ * @task T12543
+ */
+export async function restorePrunedTraits(nexusDb, backupPath, expectedSha256) {
+    const bytes = await readFile(backupPath, 'utf8');
+    const actualSha256 = createHash('sha256').update(bytes).digest('hex');
+    if (expectedSha256 !== undefined && actualSha256 !== expectedSha256.toLowerCase()) {
+        throw new Error(`E_BACKUP_DIGEST_MISMATCH: ${backupPath} has sha256 ${actualSha256}, the receipt says ${expectedSha256}; nothing restored`);
+    }
+    const backup = JSON.parse(bytes);
+    const traits = Array.isArray(backup.traits) ? backup.traits : [];
+    const restoredKeys = [];
+    const skippedExisting = [];
+    for (const trait of traits) {
+        if (await getUserProfileTrait(nexusDb, trait.traitKey)) {
+            skippedExisting.push(trait.traitKey);
+            continue;
+        }
+        await upsertUserProfileTrait(nexusDb, trait);
+        restoredKeys.push(trait.traitKey);
+    }
+    return {
+        backupPath,
+        backupSha256: actualSha256,
+        restoredKeys,
+        skippedExisting,
+    };
+}
+//# sourceMappingURL=user-profile-hygiene.js.map

package/dist/nexus/user-profile-hygiene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile-hygiene.js","sourceRoot":"","sources":["../../src/nexus/user-profile-hygiene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAmBjG;;;;GAIG;AACH,MAAM,aAAa,GAA2B;IAC5C;QACE,wEAAwE;QACxE,iEAAiE;QACjE,sCAAsC;QACtC,EAAE,EAAE,kBAAkB;QACtB,KAAK,EACH,uIAAuI;KAC1I;IACD;QACE,sEAAsE;QACtE,0EAA0E;QAC1E,kCAAkC;QAClC,EAAE,EAAE,aAAa;QACjB,GAAG,EAAE,0HAA0H;KAChI;IACD;QACE,mEAAmE;QACnE,yEAAyE;QACzE,+DAA+D;QAC/D,EAAE,EAAE,cAAc;QAClB,KAAK,EACH,yHAAyH;KAC5H;IACD;QACE,yEAAyE;QACzE,6DAA6D;QAC7D,EAAE,EAAE,cAAc;QAClB,KAAK,EACH,8HAA8H;KACjI;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EACH,wMAAwM;KAC3M;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,kCAAkC;QACzC,GAAG,EAAE,wBAAwB;KAC9B;CACF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,UAAkB;IACvE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAA6B,CAAC;AAyErE;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,KAAuB,EAAE,sBAA+B;IAC1E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACxE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IACE,sBAAsB;QACtB,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC;QACrC,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,EAClC,CAAC;QACD,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,GAAW,EAAE,KAAa;IAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,4BAA4B;IAC9B,CAAC;YAAS,CAAC;QACT,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,UAA6B,EAAE;IAE/B,MAAM,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,KAAK,IAAI,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,WAAW,GAAqD,EAAE,CAAC;IACzE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,MAAM,qBAAqB,GAAG,GAAG,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI;QAC9B,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,SAAS;QACpC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAC/B,CAAC,MAAM,CAAC;IAET,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,WAAW,CAAC,MAAM;QAC3B,MAAM;QACN,aAAa,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvD,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACzD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,IAAI;SACL,CAAC,CAAC;QACH,qBAAqB;KACtB,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED,6EAA6E;IAC7E,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IACtF,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAqB;QAC/B,OAAO,EAAE,mDAAmD;QAC5D,UAAU,EAAE,SAAS;QACrB,MAAM,EAAE,wBAAwB,sBAAsB,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,cAAc,GAAG;QAChH,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;KACxC,CAAC;IACF,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACrD,MAAM,YAAY,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEtE,wEAAwE;IACxE,kEAAkE;IAClE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC;IACtC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;QACzB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,EAAE;iBACf,MAAM,CAAC,KAAK,CAAC;iBACb,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EAClC,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EACtC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAC9B,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EACtC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,EACzC,KAAK,CAAC,SAAS,IAAI,IAAI;gBACrB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;gBACzB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EACxC,KAAK,CAAC,YAAY,IAAI,IAAI;gBACxB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;gBAC5B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,EAC9C,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC,CAC3E,CACF;iBACA,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;iBACvC,GAAG,EAAE,CAAC;YACT,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;;gBACpD,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,OAAO;QACL,OAAO,EAAE,IAAI;QACb,KAAK;QACL,GAAG,MAAM;QACT,WAAW;QACX,cAAc;QACd,SAAS;QACT,UAAU;QACV,YAAY;QACZ,cAAc,EAAE,uCAAuC,UAAU,cAAc,YAAY,EAAE;KAC9F,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAgB,EAChB,UAAkB,EAClB,cAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,IAAI,cAAc,KAAK,SAAS,IAAI,YAAY,KAAK,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CACb,6BAA6B,UAAU,eAAe,YAAY,sBAAsB,cAAc,oBAAoB,CAC3H,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA8B,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,MAAM,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrC,SAAS;QACX,CAAC;QACD,MAAM,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7C,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,OAAO;QACL,UAAU;QACV,YAAY,EAAE,YAAY;QAC1B,YAAY;QACZ,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/nexus/user-profile.d.ts

@@ -19,11 +19,32 @@
  * @task T1078
  * @epic T1076
  */
-import type { NexusProfileExportResult, NexusProfileGetResult, NexusProfileImportResult, NexusProfileReinforceResult, NexusProfileSupersedeResult, NexusProfileUpsertResult, NexusProfileViewResult, UserProfileTrait } from '@cleocode/contracts';
+import type { NexusProfileExportResult, NexusProfileGetResult, NexusProfileImportResult, NexusProfileReinforceResult, NexusProfileSupersedeResult, NexusProfileUpsertResult, NexusProfileViewResult, UserProfileScope, UserProfileTrait } from '@cleocode/contracts';
 import type { NodeSQLiteDatabase } from 'drizzle-orm/node-sqlite';
 import { type EngineResult } from '../engine-result.js';
 /** Type alias for the Drizzle nexus database instance. */
 type NexusDb = NodeSQLiteDatabase;
+/**
+ * Resolve the portable project id a trait derived under `projectRoot` is
+ * stamped with (T12543).
+ *
+ * Uses the tracked write-once `.cleo/project-id` (ADR-094) and falls back to
+ * the `projectId` in `.cleo/project-info.json`. Never derives an id from the
+ * path: a path hash differs per checkout and device, so it would silently
+ * re-scope traits. Returns `null` when neither identity is readable — the
+ * caller then records the trait as unknown-origin (never shown in prompts).
+ *
+ * @param projectRoot - Absolute project root the trait was derived in.
+ * @returns The portable project id, or `null` when none is declared.
+ *
+ * @example
+ * ```ts
+ * const projectId = resolveTraitProjectId('/work/cleocode'); // 'c78d09c3a8ee'
+ * ```
+ *
+ * @task T12543
+ */
+export declare function resolveTraitProjectId(projectRoot: string): string | null;
 /**
  * Fetch a single user-profile trait by its key.
  *
@@ -43,12 +64,34 @@ export declare function getUserProfileTrait(nexusDb: NexusDb, traitKey: string):
  * The `firstObservedAt` field is preserved from the existing row on update.
  *
  * @param nexusDb - Drizzle nexus database handle.
+ * `projectId` and `scope` (T12543) default to `null` (unknown origin) and
+ * `'project'`; the whole row — value and visibility — is replaced together.
+ * A `project`-scoped write never replaces an existing `user`-scoped row.
+ *
  * @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>;
+/**
+ * Explicitly set the visibility scope of an existing trait (T12543).
+ *
+ * The only path that can promote a trait to user-global (`user`, visible in
+ * every project) or demote one back to `project`. Value, provenance and the
+ * project stamp are unchanged.
+ *
+ * @param nexusDb  - Drizzle nexus database handle.
+ * @param traitKey - Key of the trait to re-scope.
+ * @param scope    - New scope.
+ * @returns The previous scope, or `null` when no such trait exists.
+ *
+ * @example
+ * ```ts
+ * await setUserProfileTraitScope(db, 'prefers-zero-deps', 'user');
+ * ```
+ */
+export declare function setUserProfileTraitScope(nexusDb: NexusDb, traitKey: string, scope: UserProfileScope): Promise<UserProfileScope | null>;
 /**
  * Increment the reinforcement count for an existing trait and boost its
  * confidence.
@@ -80,6 +123,14 @@ export declare function listUserProfile(nexusDb: NexusDb, opts?: {
     minConfidence?: number;
     /** Include superseded (deprecated) traits. Defaults to false. */
     includeSuperseded?: boolean;
+    /**
+     * Restrict to the traits visible in one project's prompts (T12543):
+     * `user`-scoped traits plus `project` traits stamped with this portable
+     * project id. `null` = the project has no declared identity, so only
+     * user-global traits are returned. Omit to list every row (admin view,
+     * export) — unknown-origin rows included.
+     */
+    visibleInProject?: string | null;
 }): Promise<UserProfileTrait[]>;
 /**
  * Mark a trait as superseded by another, implementing the T1139 supersession
@@ -101,7 +152,7 @@ export declare function nexusProfileGet(traitKey: string): Promise<EngineResult<
 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 nexusProfileUpsert(trait: Pick<UserProfileTrait, 'traitKey' | 'traitValue' | 'confidence' | 'source' | 'derivedFromMessageId' | 'scope'>): Promise<EngineResult<NexusProfileUpsertResult>>;
 export declare function nexusProfileSupersede(oldKey: string, newKey: string): Promise<EngineResult<NexusProfileSupersedeResult>>;
 export {};
 //# sourceMappingURL=user-profile.d.ts.map

package/dist/nexus/user-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-profile.d.ts","sourceRoot":"","sources":["../../src/nexus/user-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAIpF,0DAA0D;AAC1D,KAAK,OAAO,GAAG,kBAAkB,CAAC;AA0ClC;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CASlC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;IACL,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GACA,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmB7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAKf;AAOD,wBAAsB,gBAAgB,CACpC,aAAa,CAAC,EAAE,MAAM,EACtB,iBAAiB,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAQ/C;AAGD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAQ9C;AAGD,wBAAsB,kBAAkB,CACtC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC,CAQjD;AAGD,wBAAsB,kBAAkB,CACtC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC,CAQjD;AAGD,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC,CAepD;AAGD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,IAAI,CACT,gBAAgB,EAChB,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,sBAAsB,CAC7E,GACA,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC,CAiBjD;AAGD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC,CAQpD"}
+{"version":3,"file":"user-profile.d.ts","sourceRoot":"","sources":["../../src/nexus/user-profile.ts"],"names":[],"mappings":"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"}