@remnic/core 1.1.31 → 9.3.515

package/dist/orchestrator.js

@@ -26,174 +26,177 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-QLLBRHAT.js";
-import "./chunk-WNARATI3.js";
-import "./chunk-KOSORCJG.js";
+} from "./chunk-R26QUUQN.js";
+import "./chunk-Y2SXZ5KZ.js";
 import "./chunk-BFBF3XEF.js";
+import "./chunk-S53PKKWK.js";
 import "./chunk-HHLLAQGZ.js";
 import "./chunk-UWK5OXUJ.js";
-import "./chunk-2PRLKQAH.js";
+import "./chunk-RLV3PQGH.js";
+import "./chunk-TPDBFYEG.js";
+import "./chunk-KCYE2MZM.js";
 import "./chunk-7XYTQGCC.js";
-import "./chunk-34DQE4KF.js";
-import "./chunk-56K5QLHX.js";
+import "./chunk-CO7ZO4TU.js";
+import "./chunk-4HP7HIE3.js";
 import "./chunk-7N4KAIGN.js";
-import "./chunk-TPDBFYEG.js";
-import "./chunk-ZTFCYYEZ.js";
 import "./chunk-TECVW3JP.js";
-import "./chunk-RYED3SPJ.js";
-import "./chunk-A6KTB5R6.js";
-import "./chunk-U4SCL7B7.js";
+import "./chunk-T2PO5MUF.js";
+import "./chunk-IQ3OI2RR.js";
+import "./chunk-DRD2Q7HQ.js";
 import "./chunk-UHGBNIOS.js";
-import "./chunk-FSFEQI74.js";
-import "./chunk-OIGNEXKZ.js";
+import "./chunk-W7L6HXUC.js";
+import "./chunk-K5O2QY6T.js";
 import "./chunk-MDYG7VI7.js";
 import "./chunk-Z5AAYHUC.js";
 import "./chunk-S75M5ZRK.js";
-import "./chunk-TPB3I2AC.js";
-import "./chunk-H3ME6L6D.js";
+import "./chunk-ECZU5BJH.js";
+import "./chunk-46GJIW5M.js";
 import "./chunk-XJNBEDFE.js";
 import "./chunk-VWT3F4IV.js";
-import "./chunk-JR4ZC3G4.js";
-import "./chunk-K4FLSOR5.js";
+import "./chunk-DLJ4IR6M.js";
+import "./chunk-USYGGIJZ.js";
 import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
-import "./chunk-5NPGSAVB.js";
-import "./chunk-C7VW7C3F.js";
+import "./chunk-XEKAG3FM.js";
+import "./chunk-TDKQGLJW.js";
 import "./chunk-OZKZ2TRP.js";
-import "./chunk-7DHTMOND.js";
-import "./chunk-WPGJYVUH.js";
-import "./chunk-ZZTOURJI.js";
 import "./chunk-YDBIWGNI.js";
+import "./chunk-7DHTMOND.js";
+import "./chunk-MGVIEM2O.js";
 import "./chunk-YCN4BVDK.js";
-import "./chunk-D654IBA6.js";
+import "./chunk-ZZTOURJI.js";
+import "./chunk-XKXKSQU7.js";
 import "./chunk-3GPTTA4J.js";
 import "./chunk-IISBCCWR.js";
-import "./chunk-U3WSW6PZ.js";
+import "./chunk-QMYXNM4P.js";
 import "./chunk-H63EDPFJ.js";
 import "./chunk-PD6O7AXF.js";
 import "./chunk-YAZNBMNF.js";
 import "./chunk-LCR46JY5.js";
 import "./chunk-C4SQJZAF.js";
-import "./chunk-W3LR522O.js";
+import "./chunk-KM2A35EO.js";
 import "./chunk-4RA3C3EV.js";
-import "./chunk-WW3QQF4H.js";
+import "./chunk-ROZJACKP.js";
 import "./chunk-54V4BZWP.js";
-import "./chunk-QR3C7BKQ.js";
-import "./chunk-EDTHC6UD.js";
+import "./chunk-XZ4WBBB5.js";
+import "./chunk-77NAFXUD.js";
 import "./chunk-DB5A3NHS.js";
