@remnic/core 9.65.0 → 9.65.2

package/src/procedural/procedure-stats.ts

@@ -12,6 +12,8 @@
  */
 import type { MemoryFile, MemoryStatus, PluginConfig } from "../types.js";
 import type { StorageManager } from "../storage.js";
+import { isActiveMemoryStatus } from "../memory-lifecycle-ledger-utils.js";
+import { readProcedureMaintenanceMarker } from "./library-maintenance.js";
 
 export interface ProcedureStatusCounts {
   total: number;
@@ -50,6 +52,10 @@ export interface ProcedureStatsReport {
   counts: ProcedureStatusCounts;
   recent: ProcedureStatsRecent;
   config: ProcedureStatsConfigSnapshot;
+  /** ISO timestamp of the last library-maintenance run marker, or null (issue #2370). */
+  lastMaintenanceAt: string | null;
+  /** Active procedures currently carrying a `needsRepair` flag (issue #2370). */
+  needsRepairFlags: number;
 }
 
 function snapshotConfig(config: PluginConfig): ProcedureStatsConfigSnapshot {
@@ -102,6 +108,7 @@ export async function computeProcedureStats(options: {
   let lastWriteMs: number | null = null;
   let writesLast7Days = 0;
   let minerSourced = 0;
+  let needsRepairFlags = 0;
 
   const known: MemoryStatus[] = [
     "active",
@@ -159,8 +166,15 @@ export async function computeProcedureStats(options: {
     if (m.frontmatter.source === "procedure-miner") {
       minerSourced += 1;
     }
+    if (
+      m.frontmatter.structuredAttributes?.needsRepair !== undefined &&
+      isActiveMemoryStatus(m.frontmatter.status)
+    ) {
+      needsRepairFlags += 1;
+    }
   }
 
+  const maintenanceMarker = await readProcedureMaintenanceMarker(storage.dir);
   return {
     schemaVersion: 1,
     generatedAt: new Date(nowMs).toISOString(),
@@ -171,6 +185,8 @@ export async function computeProcedureStats(options: {
       minerSourced,
     },
     config: snapshotConfig(config),
+    lastMaintenanceAt: maintenanceMarker?.lastRunAt ?? null,
+    needsRepairFlags,
   };
 }
 
@@ -210,5 +226,9 @@ export function formatProcedureStatsText(report: ProcedureStatsReport): string {
   lines.push(`    lastWriteAt:      ${recent.lastWriteAt ?? "(none)"}`);
   lines.push(`    writesLast7Days:  ${recent.writesLast7Days}`);
   lines.push(`    minerSourced:     ${recent.minerSourced}`);
+  lines.push("");
+  lines.push(`  maintenance:`);
+  lines.push(`    lastMaintenanceAt: ${report.lastMaintenanceAt ?? "(never)"}`);
+  lines.push(`    needsRepairFlags:  ${report.needsRepairFlags}`);
   return lines.join("\n") + "\n";
 }

package/src/schemas.ts

@@ -103,6 +103,13 @@ export const ExtractedFactSchema = z.object({
     .describe(
       'Scope classification: "global" for cross-project knowledge (framework bugs, library behavior, API patterns, user preferences, general coding patterns); "project" for project-specific knowledge (file paths, env configs, deployment details, project workarounds) and for tool, command, or CLI-flag instructions tied to one agent, since the same tool name can mean different things across agents. When keeping such an agent-tied instruction, begin the fact with a leading "In <agent>," clause naming that agent. Defaults to "project" when a coding context is active.',
     ),
+  subject: z
+    .enum(["user", "agent"])
+    .optional()
+    .nullable()
+    .describe(
+      'Memory subject: "user" when the fact models the person (preferences, relationships, biography, moments, commitments about their life); "agent" when it is reusable operating knowledge (procedures, principles, tool-usage lessons, debugging strategies, environment facts with no personal content). Emit only for fact/decision-like facts; the category defaults cover preference, relationship, moment, commitment, procedure, principle, and skill.',
+    ),
   quote: z
     .string()
     .optional()

package/src/search/port.ts

@@ -27,7 +27,8 @@ export interface SearchDegradation {
     | "daemon_loading"
     | "subprocess_error"
     | "deadline_exceeded"
-    | "remote_error";
+    | "remote_error"
+    | "vector_tier_unavailable";
   detail?: string;
 }
 

package/src/spaces/index.ts

@@ -8,6 +8,8 @@
  * through push/pull and promotion workflows.
  */
 
+import { evaluateSubjectGuard } from "../memory-subject.js";
+import type { SubjectGuardMode } from "../types.js";
 import { spawnSync } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
@@ -99,6 +101,8 @@ export interface SpacePromoteResult {
   memoriesPromoted: number;
   conflicts: ConflictEntry[];
   durationMs: number;
+  /** Subject-guard warnings (issue #2372): user-subject memories promoted to a shared team space under "warn". */
+  subjectWarnings?: string[];
 }
 
 export interface ConflictEntry {
@@ -748,7 +752,10 @@ export function shareSpace(spaceId: string, members: string[], baseDir?: string)
 export async function promoteSpace(
   sourceSpaceId: string,
   targetSpaceId: string,
-  options?: { memoryIds?: string[]; force?: boolean; forceOverwrite?: boolean; baseDir?: string }
+  options?: {
+    memoryIds?: string[]; force?: boolean; forceOverwrite?: boolean; baseDir?: string;
+    subjectGuard?: SubjectGuardMode; allowUserSubject?: boolean;
+  }
 ): Promise<SpacePromoteResult> {
   const startTime = Date.now();
   const manifest = loadManifest(options?.baseDir);
@@ -766,6 +773,33 @@ export async function promoteSpace(
     }
   }
 
+  // Subject guard (issue #2372): the SAME gate as the scope-profile promotion
+  // path — a user-subject (or unstamped, fail-closed) memory promoted into a
+  // TEAM space warns/rejects with the override named; recorded in the audit trail.
+  const subjectWarnings: string[] = [];
+  const warnedMemoryIds: string[] = [];
+  if (target.kind === "team") {
+    const sourceFiles = fs.existsSync(source.memoryDir) ? walkMd(fs.realpathSync(source.memoryDir)) : [];
+    for (const file of sourceFiles) {
+      const fm = parseSimpleFrontmatter(fs.readFileSync(file, "utf8"));
+      if (!fm?.id) continue;
+      if (options?.memoryIds?.length && !options.memoryIds.includes(fm.id)) continue;
+      const decision = evaluateSubjectGuard({
+        subject: fm.subject === "user" || fm.subject === "agent" ? fm.subject : undefined,
+        sharedTarget: true,
+        mode: options?.subjectGuard ?? "warn",
+        allowUserSubject: options?.allowUserSubject,
+      });
+      if (decision.action === "reject") {
+        throw new Error(`space promote blocked by subject guard: memory ${fm.id} — ${decision.reason}`);
+      }
+      if (decision.action === "warn") {
+        subjectWarnings.push(`memory ${fm.id}: ${decision.reason}`);
+        warnedMemoryIds.push(fm.id);
+      }
+    }
+  }
+
   const result = await copyMemories(source.memoryDir, target.memoryDir, {
     filterIds: options?.memoryIds,
     force: options?.forceOverwrite !== undefined ? options.forceOverwrite : (options?.force ?? false),
@@ -776,7 +810,8 @@ export async function promoteSpace(
       action: "space.promote",
       sourceSpaceId,
       targetSpaceId,
-      details: `Promoted ${result.merged} memories from "${source.name}" to "${target.name}"`,
+      details: `Promoted ${result.merged} memories from "${source.name}" to "${target.name}"${subjectWarnings.length > 0 ? `; subject-guard warned ${subjectWarnings.length} user-subject memories (${warnedMemoryIds.join(", ")})` : ""}${options?.allowUserSubject === true ? "; user-subject override: --allow-user-subject" : ""}`,
+      ...(warnedMemoryIds.length > 0 ? { memoryIds: warnedMemoryIds } : {}),
     },
     options?.baseDir
   );
@@ -787,6 +822,7 @@ export async function promoteSpace(
     memoriesPromoted: result.merged,
     conflicts: result.conflicts,
     durationMs: Date.now() - startTime,
+    ...(subjectWarnings.length > 0 ? { subjectWarnings } : {}),
   };
 }
 

package/src/storage.ts

@@ -166,6 +166,7 @@ import type {
   VerificationState,
   PolicyClass,
   MemoryStatus,
+  MemorySubject,
   MemoryActionEvent,
   MemoryLifecycleEvent,
   MemoryLifecycleEventType,
@@ -244,6 +245,7 @@ import { normalizeProjectionPreview, normalizeProjectionTags } from "./memory-pr
 import { isSupportPassportPrivateMemory } from "./support-passport/card-projection.js";
 import { parseFlexibleIsoTimestamp } from "./utils/iso-timestamp.js";
 import { parseOriginClass } from "./security/origin-authority.js";
+import { detectLanguageHint } from "./cross-lingual-recall.js";
 import {
   composeMemoryEnvelope,
   isSealedMemoryEnvelope,
@@ -322,8 +324,10 @@ function serializeFrontmatter(fm: MemoryFrontmatter): string {
     `tags: [${fm.tags.map((t) => `"${t}"`).join(", ")}]`,
   ];
   // OKF v0.1 interop (issue #1946): inert presentation metadata; `category` stays canonical.
+  if (fm.language) lines.push(`language: ${fm.language}`);
   if (fm.type !== undefined) lines.push(`type: ${fm.type}`);
   if (fm.origin) lines.push(`origin: ${/^[A-Za-z0-9:_.*-]+$/.test(fm.origin) ? fm.origin : JSON.stringify(fm.origin)}`);
+  if (fm.subject) lines.push(`subject: ${fm.subject}`);
   if (fm.entityRef) lines.push(`entityRef: ${fm.entityRef}`);
   if (fm.sourceConnector) {
     // YAML-injection guard (review thread QMPsP): emit unquoted for
@@ -859,8 +863,9 @@ export function parseFrontmatter(raw: string): { frontmatter: MemoryFrontmatter;
     frontmatter: {
       id: fm.id ?? "",
       category: (fm.category ?? "fact") as MemoryCategory,
-      type: parseFrontmatterStringValue(fm.type),
       created: fm.created ?? new Date().toISOString(),
+      language: fm.language || undefined,
+      type: parseFrontmatterStringValue(fm.type),
       updated: fm.updated ?? new Date().toISOString(),
       source: fm.source ?? "unknown",
       confidence: conf,
@@ -868,6 +873,7 @@ export function parseFrontmatter(raw: string): { frontmatter: MemoryFrontmatter;
       tags,
       entityRef: fm.entityRef || undefined,
       origin: fm.origin !== undefined ? parseOriginClass(decodeYamlScalar(fm.origin)) : undefined,
+      subject: fm.subject === "user" || fm.subject === "agent" ? fm.subject : undefined,
       sourceConnector: fm.sourceConnector ? decodeYamlScalar(fm.sourceConnector) || undefined : undefined,
       toolScoped: fm.toolScoped === "true" ? true : undefined,
       supersedes: fm.supersedes || undefined,
@@ -1736,6 +1742,7 @@ export interface WriteMemoryOptions {
   origin?: string;
   sourceConnector?: string;
   toolScoped?: true;
+  subject?: MemorySubject;
 }
 
 /**
@@ -1744,7 +1751,7 @@ export interface WriteMemoryOptions {
  */
 export type SealedWriteExtras = Omit<
   WriteMemoryOptions,
-  "confidence" | "tags" | "entityRef" | "source" | "expiresAt" | "validAt" | "structuredAttributes" | "sourceConnector" | "origin"
+  "confidence" | "tags" | "entityRef" | "source" | "expiresAt" | "validAt" | "structuredAttributes" | "sourceConnector" | "origin" | "subject"
 >;
 
 export class StorageManager extends TombstoneBlockedCaptureIndexHost {
@@ -3729,6 +3736,7 @@ export class StorageManager extends TombstoneBlockedCaptureIndexHost {
       category,
       created: now.toISOString(),
       updated: now.toISOString(),
+      language: detectLanguageHint(content),
       source: options.source ?? "extraction",
       confidence: conf,
       confidenceTier: tier,
@@ -3787,7 +3795,7 @@ export class StorageManager extends TombstoneBlockedCaptureIndexHost {
       fm.sourceConnector = options.sourceConnector;
     }
     if (options.origin !== undefined) fm.origin = parseOriginClass(options.origin);
-
+    if (options.subject !== undefined) fm.subject = options.subject;
     // Assemble the persisted body (attribute-suffix enrichment + combined
     // sanitize) via the SHARED helper — the sealed-envelope composer uses the
     // same one, so the two write paths cannot diverge (issue #1989 PR2).

package/src/subject-config.ts

@@ -0,0 +1,80 @@
+/**
+ * Config parsing for the memory-subject runtime knobs (issue #2372).
+ *
+ * Extracted from config.ts (its structural-ratchet ceiling forbids growth);
+ * `parseConfig` spreads `parseSubjectRuntimeConfig(cfg)` into the plugin
+ * config literal.
+ *
+ * Validation posture (Review Prevention Checklist §1/§24/§39): invalid
+ * values are REJECTED loudly, never silently reinterpreted — but an omitted
+ * key takes the documented default. The deliberate asymmetry from the issue
+ * stands: classification defaults OFF while the guard defaults "warn", so
+ * enabling classification later immediately yields promotion warnings
+ * without a second flag flip, and with classification off, unstamped
+ * memories still only warn (never silently promote) at shared targets.
+ */
+
+import { coerceBool, coerceNumber } from "./connectors/coerce.js";
+import {
+  isSubjectGuardMode,
+  PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS,
+} from "./memory-subject.js";
+import type { SubjectGuardMode } from "./types.js";
+
+export interface SubjectRuntimeConfig {
+  subjectClassification: { enabled: boolean };
+  subjectGuard: SubjectGuardMode;
+  promotionCandidates: { minAccessCount: number };
+}
+
+/**
+ * Reject a non-object block loudly (rule 51 / §1): a shorthand like
+ * `subjectClassification: false` must never normalize silently to `{}`.
+ * Returns void so callers read the block through a DIRECT `cfg.<key>`
+ * member access — the config-contract parser walker derives nested key
+ * paths from those accesses, and a helper return value hides them.
+ */
+function assertObjectBlock(value: unknown, key: string, shape: string): void {
+  if (value === undefined) return;
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error(
+      `${key} must be an object (got ${JSON.stringify(value)}). Use ${shape} (issue #2372).`,
+    );
+  }
+}
+
+export function parseSubjectRuntimeConfig(cfg: Record<string, unknown>): SubjectRuntimeConfig {
+  assertObjectBlock(cfg.subjectClassification, "subjectClassification", "subjectClassification: { enabled: true }");
+  const classification = (cfg.subjectClassification ?? {}) as Record<string, unknown>;
+  const rawEnabled = classification.enabled;
+  const enabledCoerced = coerceBool(rawEnabled);
+  if (rawEnabled !== undefined && enabledCoerced === undefined) {
+    throw new Error(
+      `subjectClassification.enabled must be a boolean or one of "true"/"false"/"1"/"0"/` +
+        `"yes"/"no"/"on"/"off" (got ${JSON.stringify(rawEnabled)}) — rejected, not defaulted (issue #2372).`,
+    );
+  }
+  const rawGuard = cfg.subjectGuard;
+  if (rawGuard !== undefined && !isSubjectGuardMode(rawGuard)) {
+    throw new Error(
+      `subjectGuard must be one of: off, warn, enforce (got ${JSON.stringify(rawGuard)}) — ` +
+        `rejected, not defaulted (issue #2372; checklist §1/§39).`,
+    );
+  }
+  assertObjectBlock(cfg.promotionCandidates, "promotionCandidates", "promotionCandidates: { minAccessCount: 3 }");
+  const candidates = (cfg.promotionCandidates ?? {}) as Record<string, unknown>;
+  const minAccessRaw = coerceNumber(candidates.minAccessCount);
+  if (candidates.minAccessCount !== undefined && (minAccessRaw === undefined || !Number.isFinite(minAccessRaw) || minAccessRaw < 0)) {
+    throw new Error(
+      `promotionCandidates.minAccessCount must be a non-negative number (got ${JSON.stringify(candidates.minAccessCount)}) — rejected, not defaulted (issue #2372).`,
+    );
+  }
+  return {
+    subjectClassification: { enabled: rawEnabled === undefined ? false : enabledCoerced === true },
+    subjectGuard: isSubjectGuardMode(rawGuard) ? rawGuard : "warn",
+    promotionCandidates: {
+      minAccessCount:
+        minAccessRaw !== undefined ? Math.floor(minAccessRaw) : PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS,
+    },
+  };
+}

package/src/types.ts

@@ -11,8 +11,11 @@ import type { ContradictionLocalizationConfig, ContradictionScanConfig } from ".
 import type { GraphPathScoringConfig } from "./graph-path-scoring-config.js";
 export type { ContradictionLocalizationConfig, ContradictionScanConfig } from "./contradiction-config.js";
 export type { GraphPathScoringConfig } from "./graph-path-scoring-config.js";
+import type { ProceduralMaintenanceConfig } from "./procedural/maintenance-config.js";
 
 import type { AmbientCaptureProvenance, BufferTurnOwner, SecurityConfig, OriginMetadata } from "./security/types.js";
+export type MemorySubject = "user" | "agent";
+export type SubjectGuardMode = "off" | "warn" | "enforce";
 export type ReasoningEffort = "none" | "low" | "medium" | "high";
 export type TriggerMode = "smart" | "every_n" | "time_based";
 export type ConvergeConflictPolicy = "newest-wins" | "manual";
@@ -383,7 +386,6 @@ export interface DreamsPhasesConfig {
   deepSleep: DreamsDeepSleepConfig;
 }
 
-/** Procedural memory (issue #519): mining + recall gates. All sub-features default off. */
 export interface ProceduralConfig {
   enabled: boolean;
   /** Minimum cluster size before emitting a candidate; `0` disables mining (`minOccurrences_zero`). */
@@ -396,8 +398,8 @@ export interface ProceduralConfig {
   lookbackDays: number;
   /** When true, installer may register the nightly procedural mining cron (default off). */
   proceduralMiningCronAutoRegister: boolean;
-  /** Max procedure memories to inject on task-initiation recall (1–10). */
   recallMaxProcedures: number;
+  maintenance: ProceduralMaintenanceConfig;
 }
 
 /**
@@ -1041,14 +1043,11 @@ export interface PluginConfig extends BoundedJsonlStateConfig, SecurityConfig {
   recallMaxConcurrentPerPrincipal: number;
   /** Coalesce identical concurrent recalls per principal; each caller gets its own clone. Default true. */
   recallSingleFlightEnabled: boolean;
-  // Memory Worth recall filter (issue #560 PR 4)
   /**
-   * When true, recall multiplies candidate scores by the Memory Worth
-   * factor computed from `mw_success` / `mw_fail` counters on each
-   * memory's frontmatter (see `computeMemoryWorth`). Memories with a
-   * history of failed sessions sink; neutral / uninstrumented memories
-   * are untouched (multiplier 1.0). Default false — flip to true in PR 5
-   * once the benchmark shows precision tie-or-win.
+   * When true, recall multiplies candidate scores by the Memory Worth factor
+   * from `mw_success` / `mw_fail` (see `computeMemoryWorth`): failed memories
+   * sink; neutral ones untouched (multiplier 1.0). Default false until the
+   * benchmark shows precision tie-or-win.
    */
   recallMemoryWorthFilterEnabled: boolean;
   /**
@@ -1265,6 +1264,10 @@ export interface PluginConfig extends BoundedJsonlStateConfig, SecurityConfig {
   codexCompat: CodexCompatConfig;
   /** When true (default), LLM classifies facts as `"project"` or `"global"` scope for promotion across projects. */
   extractionScopeClassificationEnabled: boolean;
+  subjectClassification: { enabled: boolean };
+  subjectGuard: SubjectGuardMode;
+  /** Min accessCount reuse signal for promotion candidates (issue #2372). Default 3. */
+  promotionCandidates: { minAccessCount: number };
   // Extraction judge (issue #376)
   /** Enable the LLM-as-judge fact-worthiness gate on extracted facts. Default false (opt-in). */
   extractionJudgeEnabled: boolean;
@@ -2804,9 +2807,13 @@ export interface MemoryFrontmatter extends SourceConnectorProvenance, OriginMeta
   /** True when write-time classification ties this memory to its source connector's tools or commands. */
   toolScoped?: true;
   id: string;
+  /** Whom this memory models (issue #2372). The promotion guard treats absent as "user" (fail closed). */
+  subject?: MemorySubject;
   category: MemoryCategory;
   /** OKF v0.1 interop metadata (issue #1946). Inert: presentation only, never overrides `category`. */
   type?: string;
+  /** Dominant-script hint (ISO 15924, e.g. `latn`/`jpan`) for cross-lingual recall (#2197). Absent on legacy files. */
+  language?: string;
   created: string;
   updated: string;
   source: string;
@@ -2822,12 +2829,8 @@ export interface MemoryFrontmatter extends SourceConnectorProvenance, OriginMeta
   /** Memory status: active (default), pending_review, rejected, quarantined, superseded, archived, or forgotten */
   status?: MemoryStatus;
   /**
-   * Tombstone block marker (issue #1579). When a new fact matches an active
-   * tombstone at the storage chokepoint, it is persisted with
-   * `status: "pending_review"` and this field set to the tombstone id — making
-   * the block VISIBLE (rule 34: never a silent drop) rather than silently
-   * discarding the extraction. Approving the memory through the review queue
-   * emits a revocation that re-allows the content.
+   * Tombstone block marker (issue #1579): persisted `pending_review` with this
+   * set to the tombstone id — a VISIBLE block (rule 34); approval revokes it.
    */
   blockedBy?: string;
   /** Which tombstone tier matched (`exact`/`normalized`/`keyed`/`semantic`). */
@@ -3232,29 +3235,25 @@ export interface ExtractedFact {
    */
   provenance?: "verified" | "unverified" | "none";
   /**
-   * Transient LLM-provided supporting quote (issue #1575 PR 2). Consumed by
-   * the post-parse validator to build `sources`, then stripped before the
-   * fact reaches persistence. NEVER included in content-hash dedup (rule 23 /
-   * checklist §13). Absent on facts that have already passed the validator.
+   * Transient LLM quote (issue #1575 PR 2): consumed by the post-parse
+   * validator to build `sources`, stripped before persistence, never in
+   * content-hash dedup (rule 23 / checklist §13).
    */
   quote?: string;
   /**
-   * Transient requireSpans signal (issue #1575 PR 2). Set by the provenance
-   * validator (`ProvenanceBuildResult.requireSpansPending`) when
-   * `provenance.requireSpans` is enabled and the quote could not be located
-   * in any source turn. Read by the persist path to route the fact to
-   * `pending_review` instead of `active`. Stripped before persistence —
-   * it never reaches frontmatter (chatgpt-codex-connector thread 4xB).
+   * Transient requireSpans signal (#1575 PR 2): quote unlocatable while
+   * `provenance.requireSpans` is on. Persist path routes the fact to
+   * `pending_review`. Stripped before persistence — never reaches frontmatter.
    */
   requireSpansPending?: boolean;
   promptedByQuestion?: string;
   /**
-   * Whether this fact is project-scoped or globally applicable.
-   * When `extractionScopeClassificationEnabled` is true, the extraction LLM
-   * classifies each fact. Default is `"project"` when a coding context is
-   * active, `"global"` when no coding context is present.
+   * Project- vs global-scoped; emitted when `extractionScopeClassificationEnabled`.
+   * Defaults to "project" with a coding context active, else "global".
    */
   scope?: MemoryScope;
+  /** Extractor-assigned subject, present only when subjectClassification.enabled (issue #2372). */
+  subject?: MemorySubject;
   /** Structured key-value attributes extracted from the content (e.g., product attributes, dates, quantities). */
   structuredAttributes?: Record<string, string>;
   /** When category is `procedure`, ordered steps with intents (persisted under procedures/). */

package/src/write-envelope.test.ts

@@ -9,6 +9,7 @@ import {
   WRITE_FINGERPRINT_FIELDS,
   buildWriteIdempotencyPayload,
   composeMemoryEnvelope,
+  sealedWriteToLegacyArgs,
   isSealedMemoryEnvelope,
   type FingerprintScope,
   type MemoryWriteInput,
@@ -198,6 +199,7 @@ test("registry and exempt list disjointly cover every MemoryWriteInput field", (
     sourceConnector: "bee",
     sourceReason: "r",
     origin: "user",
+    subject: "user",
   };
   for (const key of Object.keys(populated)) {
     assert.ok(classified.has(key), `field ${key} is not classified`);
@@ -682,3 +684,15 @@ test("structural fallback rejects prototype-inherited accessors (round 13)", ()
     "prototype-inherited getter lookalike must be rejected",
   );
 });
+
+test("sealedWriteToLegacyArgs always copies sourceConnector from the envelope", () => {
+  const envelope = composeMemoryEnvelope(
+    minimalInput({ sourceConnector: "chatgpt" }),
+    CTX,
+  );
+  const mapped = sealedWriteToLegacyArgs(envelope, { sourceConnector: "smuggled" });
+  assert.equal(mapped.options.sourceConnector, "chatgpt");
+  const empty = composeMemoryEnvelope(minimalInput(), CTX);
+  const cleared = sealedWriteToLegacyArgs(empty, { sourceConnector: "smuggled" });
+  assert.equal(cleared.options.sourceConnector, undefined);
+});

package/src/write-envelope.ts

@@ -24,7 +24,8 @@
  * the write call sites onto this module (see #1989 for the slicing).
  */
 
-import type { MemoryCategory } from "./types.js";
+import { isMemorySubject } from "./memory-subject.js";
+import type { MemoryCategory, MemorySubject } from "./types.js";
 import { normalizeTags } from "./recall-tag-filter.js";
 import { parseFlexibleIsoTimestamp } from "./utils/iso-timestamp.js";
 import { assemblePersistedBody } from "./structured-attributes.js";
@@ -61,6 +62,8 @@ export interface MemoryWriteInput {
   sourceConnector?: string;
   /** Origin class stamped at creation time (issue #1955). */
   origin?: string;
+  /** Whom the memory models (issue #2372): "user" or "agent". */
+  subject?: MemorySubject;
   /** Human-readable provenance note. */
   sourceReason?: string;
 }
@@ -184,6 +187,7 @@ export interface SealedMemoryEnvelope {
   readonly validAt: string | undefined;
   readonly sourceConnector: string | undefined;
   readonly origin: string | undefined;
+  readonly subject: MemorySubject | undefined;
   readonly sourceReason: string | undefined;
   readonly source: string;
   /** ISO timestamp the envelope was composed (from ctx.now). */
@@ -430,6 +434,18 @@ export function composeMemoryEnvelope(
     }
   }
 
+  let subject: MemorySubject | undefined;
+  if (input.subject !== undefined) {
+    if (!isMemorySubject(input.subject)) {
+      hygiene.flag(
+        "subject",
+        `must be "user" or "agent" (got ${JSON.stringify(input.subject)}) — dropped`,
+      );
+    } else {
+      subject = input.subject;
+    }
+  }
+
   // validAt stays FATAL in salvage too: legacy writeMemory throws on an
   // invalid validAt (normalizeMemoryWriteTimestamp), so salvage-dropping it
   // would CHANGE behavior rather than preserve it.
@@ -465,11 +481,12 @@ export function composeMemoryEnvelope(
     structuredAttributes: attributes?.canonical,
     rawStructuredAttributes: attributes?.raw,
     entityRef: normalizeOptionalString("entityRef", input.entityRef, hygiene),
+    origin: normalizeOptionalString("origin", input.origin, hygiene),
+    subject,
     confidence,
     ttl: normalizeOptionalString("ttl", input.ttl, hygiene),
     validAt,
     sourceConnector: normalizeOptionalString("sourceConnector", input.sourceConnector, hygiene),
-    origin: normalizeOptionalString("origin", input.origin, hygiene),
     sourceReason: normalizeOptionalString("sourceReason", input.sourceReason, hygiene),
     source: ctx.source.trim(),
     composedAt: now.toISOString(),
@@ -656,8 +673,9 @@ export function sealedWriteToLegacyArgs(
       // extras — a conditional spread let extras.sourceConnector smuggle
       // unvalidated connector provenance past the sealed envelope when the
       // envelope had none.
-      sourceConnector: envelope.sourceConnector,
       origin: envelope.origin,
+      sourceConnector: envelope.sourceConnector,
+      subject: envelope.subject,
     },
   };
 }
@@ -695,6 +713,9 @@ export const FINGERPRINT_EXEMPT_FIELDS = [
   // Free-text provenance note; carries no identity.
   // Origin is provenance metadata, not write identity (#1955).
   "origin",
+  // Subject is derived classification metadata (#2372): two writes identical
+  // except subject are the same memory for dedup purposes.
+  "subject",
   "sourceReason",
 ] as const satisfies readonly (keyof MemoryWriteInput)[];
 

package/dist/chunk-4NZHHGVL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/schemas.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const MemoryActionTypeSchema = z.enum([\n  \"store_episode\",\n  \"store_note\",\n  \"update_note\",\n  \"create_artifact\",\n  \"summarize_node\",\n  \"discard\",\n  \"link_graph\",\n]);\n\nexport const MemoryActionEligibilityContextSchema = z\n  .object({\n    confidence: z.number().min(0).max(1),\n    lifecycleState: z.enum([\"active\", \"validated\", \"candidate\", \"stale\", \"archived\"]),\n    importance: z.number().min(0).max(1),\n    source: z.enum([\"extraction\", \"consolidation\", \"replay\", \"manual\", \"unknown\"]),\n  })\n  .strict();\n\nexport function parseMemoryActionType(value: unknown): z.infer<typeof MemoryActionTypeSchema> {\n  const parsed = MemoryActionTypeSchema.safeParse(value);\n  return parsed.success ? parsed.data : \"discard\";\n}\n\nexport function parseMemoryActionEligibilityContext(\n  value: unknown,\n): z.infer<typeof MemoryActionEligibilityContextSchema> {\n  const parsed = MemoryActionEligibilityContextSchema.safeParse(value);\n  if (parsed.success) return parsed.data;\n  return {\n    confidence: 0,\n    lifecycleState: \"candidate\",\n    importance: 0,\n    source: \"unknown\",\n  };\n}\n\nexport const ProcedureStepExtractSchema = z.object({\n  order: z.number(),\n  intent: z.string(),\n  toolCall: z\n    .object({\n      kind: z.string(),\n      signature: z.string(),\n    })\n    .optional()\n    .nullable(),\n  expectedOutcome: z.string().optional().nullable(),\n  optional: z.boolean().optional().nullable(),\n});\n\nexport const ExtractedFactSchema = z.object({\n  category: z.enum([\n    \"fact\",\n    \"preference\",\n    \"correction\",\n    \"entity\",\n    \"decision\",\n    \"relationship\",\n    \"principle\",\n    \"commitment\",\n    \"moment\",\n    \"skill\",\n    \"rule\",\n    \"procedure\",\n    \"reasoning_trace\",\n  ]),\n  content: z\n    .string()\n    .describe(\"The memory content — a clear, standalone statement\"),\n  confidence: z\n    .number()\n    .min(0)\n    .max(1)\n    .describe(\"How confident are you this is correct (0-1)\"),\n  tags: z.array(z.string()).describe(\"Relevant tags for categorization\"),\n  entityRef: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"If about an entity, its normalized name (e.g. person-jane-doe)\"),\n  cueAnchors: z\n    .array(\n      z.object({\n        type: z.enum([\"entity\", \"file\", \"tool\", \"outcome\", \"constraint\", \"date\"]),\n        value: z.string(),\n      }),\n    )\n    .optional()\n    .nullable()\n    .describe(\"Up to three short retrieval cues for this fact.\"),\n  promptedByQuestion: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"Optional proactive follow-up question that surfaced this fact.\"),\n  scope: z\n    .enum([\"project\", \"global\"])\n    .optional()\n    .nullable()\n    .describe(\n      'Scope classification: \"global\" for cross-project knowledge (framework bugs, library behavior, API patterns, user preferences, general coding patterns); \"project\" for project-specific knowledge (file paths, env configs, deployment details, project workarounds) and for tool, command, or CLI-flag instructions tied to one agent, since the same tool name can mean different things across agents. When keeping such an agent-tied instruction, begin the fact with a leading \"In <agent>,\" clause naming that agent. Defaults to \"project\" when a coding context is active.',\n    ),\n  quote: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\n      \"The EXACT verbatim words from the conversation that support this fact. Copy a contiguous span from a single speaker turn (not a paraphrase). Cap at ~300 characters. This is the grounding evidence for downstream faithfulness verification (issue #1575).\",\n    ),\n  structuredAttributes: z\n    .record(z.string(), z.string())\n    .optional()\n    .nullable()\n    .describe(\"Structured key-value attributes when the fact contains measurable or categorical data (e.g., {\\\"price\\\": \\\"29.99\\\", \\\"color\\\": \\\"blue\\\", \\\"date\\\": \\\"2024-03-15\\\"}).\"),\n  procedureSteps: z\n    .array(ProcedureStepExtractSchema)\n    .optional()\n    .nullable()\n    .describe(\n      'For category \"procedure\" only: ordered steps (intent per step). At least two steps; include explicit trigger phrasing in content (e.g. \"When you deploy…\").',\n    ),\n  reasoningTrace: z\n    .object({\n      steps: z\n        .array(\n          z.object({\n            order: z.number(),\n            description: z.string(),\n          }),\n        )\n        // Prompts and normalizer require >=2 ordered steps; enforce it at\n        // the schema layer so gateway-path parsing rejects malformed traces\n        // rather than persisting them (local/direct-client normalization\n        // already enforces this, keeping the two paths symmetric).\n        .min(2)\n        .describe(\"Ordered reasoning steps the user walked through (require >=2).\"),\n      // Accept snake_case aliases so a loose gateway model using\n      // `final_answer` / `observed_outcome` does not fail schema parsing\n      // and drop the entire extraction result. Local/direct-client\n      // normalization already tolerates these keys; the gateway path must\n      // too. Zod's `union` keeps the parse successful either way.\n      finalAnswer: z\n        .string()\n        .optional()\n        .nullable()\n        .describe(\"The conclusion, decision, or answer the chain arrived at.\"),\n      final_answer: z\n        .string()\n        .optional()\n        .nullable()\n        .describe(\"Alias for finalAnswer (snake_case). Gateway-tolerance shim.\"),\n      observedOutcome: z\n        .string()\n        .optional()\n        .nullable()\n        .describe(\"Optional note about how the answer actually played out.\"),\n      observed_outcome: z\n        .string()\n        .optional()\n        .nullable()\n        .describe(\"Alias for observedOutcome (snake_case). Gateway-tolerance shim.\"),\n    })\n    // Either finalAnswer OR final_answer must be present — enforce here so\n    // the rest of the pipeline can assume a usable string downstream.\n    .refine(\n      (v) =>\n        (typeof v.finalAnswer === \"string\" && v.finalAnswer.trim().length > 0) ||\n        (typeof v.final_answer === \"string\" && v.final_answer.trim().length > 0),\n      { message: \"reasoningTrace requires finalAnswer (or final_answer)\" },\n    )\n    .optional()\n    .nullable()\n    .describe(\n      'For category \"reasoning_trace\" only: a stored solution chain with ordered steps, a final answer, and an optional observed outcome. Require at least two steps.',\n    ),\n  eventTime: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\n      'Optional event-time expression for bi-temporal validity (#1578). An ISO date (\"2025-03-01\") or a relative expression verbatim (\"last March\", \"yesterday\", \"since 2024\", \"until 2025-06-01\"). Resolved against the source turn timestamp at write time — NOT wall-clock. Omit when the fact has no explicit temporal anchor.',\n    ),\n  event_time: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"Alias for eventTime (snake_case). Gateway-tolerance shim (#1578).\"),\n}).superRefine((value, ctx) => {\n  if (value.category === \"procedure\" && (!Array.isArray(value.procedureSteps) || value.procedureSteps.length < 2)) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"procedureSteps\"],\n      message: \"procedure facts require at least two procedureSteps\",\n    });\n  }\n\n  if (value.category === \"reasoning_trace\" && value.reasoningTrace == null) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: [\"reasoningTrace\"],\n      message: \"reasoning_trace facts require reasoningTrace\",\n    });\n  }\n});\n\nexport const EntityMentionSchema = z.object({\n  name: z\n    .string()\n    .describe(\"Normalized entity name (e.g. jane-doe, acme-corp, my-project)\"),\n  type: z.enum([\"person\", \"project\", \"tool\", \"company\", \"place\", \"other\"]),\n  facts: z\n    .array(z.string())\n    .describe(\"New facts learned about this entity in this conversation\"),\n  promptedByQuestion: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"Optional proactive follow-up question that surfaced this entity.\"),\n  structuredSections: z\n    .array(z.object({\n      key: z.string(),\n      title: z.string(),\n      facts: z.array(z.string()),\n    }))\n    .optional()\n    .nullable()\n    .describe(\"Optional named sections for entity-specific facts. Use when facts clearly belong under a durable heading such as Beliefs or Building / Working On.\"),\n});\n\nexport const ExtractedQuestionSchema = z.object({\n  question: z.string().describe(\"A genuine question the AI is curious about based on this conversation\"),\n  context: z.string().describe(\"Why this question matters or what prompted it\"),\n  priority: z.number().min(0).max(1).describe(\"How important/urgent this question is (0-1)\"),\n});\n\nexport const ProactiveQuestionsResultSchema = z.object({\n  questions: z\n    .array(ExtractedQuestionSchema)\n    .describe(\"Additional follow-up questions discovered in a proactive second-pass extraction.\"),\n});\n\nexport const ExtractedRelationshipSchema = z.object({\n  source: z.string().describe(\"Source entity name (normalized, e.g. person-jane-doe)\"),\n  target: z.string().describe(\"Target entity name (normalized, e.g. company-acme-corp)\"),\n  label: z.string().describe(\"Relationship label (e.g. 'works at', 'created', 'manages')\"),\n  promptedByQuestion: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"Optional proactive follow-up question that surfaced this relationship.\"),\n});\n\nexport const ProactiveExtractionResultSchema = z.object({\n  facts: z\n    .array(ExtractedFactSchema)\n    .describe(\n      \"Additional high-confidence memories recovered only after answering proactive follow-up questions from the same buffered conversation.\",\n    ),\n  profileUpdates: z\n    .array(z.string())\n    .describe(\n      \"Additional profile updates directly supported by the buffered conversation. Omit anything speculative.\",\n    ),\n  entities: z\n    .array(EntityMentionSchema)\n    .describe(\n      \"Additional entities or entity facts surfaced by the proactive follow-up pass.\",\n    ),\n  relationships: z\n    .array(ExtractedRelationshipSchema)\n    .optional()\n    .nullable()\n    .describe(\n      \"Additional relationships surfaced by the proactive follow-up pass.\",\n    ),\n});\n\n/**\n * Salvage array for model-produced extraction output (issue #2455).\n *\n * Mixed valid+invalid items parse to the valid subset so one malformed\n * element no longer discards the whole extraction. A non-empty array with\n * zero valid items still fails, so bounded retry stays effective and wholly\n * malformed output is never silently accepted as empty. Empty arrays stay\n * valid. Consolidation schemas intentionally stay strict — do not use this\n * for them.\n */\nfunction salvageArray<T extends z.ZodTypeAny>(itemSchema: T) {\n  return z\n    .array(z.unknown())\n    .transform((items, ctx) => {\n      const valid: z.infer<T>[] = [];\n      for (const raw of items) {\n        const parsed = itemSchema.safeParse(raw);\n        if (parsed.success) {\n          valid.push(parsed.data);\n        }\n      }\n      if (items.length > 0 && valid.length === 0) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: \"array contains no items matching the schema\",\n        });\n        return z.NEVER;\n      }\n      return valid;\n    });\n}\n\nexport const ExtractionResultSchema = z.object({\n  facts: salvageArray(ExtractedFactSchema).describe(\n    \"Extracted memories from the conversation. Include facts, preferences, corrections, and decisions. Only extract genuinely new, durable information — skip transient task state.\",\n  ),\n  profileUpdates: salvageArray(z.string()).describe(\n    \"Updates to the user's behavioral profile. Each string is a standalone statement about the user's preferences, habits, or personality. Only include genuinely new insights.\",\n  ),\n  entities: salvageArray(EntityMentionSchema).describe(\n    \"Entities mentioned in the conversation with new facts about them.\",\n  ),\n  questions: salvageArray(ExtractedQuestionSchema).describe(\n    \"Zero to three source-grounded questions useful in future sessions. Return an empty array when the conversation supports none.\",\n  ),\n  identityReflection: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\n      \"A brief reflection on what you learned about yourself as an agent in this interaction — patterns in your behavior, growth, things you did well or could improve.\",\n    ),\n  episodeTitle: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"A six-to-eight word title for this conversation segment.\"),\n  relationships: salvageArray(ExtractedRelationshipSchema)\n    .optional()\n    .nullable()\n    .describe(\n      \"Relationships between entities discovered in this conversation. Max 5 per extraction. Format: {source, target, label}.\",\n    ),\n});\n\nexport const ConsolidationItemSchema = z.object({\n  existingId: z\n    .string()\n    .describe(\"The ID of the existing memory being evaluated\"),\n  action: z.enum([\"ADD\", \"MERGE\", \"UPDATE\", \"INVALIDATE\", \"SKIP\"]),\n  mergeWith: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"If MERGE, the ID of the memory to merge with\"),\n  updatedContent: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"If UPDATE or MERGE, the new content\"),\n  reason: z.string().describe(\"Brief reason for this decision\"),\n});\n\nexport const ConsolidationResultSchema = z.object({\n  items: z\n    .array(ConsolidationItemSchema)\n    .describe(\n      \"Decisions for each existing memory: ADD (keep as-is), MERGE (combine with another), UPDATE (revise content), INVALIDATE (mark as outdated/wrong), SKIP (no action needed)\",\n    ),\n  profileUpdates: z\n    .array(z.string())\n    .describe(\"New profile statements to add or update\"),\n  entityUpdates: z\n    .array(EntityMentionSchema)\n    .describe(\"Entity updates from consolidation analysis\"),\n});\n\nexport function buildProfileConsolidationResultSchema(targetLines: number) {\n  return z.object({\n    consolidatedProfile: z\n      .string()\n      .describe(\n        `The full consolidated profile as markdown. Preserve all ## section headers. Merge duplicate or near-duplicate bullets into single clear statements. Remove stale or superseded information. Keep the most important and durable observations. Target roughly ${targetLines} lines.`,\n      ),\n    removedCount: z\n      .number()\n      .describe(\"Number of bullets removed or merged during consolidation\"),\n    summary: z\n      .string()\n      .describe(\"Brief summary of what was consolidated\"),\n  });\n}\n\nexport const ProfileConsolidationResultSchema = buildProfileConsolidationResultSchema(50);\n\nexport const IdentityConsolidationResultSchema = z.object({\n  learnedPatterns: z\n    .array(z.string())\n    .describe(\n      \"Consolidated behavioral patterns and lessons learned, each a concise standalone statement\",\n    ),\n  summary: z\n    .string()\n    .describe(\n      \"A brief paragraph summarizing the agent's core identity insights\",\n    ),\n});\n\nexport type IdentityConsolidationResultParsed = z.infer<\n  typeof IdentityConsolidationResultSchema\n>;\n\n// Contradiction Verification (Phase 2B)\nexport const ContradictionVerificationSchema = z.object({\n  isContradiction: z\n    .boolean()\n    .describe(\"Whether the two memories truly contradict each other\"),\n  confidence: z\n    .number()\n    .min(0)\n    .max(1)\n    .describe(\"How confident are you in this assessment (0-1)\"),\n  reasoning: z\n    .string()\n    .describe(\"Explanation of why these are or are not contradictory\"),\n  whichIsNewer: z\n    .enum([\"first\", \"second\", \"unclear\"])\n    .describe(\"Which memory represents the more recent/current state\"),\n});\n\nexport type ContradictionVerificationResult = z.infer<\n  typeof ContradictionVerificationSchema\n>;\n\n// Memory Linking (Phase 3A)\nexport const MemoryLinkSchema = z.object({\n  targetId: z\n    .string()\n    .describe(\"The ID of the memory this links to\"),\n  linkType: z\n    .enum([\"follows\", \"references\", \"contradicts\", \"supports\", \"related\"])\n    .describe(\"The type of relationship\"),\n  strength: z\n    .number()\n    .min(0)\n    .max(1)\n    .describe(\"How strong is this relationship (0-1)\"),\n  reason: z\n    .string()\n    .optional()\n    .nullable()\n    .describe(\"Why this link exists\"),\n});\n\nexport const SuggestedLinksSchema = z.object({\n  links: z\n    .array(MemoryLinkSchema)\n    .describe(\"Suggested links between memories based on semantic analysis\"),\n});\n\nexport type MemoryLink = z.infer<typeof MemoryLinkSchema>;\nexport type SuggestedLinks = z.infer<typeof SuggestedLinksSchema>;\n\n// Memory Summarization (Phase 4A)\nexport const MemorySummarySchema = z.object({\n  summaryText: z\n    .string()\n    .describe(\"A concise summary of the batch of memories\"),\n  keyFacts: z\n    .array(z.string())\n    .describe(\"The most important facts extracted from these memories\"),\n  keyEntities: z\n    .array(z.string())\n    .describe(\"Key entities mentioned across these memories\"),\n});\n\nexport type MemorySummaryResult = z.infer<typeof MemorySummarySchema>;\n\nexport const DaySummaryResultSchema = z.object({\n  summary: z.string().min(1).describe(\"A concise end-of-day summary paragraph.\"),\n  bullets: z.array(z.string()).default([]).describe(\"The most important moments from the day.\"),\n  next_actions: z.array(z.string()).default([]).describe(\"Concrete next actions for tomorrow.\"),\n  risks_or_open_loops: z.array(z.string()).default([]).describe(\"Open loops, blockers, or fragile assumptions still needing attention.\"),\n});\n\n// v8.15 behavior-loop auto-tuning state contracts\nexport const BehaviorLoopAdjustmentSchema = z.object({\n  parameter: z.string().min(1),\n  previousValue: z.number(),\n  nextValue: z.number(),\n  delta: z.number(),\n  evidenceCount: z.number().int().min(0),\n  confidence: z.number().min(0).max(1),\n  reason: z.string(),\n  appliedAt: z.string(),\n});\n\nexport const BehaviorLoopPolicyStateSchema = z.object({\n  version: z.number().int().min(0),\n  windowDays: z.number().int().min(0),\n  minSignalCount: z.number().int().min(0),\n  maxDeltaPerCycle: z.number().min(0).max(1),\n  protectedParams: z.array(z.string()),\n  adjustments: z.array(BehaviorLoopAdjustmentSchema),\n  updatedAt: z.string(),\n});\n\nexport type BehaviorLoopAdjustmentParsed = z.infer<typeof BehaviorLoopAdjustmentSchema>;\nexport type BehaviorLoopPolicyStateParsed = z.infer<typeof BehaviorLoopPolicyStateSchema>;\n\nexport type MemoryActionTypeParsed = z.infer<typeof MemoryActionTypeSchema>;\nexport type MemoryActionEligibilityContextParsed = z.infer<typeof MemoryActionEligibilityContextSchema>;\nexport type ExtractedFactParsed = z.infer<typeof ExtractedFactSchema>;\nexport type EntityMentionParsed = z.infer<typeof EntityMentionSchema>;\nexport type ExtractedQuestionParsed = z.infer<typeof ExtractedQuestionSchema>;\nexport type ProactiveQuestionsResultParsed = z.infer<typeof ProactiveQuestionsResultSchema>;\nexport type ExtractionResultParsed = z.infer<typeof ExtractionResultSchema>;\nexport type ConsolidationItemParsed = z.infer<typeof ConsolidationItemSchema>;\nexport type ConsolidationResultParsed = z.infer<\n  typeof ConsolidationResultSchema\n>;\n"],"mappings":"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","names":[]}