-import "./chunk-43PJZYGL.js";
+import "./chunk-FPGE5NVO.js";
 import "./chunk-6NKAQ74D.js";
 import "./chunk-OAZ5MFUB.js";
 import "./chunk-PYPOFEMK.js";
-import "./chunk-3IQ2TR4N.js";
+import "./chunk-WLEB7WCG.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-5NXIJZFX.js";
 import "./chunk-Y4FHOFJ2.js";
-import "./chunk-NMZY542O.js";
+import "./chunk-6URPAY2D.js";
 import "./chunk-3PG3H5TD.js";
-import "./chunk-2NMMFZ5T.js";
-import "./chunk-XSZEP4SF.js";
-import "./chunk-4KGVTPGD.js";
-import "./chunk-RHY3HH7P.js";
-import "./chunk-EJI5XIBB.js";
+import "./chunk-OD4FM2U7.js";
+import "./chunk-6XSPNR6L.js";
+import "./chunk-6F6BXB7A.js";
+import "./chunk-JFEKNTX7.js";
+import "./chunk-JLNBQWZ2.js";
+import "./chunk-HPWVAEET.js";
 import "./chunk-2PRQG7PV.js";
-import "./chunk-LUDTDZLK.js";
-import "./chunk-JA3AK3PT.js";
-import "./chunk-PYXS46O7.js";
-import "./chunk-3QKK7QOS.js";
+import "./chunk-XNLXAWHX.js";
+import "./chunk-3BP57I6J.js";
+import "./chunk-TERNBNJB.js";
 import "./chunk-W4RVMTHR.js";
-import "./chunk-SAZS2QZB.js";
-import "./chunk-CULXMQJH.js";
-import "./chunk-5375UYTQ.js";
+import "./chunk-23UORJ4S.js";
+import "./chunk-XPXEJRUB.js";
+import "./chunk-A6D7A2FW.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-EABGC2TL.js";
-import "./chunk-RR2PKP3I.js";
-import "./chunk-575RMLWN.js";
-import "./chunk-I5GLV3VE.js";
+import "./chunk-4426WSWL.js";
+import "./chunk-A2Z6UCWT.js";
+import "./chunk-7MV5CWTE.js";
+import "./chunk-EIPUHVKE.js";
+import "./chunk-A52AKD7C.js";
+import "./chunk-RCTS5CKK.js";
 import "./chunk-NJ3MJQZX.js";
-import "./chunk-XVVIG67A.js";
+import "./chunk-BLZAVUD2.js";
 import "./chunk-PIRJPV5T.js";
-import "./chunk-RXDLTSWT.js";
-import "./chunk-3VAL7ZL2.js";
-import "./chunk-TMQLARTH.js";
-import "./chunk-MJFNCJXV.js";
-import "./chunk-CYFQJMUV.js";
+import "./chunk-Q4CAQGKQ.js";
+import "./chunk-ONPLNAPX.js";
+import "./chunk-CINZGPSJ.js";
+import "./chunk-CHBI22MI.js";
+import "./chunk-ZFXCQPNO.js";
+import "./chunk-KIB7SDIJ.js";
+import "./chunk-ORFGK3XI.js";
+import "./chunk-HENLZHIT.js";
 import "./chunk-7DTASS5T.js";
-import "./chunk-FJ43PRLT.js";
-import "./chunk-LLQ2LLWF.js";
-import "./chunk-YRMVARQP.js";
-import "./chunk-3TNBOMQT.js";
-import "./chunk-HXXBL2KD.js";
-import "./chunk-LPMVBPA3.js";
+import "./chunk-KFY3SGN7.js";
+import "./chunk-TVRN5QKH.js";
+import "./chunk-BECQDWBA.js";
+import "./chunk-CWWMTTQE.js";
 import "./chunk-JXS5PDQ7.js";
-import "./chunk-HMDCOMYU.js";
-import "./chunk-7SEAZFFB.js";
-import "./chunk-D46YSIYX.js";
+import "./chunk-SKGV326D.js";
+import "./chunk-BEUDU7Y4.js";
+import "./chunk-G3Z3QEF5.js";
 import "./chunk-AJU4PJGY.js";
-import "./chunk-C6QPK5GG.js";
-import "./chunk-2KI4QFHU.js";
-import "./chunk-OZHRDTDX.js";
+import "./chunk-FZZ2QTJI.js";
+import "./chunk-LMDRGRJ2.js";
+import "./chunk-OKTXM5H4.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-KVE7R4CG.js";
 import "./chunk-4WMCPJWX.js";
-import "./chunk-5RGLBDQF.js";
-import "./chunk-DINWEURR.js";
-import "./chunk-FLTNHQK6.js";
+import "./chunk-EVZFIAPG.js";
+import "./chunk-CSKLPDN6.js";
+import "./chunk-B5XMS73R.js";
 import "./chunk-7SI52C65.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-UZB5KHKX.js";
 import "./chunk-RK6F44Y6.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-6HZ6AO2P.js";
-import "./chunk-JWPLJLDU.js";
-import "./chunk-N53K2EXC.js";
-import "./chunk-XYIK4LF6.js";
-import "./chunk-NZL6GGQE.js";
+import "./chunk-KD3QD3A5.js";
+import "./chunk-6VF75M3X.js";
+import "./chunk-H3FZVNRN.js";
+import "./chunk-HQ6NIBL6.js";
 import "./chunk-PVGDJXVK.js";
-import "./chunk-NGAVDO7E.js";
-import "./chunk-FDU6HUUL.js";
-import "./chunk-QDZ2RLEC.js";
-import "./chunk-MGKYQQYF.js";
-import "./chunk-3APJ5EVB.js";
-import "./chunk-5UM2VJ6D.js";
-import "./chunk-RRF5UOBJ.js";
-import "./chunk-NBNN5GOB.js";
+import "./chunk-OADWQ5CR.js";
+import "./chunk-EDQVAMQI.js";
+import "./chunk-472U7RDF.js";
+import "./chunk-7Q3RCKAQ.js";
+import "./chunk-XKIQZXUB.js";
+import "./chunk-UEY3VB6W.js";
+import "./chunk-EI6V5UXY.js";
+import "./chunk-QY7YA7OL.js";
 import "./chunk-NNVTUXEB.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-25MQ7IHJ.js";
-import "./chunk-U3PN77QT.js";
-import "./chunk-RK2Y4XOM.js";
+import "./chunk-EUML3N6B.js";
+import "./chunk-4JRRISLU.js";
 import "./chunk-2LSZVONP.js";
-import "./chunk-WIICJPET.js";
-import "./chunk-VBJ7V5SK.js";
+import "./chunk-DEUNUKTD.js";
+import "./chunk-UIPDNLXA.js";
 import "./chunk-5UZXUTVO.js";
-import "./chunk-NN2DKE4T.js";
-import "./chunk-Q7P4WJDP.js";
+import "./chunk-4H5ZJHEN.js";
+import "./chunk-M5T4Q2ZU.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-3KW65B36.js";
+import "./chunk-KILOTVIF.js";
 import "./chunk-3HPAPHUK.js";
-import "./chunk-PFV5C235.js";
+import "./chunk-CPPS65WS.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-FAAFWE4G.js";
-import "./chunk-QRNI5JBH.js";
-import "./chunk-MY6TPVXW.js";
+import "./chunk-ALEPI75L.js";
+import "./chunk-LMPHTYJC.js";
 import "./chunk-DT5TVLJE.js";
-import "./chunk-UWVJF25J.js";
+import "./chunk-HWVTS5NO.js";
+import "./chunk-U3PN77QT.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-XIG5PDM7.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-2ODBA7MQ.js";
-import "./chunk-DGXUHMOV.js";
+import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
-import "./chunk-MXFBBHJU.js";
+import "./chunk-KJMYHC7K.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-AC5LO7IU.js";

package/dist/page-versioning.js

@@ -5,7 +5,7 @@ import {
   listVersions,
   revertToVersion,
   sidecarKey
-} from "./chunk-FAAFWE4G.js";
+} from "./chunk-ALEPI75L.js";
 import "./chunk-PZ5AY32C.js";
 export {
   createVersion,

package/dist/path-X2K5XCHL.js

@@ -0,0 +1,9 @@
+import {
+  expandTildePath
+} from "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  expandTildePath
+};
+//# sourceMappingURL=path-X2K5XCHL.js.map

package/dist/patterns-cli.d.ts

@@ -1,4 +1,5 @@
 import { MemoryCategory, MemoryFile } from './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 
 /**

package/dist/peers/index.d.ts

@@ -0,0 +1,328 @@
+import { a as Peer, b as PeerProfile, P as PeerInteractionLogEntry } from '../types-B1VHaf2w.js';
+export { c as PEER_ID_MAX_LENGTH, d as PEER_ID_PATTERN, e as PeerKind, f as PeerProfileFieldProvenance } from '../types-B1VHaf2w.js';
+export { P as PEERS_DIR_NAME, a as appendInteractionLog, b as assertValidPeerId, d as deletePeer, f as forgetPeer, l as listPeers, r as readInteractionLogRaw, c as readPeer, e as readPeerInteractionLog, g as readPeerProfile, w as writePeer, h as writePeerProfile } from '../storage-C4DX8CuG.js';
+
+/**
+ * Peer profile reasoner — issue #679 PR 2/5.
+ *
+ * Pure async function that, for each peer:
+ *
+ *   1. Reads recent interaction-log entries via `readPeerInteractionLog`.
+ *   2. Calls an injected LLM client (same chat shape as
+ *      `FallbackLlmClient.chatCompletion`) to derive 0..N profile-field
+ *      proposals with provenance `{observedAt, signal, sourceSessionId,
+ *      note}`.
+ *   3. Merges the proposals into the peer's existing `PeerProfile`,
+ *      appending provenance entries (never replacing existing
+ *      provenance — the reasoner is additive by design so the operator
+ *      retains the full audit trail).
+ *   4. Writes via `writePeerProfile`.
+ *
+ * Gating is handled in two layers:
+ *
+ *   - The orchestrator wires the call behind the
+ *     `peerProfileReasonerEnabled` config flag (default `false` —
+ *     opt-in per Gotcha #30/#48). The reasoner ALSO short-circuits
+ *     when `options.enabled !== true`, so direct callers can't
+ *     accidentally bypass the flag.
+ *   - Per-peer, the `peerProfileReasonerMinInteractions` threshold
+ *     skips peers whose log has fewer entries since the last reasoner
+ *     run than required.
+ *
+ * The reasoner is intentionally storage-agnostic — it accepts an LLM
+ * client by interface (`PeerProfileReasonerLlm`) so tests can mock the
+ * call and the orchestrator can inject either the gateway client or
+ * a fast local model. No direct OpenAI imports here.
+ */
+
+/**
+ * Minimal chat-completion contract the reasoner depends on. Matches
+ * `FallbackLlmClient.chatCompletion` so the orchestrator can pass it
+ * through directly. Tests inject a mock that returns canned strings.
+ *
+ * Returning `null` means the LLM is unavailable / failed — the
+ * reasoner treats that as "no proposals for this peer" rather than an
+ * error so a flaky LLM never aborts the whole pass.
+ */
+interface PeerProfileReasonerLlm {
+    chatCompletion(messages: Array<{
+        role: "system" | "user" | "assistant";
+        content: string;
+    }>, options?: {
+        temperature?: number;
+        maxTokens?: number;
+        timeoutMs?: number;
+    }): Promise<{
+        content: string;
+    } | null>;
+}
+/**
+ * One LLM-proposed profile-field update.
+ *
+ * `value` is the new markdown string to set under `field`. The
+ * provenance entry the LLM emits travels alongside it; the reasoner
+ * does NOT trust the LLM's `observedAt` — it always overwrites with
+ * the run's `now` timestamp so provenance can never claim future or
+ * past observation timestamps the operator didn't witness.
+ */
+interface PeerProfileReasonerProposal {
+    /** Stable section key, e.g. "communication_style". */
+    readonly field: string;
+    /** Markdown value to set under that key. */
+    readonly value: string;
+    /**
+     * Short label for the signal that justified the inference,
+     * e.g. "explicit_preference", "tool_pattern", "topic_recurrence".
+     */
+    readonly signal: string;
+    /** Optional free-form note explaining the inference. */
+    readonly note?: string;
+    /**
+     * Originating session id, when the LLM can attribute the inference
+     * to a specific log line. Reasoner clamps this to a value that
+     * actually appeared in the log window so the LLM can't hallucinate.
+     */
+    readonly sourceSessionId?: string;
+}
+interface PeerProfileReasonerOptions {
+    /** Memory directory containing the peers/ subtree. */
+    readonly memoryDir: string;
+    /**
+     * Master gate. When `false` (the default the orchestrator passes
+     * when the config flag is off), the reasoner is a no-op and
+     * returns an empty result. Direct callers must explicitly pass
+     * `true` so the gate can never be defaulted ON by accident
+     * (Gotcha #48 — least-privileged default).
+     */
+    readonly enabled: boolean;
+    /** Injected LLM client. Required when `enabled === true`. */
+    readonly llm?: PeerProfileReasonerLlm;
+    /** Model name to log for telemetry; not used to dispatch. */
+    readonly model?: string;
+    /**
+     * Minimum new interaction-log entries since last reasoner run
+     * before this peer is processed. Peers below the threshold are
+     * skipped with `reason: "below_min_interactions"`.
+     */
+    readonly minInteractions: number;
+    /**
+     * Hard cap on profile fields the reasoner will accept across all
+     * peers in a single run. Tracked in insertion order: once the cap
+     * is reached, subsequent proposals are dropped with
+     * `dropped_due_to_cap` in the per-peer result. Use to bound LLM
+     * cost and reviewer load per pass.
+     */
+    readonly maxFieldsPerRun: number;
+    /**
+     * Optional restriction to specific peer ids. When omitted, the
+     * reasoner enumerates the entire peer registry via `listPeers`.
+     */
+    readonly peerIds?: ReadonlyArray<string>;
+    /**
+     * Maximum number of recent log entries to feed the LLM per peer.
+     * Defaults to 50. Bounded so a runaway log can't blow the prompt.
+     */
+    readonly maxLogEntriesPerPeer?: number;
+    /**
+     * Reasoner run timestamp. Defaults to `new Date()` at call time.
+     * Tests inject a deterministic clock; the orchestrator passes
+     * `new Date()` so provenance entries reflect actual wall time.
+     */
+    readonly now?: Date;
+    /**
+     * Optional logger; defaults to a no-op so the reasoner stays
+     * silent in unit tests. The orchestrator wires its `log` here so
+     * runs surface in the gateway log under the
+     * `[peer-profile-reasoner]` prefix.
+     */
+    readonly log?: {
+        debug?: (msg: string) => void;
+        info?: (msg: string) => void;
+        warn?: (msg: string) => void;
+    };
+    /**
+     * Whether to append a `peer_profile_reasoner_run` entry to the
+     * peer's interaction log when the reasoner emits at least one
+     * field for that peer. Defaults to `true`. Disable in tests that
+     * want to assert the log was untouched.
+     */
+    readonly appendRunMarkerToLog?: boolean;
+    /**
+     * Optional abort signal. The reasoner checks between peers and
+     * returns the partial result if cancelled mid-run.
+     */
+    readonly signal?: AbortSignal;
+}
+interface PeerProfileReasonerPeerResult {
+    readonly peerId: string;
+    readonly status: "processed" | "skipped_below_min_interactions" | "skipped_no_log" | "skipped_disabled" | "skipped_no_llm" | "skipped_llm_unavailable" | "skipped_invalid_proposal" | "skipped_cap_reached" | "skipped_aborted" | "error";
+    /** Number of fields actually applied to the peer's profile. */
+    readonly fieldsApplied: number;
+    /** Number of proposals dropped because the per-run cap was hit. */
+    readonly droppedDueToCap: number;
+    /** Set of field keys applied; useful for tests and telemetry. */
+    readonly fields: ReadonlyArray<string>;
+    /** Error message, when `status === "error"`. */
+    readonly error?: string;
+}
+interface PeerProfileReasonerResult {
+    readonly peersConsidered: number;
+    readonly peersProcessed: number;
+    readonly fieldsApplied: number;
+    readonly perPeer: ReadonlyArray<PeerProfileReasonerPeerResult>;
+}
+/**
+ * Build the user-facing reasoner prompt. The system message carries
+ * the strict-JSON instruction; this function emits the user message
+ * with the peer context and the recent log slice.
+ *
+ * The prompt is intentionally schema-prescriptive — sibling modules
+ * (`semantic-consolidation.ts`, `extraction-judge.ts`) demonstrated
+ * that letting the LLM improvise field names produces unstable
+ * profiles across runs.
+ */
+declare function buildPeerProfileReasonerPrompt(input: {
+    peer: Peer;
+    existingProfile: PeerProfile | null;
+    log: ReadonlyArray<PeerInteractionLogEntry>;
+    maxFields: number;
+}): string;
+/**
+ * Parse the LLM response. Tolerates a fenced code block wrapper.
+ * Returns an empty array on any malformed payload — the contract is
+ * that flaky LLM output silently produces zero proposals rather than
+ * surfacing an error to the caller.
+ *
+ * Exported so unit tests can verify parser behavior without spinning
+ * up the full reasoner.
+ */
+declare function parsePeerProfileReasonerResponse(raw: string): PeerProfileReasonerProposal[];
+/**
+ * Run the reasoner across all (or the requested subset of) peers.
+ *
+ * Always returns a `PeerProfileReasonerResult` — never throws to the
+ * caller — so the orchestrator can wire it as a best-effort
+ * post-consolidation hook (Gotcha #13).
+ */
+declare function runPeerProfileReasoner(options: PeerProfileReasonerOptions): Promise<PeerProfileReasonerResult>;
+
+/**
+ * Identity-anchor → peer-registry migration — issue #679 PR 5/5.
+ *
+ * Reads the legacy `identity/identity-anchor.md` file (written by
+ * `StorageManager.writeIdentityAnchor`) and the `IDENTITY.md`
+ * reflections file, then seeds the peer registry with a `self` peer
+ * whose `peers/self/identity.md` kernel captures the relevant
+ * source material.
+ *
+ * Design principles:
+ *
+ * 1. **Idempotent** — if `peers/self/identity.md` already exists this
+ *    function returns `{ skipped: true }` without overwriting it. The
+ *    second-run guarantee prevents accidental double-migration and
+ *    makes `remnic peer migrate` safe to run in CI / post-install hooks.
+ *
+ * 2. **Non-destructive** — the legacy files are never deleted. The
+ *    operator is responsible for archive / clean-up after verifying the
+ *    migration result. Legacy `engram.identity_anchor_*` MCP tools
+ *    continue to work against the on-disk anchor file.
+ *
+ * 3. **Dry-run** — when `options.dryRun` is `true` the function
+ *    computes the proposed `Peer` record and returns it alongside a
+ *    `{ dryRun: true }` marker, without writing anything to disk.
+ *
+ * 4. **Transparent** — the return value always includes the full
+ *    proposed `Peer` so callers can print what was (or would be) written.
+ *
+ * ## Source data
+ *
+ * The migrator reads two optional legacy sources:
+ *
+ * - `{memoryDir}/identity/identity-anchor.md` — structured sections
+ *   (`## Identity Traits`, `## Communication Preferences`, etc.) written
+ *   by `identityAnchorUpdate`. When present, the full content is
+ *   embedded in `peer.notes` under a clearly labelled subsection.
+ *
+ * - `{memoryDir}/IDENTITY.md` — free-form reflection entries appended
+ *   by the extraction engine. When present it is summarised as
+ *   a second subsection of `peer.notes`.
+ *
+ * If neither file exists the `self` peer is still created with sensible
+ * defaults so that the peer registry is bootstrapped for fresh installs.
+ *
+ * ## Path safety
+ *
+ * All file reads use `path.join` relative to the caller-supplied
+ * `memoryDir`. The migration never follows symlinks for the source files
+ * (uses `lstat` to detect + skip them). Writes go through the standard
+ * `writePeer` helper which enforces all path-traversal and symlink guards.
+ */
+
+/** Options for `migrateFromIdentityAnchor`. */
+interface MigrateFromIdentityAnchorOptions {
+    /**
+     * Memory directory (same value as `config.memoryDir`). All source and
+     * destination paths are resolved relative to this root.
+     */
+    memoryDir: string;
+    /**
+     * When `true`, compute and return the proposed peer record without
+     * writing anything to disk. The `written` and `skipped` flags in the
+     * result will both be `false`; the `peer` field carries the proposed
+     * record.
+     */
+    dryRun?: boolean;
+    /**
+     * Optional override for the `self` peer's display name. Defaults to
+     * `"Self"`.
+     */
+    displayName?: string;
+    /**
+     * Optional ISO-8601 timestamp to use as `createdAt`. When omitted the
+     * current time is used.
+     */
+    createdAt?: string;
+}
+/** Result returned by `migrateFromIdentityAnchor`. */
+interface MigrateFromIdentityAnchorResult {
+    /**
+     * The peer record that was (or would be) written for `peers/self/`.
+     * Always present regardless of `skipped` or `dryRun`.
+     */
+    peer: Peer;
+    /**
+     * `true` when the migration wrote `peers/self/identity.md` to disk.
+     * `false` when `dryRun` is set or the file already existed (`skipped`).
+     */
+    written: boolean;
+    /**
+     * `true` when an existing `peers/self/identity.md` was detected and
+     * the migration was a no-op. When `skipped` is `true`, `written` is
+     * always `false`.
+     */
+    skipped: boolean;
+    /**
+     * `true` when `options.dryRun` was set. No files were written; the
+     * `peer` field holds the proposed record.
+     */
+    dryRun: boolean;
+    /**
+     * The identity-anchor source file path that was read (if found).
+     * `null` when the file did not exist or was a symlink (skipped).
+     */
+    identityAnchorSource: string | null;
+    /**
+     * The `IDENTITY.md` source file path that was read (if found).
+     * `null` when the file did not exist or was a symlink (skipped).
+     */
+    identityMdSource: string | null;
+}
+/**
+ * Migrate legacy identity-anchor data into `peers/self/identity.md`.
+ *
+ * @see {@link MigrateFromIdentityAnchorOptions} for full option documentation.
+ * @see {@link MigrateFromIdentityAnchorResult} for return value semantics.
+ */
+declare function migrateFromIdentityAnchor(options: MigrateFromIdentityAnchorOptions): Promise<MigrateFromIdentityAnchorResult>;
+
+export { type MigrateFromIdentityAnchorOptions, type MigrateFromIdentityAnchorResult, Peer, PeerInteractionLogEntry, PeerProfile, type PeerProfileReasonerLlm, type PeerProfileReasonerOptions, type PeerProfileReasonerPeerResult, type PeerProfileReasonerProposal, type PeerProfileReasonerResult, buildPeerProfileReasonerPrompt, migrateFromIdentityAnchor, parsePeerProfileReasonerResponse, runPeerProfileReasoner };

package/dist/{peers-HCVGHMAE.js → peers/index.js}

@@ -2,7 +2,7 @@ import {
   buildPeerProfileReasonerPrompt,
   parsePeerProfileReasonerResponse,
   runPeerProfileReasoner
-} from "./chunk-SKE7JYKA.js";
+} from "../chunk-SFXKHM7P.js";
 import {
   PEERS_DIR_NAME,
   PEER_ID_MAX_LENGTH,
@@ -19,8 +19,8 @@ import {
   readPeerProfile,
   writePeer,
   writePeerProfile
-} from "./chunk-4DWOBS2A.js";
-import "./chunk-PZ5AY32C.js";
+} from "../chunk-PRQJ5ESM.js";
+import "../chunk-PZ5AY32C.js";
 export {
   PEERS_DIR_NAME,
   PEER_ID_MAX_LENGTH,
@@ -41,4 +41,4 @@ export {
   writePeer,
   writePeerProfile
 };
-//# sourceMappingURL=peers-HCVGHMAE.js.map
+//# sourceMappingURL=index.js.map