@remnic/core 9.65.8 → 9.66.1

package/dist/{chunk-XDL5CYZN.js.map → chunk-EEOUMG3J.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/support-passport/contracts.ts","../src/support-passport/card-projection.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { z } from \"zod\";\n\nimport { normalizeNamespaceIdentity } from \"../namespaces/identity.js\";\nimport { parseIsoOffsetTimestamp } from \"../utils/iso-timestamp.js\";\n\nexport const SUPPORT_PASSPORT_CARD_CATEGORIES = [\n  \"communication\",\n  \"environment\",\n  \"transitions\",\n  \"sensory\",\n  \"regulation\",\n  \"interests\",\n  \"other\",\n] as const;\n\nexport const SUPPORT_PASSPORT_CARD_STATUSES = [\n  \"pending_review\",\n  \"active\",\n  \"rejected\",\n  \"superseded\",\n  \"archived\",\n] as const;\n\nexport const SupportPassportCardCategorySchema = z.enum(SUPPORT_PASSPORT_CARD_CATEGORIES);\nexport const SupportPassportCardStatusSchema = z.enum(SUPPORT_PASSPORT_CARD_STATUSES);\nexport const SupportPassportCardTitleSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .max(80)\n  .refine((title) => !title.includes(\"]\") && !title.includes(\"\\n\") && !title.includes(\"\\r\"), {\n    message: \"card titles cannot contain closing brackets or line breaks\",\n  });\n\nconst IsoTimestampSchema = z\n  .string()\n  .datetime({ offset: true })\n  .refine((value) => parseIsoOffsetTimestamp(value) !== null, {\n    message: \"timestamps must be valid ISO 8601 values\",\n  });\nexport const SupportPassportNamespaceSchema = z\n  .string()\n  .min(1)\n  .refine((namespace) => namespace === normalizeNamespaceIdentity(namespace), {\n    message: \"namespaces must be canonical\",\n  });\nexport const SupportPassportMemoryIdSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .max(128)\n  .regex(/^[A-Za-z0-9._:-]+$/);\nexport const SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH = 512;\nexport const SupportPassportSourceMemoryIdSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .max(SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH);\n\nexport const SupportPassportCardSchema = z\n  .object({\n    cardId: SupportPassportMemoryIdSchema,\n    title: SupportPassportCardTitleSchema,\n    statement: z.string().trim().min(1).max(500),\n    category: SupportPassportCardCategorySchema,\n    status: SupportPassportCardStatusSchema,\n    updatedAt: IsoTimestampSchema,\n    reviewBy: IsoTimestampSchema,\n    revision: z.string().regex(/^[a-f0-9]{64}$/),\n  })\n  .strict();\n\nexport const SupportPassportCardListSchema = z\n  .array(SupportPassportCardSchema)\n  .max(100)\n  .superRefine((cards, ctx) => {\n    const seen = new Set<string>();\n    for (const [index, card] of cards.entries()) {\n      if (seen.has(card.cardId)) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: \"card IDs must be unique\",\n          path: [index, \"cardId\"],\n        });\n      }\n      seen.add(card.cardId);\n    }\n  });\n\nexport const SupportPassportListCardsInputSchema = z\n  .object({\n    principal: z.string().trim().min(1).max(512),\n  })\n  .strict();\n\nexport const SupportPassportManualDraftInputSchema = z\n  .object({\n    principal: z.string().trim().min(1).max(512),\n    title: SupportPassportCardTitleSchema,\n    statement: z.string().trim().min(1).max(500),\n    category: SupportPassportCardCategorySchema,\n    reviewBy: IsoTimestampSchema,\n  })\n  .strict();\n\nexport const SupportPassportCardMutationInputSchema = z\n  .object({\n    principal: z.string().trim().min(1).max(512),\n    cardId: SupportPassportMemoryIdSchema,\n    expectedRevision: z.string().regex(/^[a-f0-9]{64}$/),\n    reasonCode: z\n      .string()\n      .trim()\n      .min(1)\n      .max(64)\n      .regex(/^[a-z0-9-]+$/)\n      .optional(),\n  })\n  .strict();\n\nexport const SupportPassportReplaceCardInputSchema = SupportPassportCardMutationInputSchema.extend({\n  title: SupportPassportCardTitleSchema,\n  statement: z.string().trim().min(1).max(500),\n  category: SupportPassportCardCategorySchema,\n  reviewBy: IsoTimestampSchema,\n}).strict();\n\nexport type SupportPassportCard = z.infer<typeof SupportPassportCardSchema>;\nexport type SupportPassportCardCategory = z.infer<typeof SupportPassportCardCategorySchema>;\nexport type SupportPassportCardStatus = z.infer<typeof SupportPassportCardStatusSchema>;\nexport type SupportPassportManualDraftInput = z.input<typeof SupportPassportManualDraftInputSchema>;\nexport type SupportPassportCardMutationInput = z.input<typeof SupportPassportCardMutationInputSchema>;\nexport type SupportPassportReplaceCardInput = z.input<typeof SupportPassportReplaceCardInputSchema>;\n\ntype RevisionFields = Omit<SupportPassportCard, \"revision\">;\n\nexport function computeSupportPassportCardRevision(fields: RevisionFields): string {\n  const canonicalFields = {\n    cardId: fields.cardId,\n    category: fields.category,\n    reviewBy: fields.reviewBy,\n    statement: fields.statement,\n    status: fields.status,\n    title: fields.title,\n    updatedAt: fields.updatedAt,\n  };\n  return createHash(\"sha256\").update(JSON.stringify(canonicalFields)).digest(\"hex\");\n}\n","import { createHash } from \"node:crypto\";\nimport { lstat } from \"node:fs/promises\";\n\nimport type { OfflineSyncExcludeFile } from \"../offline-sync-file-io.js\";\nimport { stripAttributesSuffix } from \"../structured-attributes.js\";\nimport type { MemoryFile } from \"../types.js\";\nimport {\n  type SupportPassportCard,\n  SupportPassportCardCategorySchema,\n  SupportPassportCardSchema,\n  SupportPassportCardStatusSchema,\n  SupportPassportMemoryIdSchema,\n  SupportPassportNamespaceSchema,\n  SupportPassportSourceMemoryIdSchema,\n  computeSupportPassportCardRevision,\n} from \"./contracts.js\";\n\nexport const SUPPORT_PASSPORT_CARD_TAG = \"support-passport-card\";\nexport const SUPPORT_PASSPORT_AUDIT_TAG = \"support-passport-audit\";\n\nexport function isSupportPassportPrivateMemory(memory: {\n  frontmatter: {\n    tags?: readonly string[];\n    structuredAttributes?: Readonly<Record<string, string>>;\n  };\n}): boolean {\n  const tags = memory.frontmatter.tags;\n  if (tags?.includes(SUPPORT_PASSPORT_CARD_TAG) === true || tags?.includes(SUPPORT_PASSPORT_AUDIT_TAG) === true) {\n    return true;\n  }\n  return Object.keys(memory.frontmatter.structuredAttributes ?? {})\n    .some((key) => key.startsWith(\"support-passport-\"));\n}\n\nexport function excludeSupportPassportPrivateMemories<T extends Pick<MemoryFile, \"frontmatter\">>(\n  memories: readonly T[]\n): T[] {\n  return memories.filter((memory) => !isSupportPassportPrivateMemory(memory));\n}\n\nexport function createSupportPassportPrivateFileExclusion(storage: {\n  readMemoryByPath(filePath: string): Promise<MemoryFile | null>;\n}): OfflineSyncExcludeFile {\n  const classifications = new Map<string, { identity: string; excluded: Promise<boolean> }>();\n  return async ({ filePath }) => {\n    let file: Awaited<ReturnType<typeof lstat>>;\n    try {\n      file = await lstat(filePath);\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n        classifications.delete(filePath);\n        return false;\n      }\n      throw error;\n    }\n    const identity = `${file.dev}:${file.ino}:${file.size}:${file.mtimeMs}:${file.ctimeMs}`;\n    const cached = classifications.get(filePath);\n    if (cached?.identity === identity) return await cached.excluded;\n    const excluded = storage\n      .readMemoryByPath(filePath)\n      .then((memory) => (memory ? isSupportPassportPrivateMemory(memory) : false));\n    classifications.set(filePath, { identity, excluded });\n    try {\n      return await excluded;\n    } catch (error) {\n      if (classifications.get(filePath)?.excluded === excluded) classifications.delete(filePath);\n      throw error;\n    }\n  };\n}\n\nexport const SUPPORT_PASSPORT_ATTRIBUTE_KEYS = Object.freeze({\n  namespace: \"support-passport-namespace\",\n  namespaceEncoding: \"support-passport-namespace-encoding\",\n  owner: \"support-passport-owner\",\n  title: \"support-passport-title\",\n  category: \"support-passport-category\",\n  order: \"support-passport-order\",\n  reviewBy: \"support-passport-review-by\",\n  sourceMemoryIds: \"support-passport-source-ids\",\n  replacesDraftId: \"support-passport-replaces-draft-id\",\n  replacedRevision: \"support-passport-replaced-revision\",\n  draftReplacementPrepared: \"support-passport-draft-replacement-prepared\",\n  replacementComplete: \"support-passport-replacement-complete\",\n  generatedBatchId: \"support-passport-generated-batch-id\",\n  generatedBatchSize: \"support-passport-generated-batch-size\",\n});\n\nconst SUPPORT_PASSPORT_NAMESPACE_ENCODING = \"base64url-v1\";\nconst SUPPORT_PASSPORT_NAMESPACE_CHUNK_PREFIX = \"support-passport-namespace-\";\nconst SUPPORT_PASSPORT_NAMESPACE_CHUNK_SIZE = 1_024;\nconst LegacySupportPassportNamespaceSchema = SupportPassportNamespaceSchema.refine(\n  (namespace) =>\n    !namespace.includes(\"/\") &&\n    !namespace.includes(\"\\\\\") &&\n    !namespace.includes(\"..\") &&\n    !namespace.includes(\"]\") &&\n    !namespace.includes(\"\\0\") &&\n    !namespace.includes(\"\\n\") &&\n    !namespace.includes(\"\\r\")\n);\n\nexport function encodeSupportPassportNamespaceAttributes(namespace: string): Record<string, string> {\n  const canonical = SupportPassportNamespaceSchema.parse(namespace);\n  const encoded = Buffer.from(canonical, \"utf8\").toString(\"base64url\");\n  const chunks = encoded.match(new RegExp(`.{1,${SUPPORT_PASSPORT_NAMESPACE_CHUNK_SIZE}}`, \"g\")) ?? [];\n  const digest = createHash(\"sha256\").update(encoded).digest(\"hex\");\n  return Object.fromEntries([\n    [SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespace, chunks[0] ?? \"\"],\n    [\n      SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespaceEncoding,\n      `${SUPPORT_PASSPORT_NAMESPACE_ENCODING}:${chunks.length}:${digest}`,\n    ],\n    ...chunks.slice(1).map((chunk, index) => [`${SUPPORT_PASSPORT_NAMESPACE_CHUNK_PREFIX}${index + 1}`, chunk]),\n  ]);\n}\n\nexport function decodeSupportPassportNamespaceAttributes(attributes: Readonly<Record<string, string>>): string | null {\n  const firstChunk = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespace];\n  const encoding = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespaceEncoding];\n  if (encoding === undefined) {\n    const legacy = LegacySupportPassportNamespaceSchema.safeParse(firstChunk);\n    return legacy.success ? legacy.data : null;\n  }\n  const match = /^base64url-v1:([1-9]\\d*):([a-f0-9]{64})$/.exec(encoding);\n  if (!match || typeof firstChunk !== \"string\") return null;\n  const chunkCount = Number(match[1]);\n  if (!Number.isSafeInteger(chunkCount)) return null;\n  const chunkIndexes = Object.keys(attributes).flatMap((key) => {\n    const chunkMatch = /^support-passport-namespace-(\\d+)$/.exec(key);\n    return chunkMatch ? [Number(chunkMatch[1])] : [];\n  });\n  if (\n    chunkIndexes.length !== chunkCount - 1 ||\n    chunkIndexes.some((index) => !Number.isSafeInteger(index) || index < 1 || index >= chunkCount)\n  )\n    return null;\n  const chunks = [firstChunk];\n  for (let index = 1; index < chunkCount; index += 1) {\n    const chunk = attributes[`${SUPPORT_PASSPORT_NAMESPACE_CHUNK_PREFIX}${index}`];\n    if (typeof chunk !== \"string\" || chunk.length === 0) return null;\n    chunks.push(chunk);\n  }\n  const encoded = chunks.join(\"\");\n  if (createHash(\"sha256\").update(encoded).digest(\"hex\") !== match[2]) return null;\n  const decoded = Buffer.from(encoded, \"base64url\").toString(\"utf8\");\n  if (Buffer.from(decoded, \"utf8\").toString(\"base64url\") !== encoded) return null;\n  const namespace = SupportPassportNamespaceSchema.safeParse(decoded);\n  return namespace.success ? namespace.data : null;\n}\n\nexport interface StoredSupportPassportCard {\n  card: SupportPassportCard;\n  memory: MemoryFile;\n  order: number;\n  sourceMemoryIds: string[];\n  namespace: string;\n  owner: string;\n  replacesDraftId?: string;\n  replacedRevision?: string;\n  draftReplacementPrepared: boolean;\n  generatedBatchId?: string;\n  generatedBatchSize?: number;\n}\n\nexport function computeSupportPassportOwnerKey(principal: string): string {\n  return createHash(\"sha256\").update(principal).digest(\"hex\");\n}\n\nexport function activeSupportPassportReplacementPredecessorIds(\n  cards: readonly StoredSupportPassportCard[],\n): Set<string> {\n  return new Set(\n    cards\n      .filter((item) => item.card.status === \"active\")\n      .map((item) => item.memory.frontmatter.supersedes)\n      .filter((cardId): cardId is string => typeof cardId === \"string\"),\n  );\n}\n\nfunction parseSourceMemoryIds(frontmatter: MemoryFile[\"frontmatter\"]): string[] | null {\n  const lineage = frontmatter.lineage;\n  const legacyValue = frontmatter.structuredAttributes?.[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.sourceMemoryIds];\n  const rawIds = lineage ?? (legacyValue === undefined || legacyValue === \"\" ? [] : legacyValue.split(\",\"));\n  if (rawIds.length > 5) return null;\n  const normalized: string[] = [];\n  for (const rawId of rawIds) {\n    const parsed = SupportPassportSourceMemoryIdSchema.safeParse(rawId);\n    if (!parsed.success) return null;\n    normalized.push(parsed.data);\n  }\n  if (new Set(normalized).size !== normalized.length) return null;\n  return normalized;\n}\n\ninterface SupportPassportCardMetadata {\n  fields: Omit<SupportPassportCard, \"revision\" | \"statement\">;\n  order: number;\n  sourceMemoryIds: string[];\n  namespace: string;\n  owner: string;\n  replacesDraftId?: string;\n  replacedRevision?: string;\n  draftReplacementPrepared: boolean;\n  generatedBatchId?: string;\n  generatedBatchSize?: number;\n}\n\nfunction parseSupportPassportCardMetadata(\n  memory: Pick<MemoryFile, \"frontmatter\">,\n): SupportPassportCardMetadata | null {\n  const frontmatter = memory.frontmatter;\n  const attributes = frontmatter.structuredAttributes;\n  if (frontmatter.category !== \"preference\") return null;\n  if (!frontmatter.tags?.includes(SUPPORT_PASSPORT_CARD_TAG)) return null;\n  if (\n    !attributes ||\n    frontmatter.blockedBy ||\n    frontmatter.archivedAt ||\n    frontmatter.supersededBy\n  )\n    return null;\n\n  const category = SupportPassportCardCategorySchema.safeParse(\n    attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.category],\n  );\n  const status = SupportPassportCardStatusSchema.safeParse(frontmatter.status);\n  const rawOrder = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.order];\n  const order = Number(rawOrder);\n  const sourceMemoryIds = parseSourceMemoryIds(frontmatter);\n  const namespace = decodeSupportPassportNamespaceAttributes(attributes);\n  const owner = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.owner];\n  let replacesDraftId: string | undefined;\n  const rawReplacesDraftId =\n    attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.replacesDraftId];\n  if (rawReplacesDraftId !== undefined) {\n    const parsedReplacesDraftId =\n      SupportPassportMemoryIdSchema.safeParse(rawReplacesDraftId);\n    if (!parsedReplacesDraftId.success) return null;\n    replacesDraftId = parsedReplacesDraftId.data;\n  }\n  let replacedRevision: string | undefined;\n  const rawReplacedRevision =\n    attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.replacedRevision];\n  if (rawReplacedRevision !== undefined) {\n    if (!/^[a-f0-9]{64}$/.test(rawReplacedRevision)) return null;\n    replacedRevision = rawReplacedRevision;\n  }\n  const generatedBatchId = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.generatedBatchId];\n  const rawGeneratedBatchSize = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.generatedBatchSize];\n  let generatedBatchSize: number | undefined;\n  if (generatedBatchId !== undefined) {\n    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(generatedBatchId)) {\n      return null;\n    }\n    if (\n      typeof rawGeneratedBatchSize !== \"string\" ||\n      !/^[1-8]$/.test(rawGeneratedBatchSize)\n    ) {\n      return null;\n    }\n    generatedBatchSize = Number(rawGeneratedBatchSize);\n  } else if (rawGeneratedBatchSize !== undefined) {\n    return null;\n  }\n  if (\n    !category.success ||\n    !status.success ||\n    status.data === \"superseded\" ||\n    typeof rawOrder !== \"string\" ||\n    !/^(?:0|[1-9]\\d*)$/.test(rawOrder) ||\n    !Number.isSafeInteger(order) ||\n    namespace === null ||\n    typeof owner !== \"string\" ||\n    !/^[a-f0-9]{64}$/.test(owner) ||\n    !sourceMemoryIds\n  )\n    return null;\n  const fields = SupportPassportCardSchema.omit({\n    revision: true,\n    statement: true,\n  }).safeParse({\n    cardId: frontmatter.id,\n    title: attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.title],\n    category: category.data,\n    status: status.data,\n    updatedAt: frontmatter.updated,\n    reviewBy: attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.reviewBy],\n  });\n  if (!fields.success) return null;\n  return {\n    fields: fields.data,\n    order,\n    sourceMemoryIds,\n    namespace,\n    owner,\n    replacesDraftId,\n    replacedRevision,\n    draftReplacementPrepared:\n      attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.draftReplacementPrepared] ===\n      \"true\",\n    generatedBatchId,\n    generatedBatchSize,\n  };\n}\n\nexport function hasLiveSupportPassportCard(memory: Pick<MemoryFile, \"frontmatter\" | \"content\">): boolean {\n  const metadata = parseSupportPassportCardMetadata(memory);\n  if (metadata?.fields.status !== \"active\" && metadata?.fields.status !== \"pending_review\") return false;\n  return SupportPassportCardSchema.omit({ revision: true }).safeParse({\n    ...metadata.fields,\n    statement: stripAttributesSuffix(memory.content),\n  }).success;\n}\n\nexport function projectSupportPassportCard(\n  memory: MemoryFile,\n): StoredSupportPassportCard | null {\n  const metadata = parseSupportPassportCardMetadata(memory);\n  if (!metadata) return null;\n\n  const fields = {\n    ...metadata.fields,\n    statement: stripAttributesSuffix(memory.content),\n  };\n  const normalized = SupportPassportCardSchema.omit({\n    revision: true,\n  }).safeParse(fields);\n  if (!normalized.success) return null;\n  const parsed = SupportPassportCardSchema.safeParse({\n    ...normalized.data,\n    revision: computeSupportPassportCardRevision(normalized.data),\n  });\n  if (!parsed.success) return null;\n  return {\n    card: parsed.data,\n    memory,\n    order: metadata.order,\n    sourceMemoryIds: metadata.sourceMemoryIds,\n    namespace: metadata.namespace,\n    owner: metadata.owner,\n    replacesDraftId: metadata.replacesDraftId,\n    replacedRevision: metadata.replacedRevision,\n    draftReplacementPrepared: metadata.draftReplacementPrepared,\n    generatedBatchId: metadata.generatedBatchId,\n    generatedBatchSize: metadata.generatedBatchSize,\n  };\n}\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,SAAS;AAKX,IAAM,mCAAmC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,iCAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,oCAAoC,EAAE,KAAK,gCAAgC;AACjF,IAAM,kCAAkC,EAAE,KAAK,8BAA8B;AAC7E,IAAM,iCAAiC,EAC3C,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,IAAI,EAAE,EACN,OAAO,CAAC,UAAU,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,SAAS,IAAI,KAAK,CAAC,MAAM,SAAS,IAAI,GAAG;AAAA,EACzF,SAAS;AACX,CAAC;AAEH,IAAM,qBAAqB,EACxB,OAAO,EACP,SAAS,EAAE,QAAQ,KAAK,CAAC,EACzB,OAAO,CAAC,UAAU,wBAAwB,KAAK,MAAM,MAAM;AAAA,EAC1D,SAAS;AACX,CAAC;AACI,IAAM,iCAAiC,EAC3C,OAAO,EACP,IAAI,CAAC,EACL,OAAO,CAAC,cAAc,cAAc,2BAA2B,SAAS,GAAG;AAAA,EAC1E,SAAS;AACX,CAAC;AACI,IAAM,gCAAgC,EAC1C,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,IAAI,GAAG,EACP,MAAM,oBAAoB;AACtB,IAAM,+CAA+C;AACrD,IAAM,sCAAsC,EAChD,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,IAAI,4CAA4C;AAE5C,IAAM,4BAA4B,EACtC,OAAO;AAAA,EACN,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC3C,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB;AAC7C,CAAC,EACA,OAAO;AAEH,IAAM,gCAAgC,EAC1C,MAAM,yBAAyB,EAC/B,IAAI,GAAG,EACP,YAAY,CAAC,OAAO,QAAQ;AAC3B,QAAM,OAAO,oBAAI,IAAY;AAC7B,aAAW,CAAC,OAAO,IAAI,KAAK,MAAM,QAAQ,GAAG;AAC3C,QAAI,KAAK,IAAI,KAAK,MAAM,GAAG;AACzB,UAAI,SAAS;AAAA,QACX,MAAM,EAAE,aAAa;AAAA,QACrB,SAAS;AAAA,QACT,MAAM,CAAC,OAAO,QAAQ;AAAA,MACxB,CAAC;AAAA,IACH;AACA,SAAK,IAAI,KAAK,MAAM;AAAA,EACtB;AACF,CAAC;AAEI,IAAM,sCAAsC,EAChD,OAAO;AAAA,EACN,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAC7C,CAAC,EACA,OAAO;AAEH,IAAM,wCAAwC,EAClD,OAAO;AAAA,EACN,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC3C,OAAO;AAAA,EACP,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC3C,UAAU;AAAA,EACV,UAAU;AACZ,CAAC,EACA,OAAO;AAEH,IAAM,yCAAyC,EACnD,OAAO;AAAA,EACN,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC3C,QAAQ;AAAA,EACR,kBAAkB,EAAE,OAAO,EAAE,MAAM,gBAAgB;AAAA,EACnD,YAAY,EACT,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,IAAI,EAAE,EACN,MAAM,cAAc,EACpB,SAAS;AACd,CAAC,EACA,OAAO;AAEH,IAAM,wCAAwC,uCAAuC,OAAO;AAAA,EACjG,OAAO;AAAA,EACP,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC3C,UAAU;AAAA,EACV,UAAU;AACZ,CAAC,EAAE,OAAO;AAWH,SAAS,mCAAmC,QAAgC;AACjF,QAAM,kBAAkB;AAAA,IACtB,QAAQ,OAAO;AAAA,IACf,UAAU,OAAO;AAAA,IACjB,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,QAAQ,OAAO;AAAA,IACf,OAAO,OAAO;AAAA,IACd,WAAW,OAAO;AAAA,EACpB;AACA,SAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,UAAU,eAAe,CAAC,EAAE,OAAO,KAAK;AAClF;;;ACpJA,SAAS,cAAAA,mBAAkB;AAC3B,SAAS,aAAa;AAgBf,IAAM,4BAA4B;AAClC,IAAM,6BAA6B;AAEnC,SAAS,+BAA+B,QAKnC;AACV,QAAM,OAAO,OAAO,YAAY;AAChC,MAAI,MAAM,SAAS,yBAAyB,MAAM,QAAQ,MAAM,SAAS,0BAA0B,MAAM,MAAM;AAC7G,WAAO;AAAA,EACT;AACA,SAAO,OAAO,KAAK,OAAO,YAAY,wBAAwB,CAAC,CAAC,EAC7D,KAAK,CAAC,QAAQ,IAAI,WAAW,mBAAmB,CAAC;AACtD;AAEO,SAAS,sCACd,UACK;AACL,SAAO,SAAS,OAAO,CAAC,WAAW,CAAC,+BAA+B,MAAM,CAAC;AAC5E;AAEO,SAAS,0CAA0C,SAE/B;AACzB,QAAM,kBAAkB,oBAAI,IAA8D;AAC1F,SAAO,OAAO,EAAE,SAAS,MAAM;AAC7B,QAAI;AACJ,QAAI;AACF,aAAO,MAAM,MAAM,QAAQ;AAAA,IAC7B,SAAS,OAAO;AACd,UAAK,MAAgC,SAAS,UAAU;AACtD,wBAAgB,OAAO,QAAQ;AAC/B,eAAO;AAAA,MACT;AACA,YAAM;AAAA,IACR;AACA,UAAM,WAAW,GAAG,KAAK,GAAG,IAAI,KAAK,GAAG,IAAI,KAAK,IAAI,IAAI,KAAK,OAAO,IAAI,KAAK,OAAO;AACrF,UAAM,SAAS,gBAAgB,IAAI,QAAQ;AAC3C,QAAI,QAAQ,aAAa,SAAU,QAAO,MAAM,OAAO;AACvD,UAAM,WAAW,QACd,iBAAiB,QAAQ,EACzB,KAAK,CAAC,WAAY,SAAS,+BAA+B,MAAM,IAAI,KAAM;AAC7E,oBAAgB,IAAI,UAAU,EAAE,UAAU,SAAS,CAAC;AACpD,QAAI;AACF,aAAO,MAAM;AAAA,IACf,SAAS,OAAO;AACd,UAAI,gBAAgB,IAAI,QAAQ,GAAG,aAAa,SAAU,iBAAgB,OAAO,QAAQ;AACzF,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAEO,IAAM,kCAAkC,OAAO,OAAO;AAAA,EAC3D,WAAW;AAAA,EACX,mBAAmB;AAAA,EACnB,OAAO;AAAA,EACP,OAAO;AAAA,EACP,UAAU;AAAA,EACV,OAAO;AAAA,EACP,UAAU;AAAA,EACV,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,0BAA0B;AAAA,EAC1B,qBAAqB;AAAA,EACrB,kBAAkB;AAAA,EAClB,oBAAoB;AACtB,CAAC;AAED,IAAM,sCAAsC;AAC5C,IAAM,0CAA0C;AAChD,IAAM,wCAAwC;AAC9C,IAAM,uCAAuC,+BAA+B;AAAA,EAC1E,CAAC,cACC,CAAC,UAAU,SAAS,GAAG,KACvB,CAAC,UAAU,SAAS,IAAI,KACxB,CAAC,UAAU,SAAS,IAAI,KACxB,CAAC,UAAU,SAAS,GAAG,KACvB,CAAC,UAAU,SAAS,IAAI,KACxB,CAAC,UAAU,SAAS,IAAI,KACxB,CAAC,UAAU,SAAS,IAAI;AAC5B;AAEO,SAAS,yCAAyC,WAA2C;AAClG,QAAM,YAAY,+BAA+B,MAAM,SAAS;AAChE,QAAM,UAAU,OAAO,KAAK,WAAW,MAAM,EAAE,SAAS,WAAW;AACnE,QAAM,SAAS,QAAQ,MAAM,IAAI,OAAO,OAAO,qCAAqC,KAAK,GAAG,CAAC,KAAK,CAAC;AACnG,QAAM,SAASC,YAAW,QAAQ,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK;AAChE,SAAO,OAAO,YAAY;AAAA,IACxB,CAAC,gCAAgC,WAAW,OAAO,CAAC,KAAK,EAAE;AAAA,IAC3D;AAAA,MACE,gCAAgC;AAAA,MAChC,GAAG,mCAAmC,IAAI,OAAO,MAAM,IAAI,MAAM;AAAA,IACnE;AAAA,IACA,GAAG,OAAO,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,UAAU,CAAC,GAAG,uCAAuC,GAAG,QAAQ,CAAC,IAAI,KAAK,CAAC;AAAA,EAC5G,CAAC;AACH;AAEO,SAAS,yCAAyC,YAA6D;AACpH,QAAM,aAAa,WAAW,gCAAgC,SAAS;AACvE,QAAM,WAAW,WAAW,gCAAgC,iBAAiB;AAC7E,MAAI,aAAa,QAAW;AAC1B,UAAM,SAAS,qCAAqC,UAAU,UAAU;AACxE,WAAO,OAAO,UAAU,OAAO,OAAO;AAAA,EACxC;AACA,QAAM,QAAQ,2CAA2C,KAAK,QAAQ;AACtE,MAAI,CAAC,SAAS,OAAO,eAAe,SAAU,QAAO;AACrD,QAAM,aAAa,OAAO,MAAM,CAAC,CAAC;AAClC,MAAI,CAAC,OAAO,cAAc,UAAU,EAAG,QAAO;AAC9C,QAAM,eAAe,OAAO,KAAK,UAAU,EAAE,QAAQ,CAAC,QAAQ;AAC5D,UAAM,aAAa,qCAAqC,KAAK,GAAG;AAChE,WAAO,aAAa,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AAAA,EACjD,CAAC;AACD,MACE,aAAa,WAAW,aAAa,KACrC,aAAa,KAAK,CAAC,UAAU,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,KAAK,SAAS,UAAU;AAE7F,WAAO;AACT,QAAM,SAAS,CAAC,UAAU;AAC1B,WAAS,QAAQ,GAAG,QAAQ,YAAY,SAAS,GAAG;AAClD,UAAM,QAAQ,WAAW,GAAG,uCAAuC,GAAG,KAAK,EAAE;AAC7E,QAAI,OAAO,UAAU,YAAY,MAAM,WAAW,EAAG,QAAO;AAC5D,WAAO,KAAK,KAAK;AAAA,EACnB;AACA,QAAM,UAAU,OAAO,KAAK,EAAE;AAC9B,MAAIA,YAAW,QAAQ,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK,MAAM,MAAM,CAAC,EAAG,QAAO;AAC5E,QAAM,UAAU,OAAO,KAAK,SAAS,WAAW,EAAE,SAAS,MAAM;AACjE,MAAI,OAAO,KAAK,SAAS,MAAM,EAAE,SAAS,WAAW,MAAM,QAAS,QAAO;AAC3E,QAAM,YAAY,+BAA+B,UAAU,OAAO;AAClE,SAAO,UAAU,UAAU,UAAU,OAAO;AAC9C;AAgBO,SAAS,+BAA+B,WAA2B;AACxE,SAAOA,YAAW,QAAQ,EAAE,OAAO,SAAS,EAAE,OAAO,KAAK;AAC5D;AAEO,SAAS,+CACd,OACa;AACb,SAAO,IAAI;AAAA,IACT,MACG,OAAO,CAAC,SAAS,KAAK,KAAK,WAAW,QAAQ,EAC9C,IAAI,CAAC,SAAS,KAAK,OAAO,YAAY,UAAU,EAChD,OAAO,CAAC,WAA6B,OAAO,WAAW,QAAQ;AAAA,EACpE;AACF;AAEA,SAAS,qBAAqB,aAAyD;AACrF,QAAM,UAAU,YAAY;AAC5B,QAAM,cAAc,YAAY,uBAAuB,gCAAgC,eAAe;AACtG,QAAM,SAAS,YAAY,gBAAgB,UAAa,gBAAgB,KAAK,CAAC,IAAI,YAAY,MAAM,GAAG;AACvG,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,QAAM,aAAuB,CAAC;AAC9B,aAAW,SAAS,QAAQ;AAC1B,UAAM,SAAS,oCAAoC,UAAU,KAAK;AAClE,QAAI,CAAC,OAAO,QAAS,QAAO;AAC5B,eAAW,KAAK,OAAO,IAAI;AAAA,EAC7B;AACA,MAAI,IAAI,IAAI,UAAU,EAAE,SAAS,WAAW,OAAQ,QAAO;AAC3D,SAAO;AACT;AAeA,SAAS,iCACP,QACoC;AACpC,QAAM,cAAc,OAAO;AAC3B,QAAM,aAAa,YAAY;AAC/B,MAAI,YAAY,aAAa,aAAc,QAAO;AAClD,MAAI,CAAC,YAAY,MAAM,SAAS,yBAAyB,EAAG,QAAO;AACnE,MACE,CAAC,cACD,YAAY,aACZ,YAAY,cACZ,YAAY;AAEZ,WAAO;AAET,QAAM,WAAW,kCAAkC;AAAA,IACjD,WAAW,gCAAgC,QAAQ;AAAA,EACrD;AACA,QAAM,SAAS,gCAAgC,UAAU,YAAY,MAAM;AAC3E,QAAM,WAAW,WAAW,gCAAgC,KAAK;AACjE,QAAM,QAAQ,OAAO,QAAQ;AAC7B,QAAM,kBAAkB,qBAAqB,WAAW;AACxD,QAAM,YAAY,yCAAyC,UAAU;AACrE,QAAM,QAAQ,WAAW,gCAAgC,KAAK;AAC9D,MAAI;AACJ,QAAM,qBACJ,WAAW,gCAAgC,eAAe;AAC5D,MAAI,uBAAuB,QAAW;AACpC,UAAM,wBACJ,8BAA8B,UAAU,kBAAkB;AAC5D,QAAI,CAAC,sBAAsB,QAAS,QAAO;AAC3C,sBAAkB,sBAAsB;AAAA,EAC1C;AACA,MAAI;AACJ,QAAM,sBACJ,WAAW,gCAAgC,gBAAgB;AAC7D,MAAI,wBAAwB,QAAW;AACrC,QAAI,CAAC,iBAAiB,KAAK,mBAAmB,EAAG,QAAO;AACxD,uBAAmB;AAAA,EACrB;AACA,QAAM,mBAAmB,WAAW,gCAAgC,gBAAgB;AACpF,QAAM,wBAAwB,WAAW,gCAAgC,kBAAkB;AAC3F,MAAI;AACJ,MAAI,qBAAqB,QAAW;AAClC,QAAI,CAAC,wEAAwE,KAAK,gBAAgB,GAAG;AACnG,aAAO;AAAA,IACT;AACA,QACE,OAAO,0BAA0B,YACjC,CAAC,UAAU,KAAK,qBAAqB,GACrC;AACA,aAAO;AAAA,IACT;AACA,yBAAqB,OAAO,qBAAqB;AAAA,EACnD,WAAW,0BAA0B,QAAW;AAC9C,WAAO;AAAA,EACT;AACA,MACE,CAAC,SAAS,WACV,CAAC,OAAO,WACR,OAAO,SAAS,gBAChB,OAAO,aAAa,YACpB,CAAC,mBAAmB,KAAK,QAAQ,KACjC,CAAC,OAAO,cAAc,KAAK,KAC3B,cAAc,QACd,OAAO,UAAU,YACjB,CAAC,iBAAiB,KAAK,KAAK,KAC5B,CAAC;AAED,WAAO;AACT,QAAM,SAAS,0BAA0B,KAAK;AAAA,IAC5C,UAAU;AAAA,IACV,WAAW;AAAA,EACb,CAAC,EAAE,UAAU;AAAA,IACX,QAAQ,YAAY;AAAA,IACpB,OAAO,WAAW,gCAAgC,KAAK;AAAA,IACvD,UAAU,SAAS;AAAA,IACnB,QAAQ,OAAO;AAAA,IACf,WAAW,YAAY;AAAA,IACvB,UAAU,WAAW,gCAAgC,QAAQ;AAAA,EAC/D,CAAC;AACD,MAAI,CAAC,OAAO,QAAS,QAAO;AAC5B,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,0BACE,WAAW,gCAAgC,wBAAwB,MACnE;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,2BAA2B,QAA8D;AACvG,QAAM,WAAW,iCAAiC,MAAM;AACxD,MAAI,UAAU,OAAO,WAAW,YAAY,UAAU,OAAO,WAAW,iBAAkB,QAAO;AACjG,SAAO,0BAA0B,KAAK,EAAE,UAAU,KAAK,CAAC,EAAE,UAAU;AAAA,IAClE,GAAG,SAAS;AAAA,IACZ,WAAW,sBAAsB,OAAO,OAAO;AAAA,EACjD,CAAC,EAAE;AACL;AAEO,SAAS,2BACd,QACkC;AAClC,QAAM,WAAW,iCAAiC,MAAM;AACxD,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS;AAAA,IACb,GAAG,SAAS;AAAA,IACZ,WAAW,sBAAsB,OAAO,OAAO;AAAA,EACjD;AACA,QAAM,aAAa,0BAA0B,KAAK;AAAA,IAChD,UAAU;AAAA,EACZ,CAAC,EAAE,UAAU,MAAM;AACnB,MAAI,CAAC,WAAW,QAAS,QAAO;AAChC,QAAM,SAAS,0BAA0B,UAAU;AAAA,IACjD,GAAG,WAAW;AAAA,IACd,UAAU,mCAAmC,WAAW,IAAI;AAAA,EAC9D,CAAC;AACD,MAAI,CAAC,OAAO,QAAS,QAAO;AAC5B,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb;AAAA,IACA,OAAO,SAAS;AAAA,IAChB,iBAAiB,SAAS;AAAA,IAC1B,WAAW,SAAS;AAAA,IACpB,OAAO,SAAS;AAAA,IAChB,iBAAiB,SAAS;AAAA,IAC1B,kBAAkB,SAAS;AAAA,IAC3B,0BAA0B,SAAS;AAAA,IACnC,kBAAkB,SAAS;AAAA,IAC3B,oBAAoB,SAAS;AAAA,EAC/B;AACF;","names":["createHash","createHash"]}
+{"version":3,"sources":["../src/support-passport/contracts.ts","../src/support-passport/card-projection.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { z } from \"zod\";\n\nimport { normalizeNamespaceIdentity } from \"../namespaces/identity.js\";\nimport { parseIsoOffsetTimestamp } from \"../utils/iso-timestamp.js\";\n\nexport const SUPPORT_PASSPORT_CARD_CATEGORIES = [\n  \"communication\",\n  \"environment\",\n  \"transitions\",\n  \"sensory\",\n  \"regulation\",\n  \"interests\",\n  \"other\",\n] as const;\n\nexport const SUPPORT_PASSPORT_CARD_STATUSES = [\n  \"pending_review\",\n  \"active\",\n  \"rejected\",\n  \"superseded\",\n  \"archived\",\n] as const;\n\nexport const SupportPassportCardCategorySchema = z.enum(SUPPORT_PASSPORT_CARD_CATEGORIES);\nexport const SupportPassportCardStatusSchema = z.enum(SUPPORT_PASSPORT_CARD_STATUSES);\nexport const SupportPassportCardTitleSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .max(80)\n  .refine((title) => !title.includes(\"]\") && !title.includes(\"\\n\") && !title.includes(\"\\r\"), {\n    message: \"card titles cannot contain closing brackets or line breaks\",\n  });\n\nconst IsoTimestampSchema = z\n  .string()\n  .datetime({ offset: true })\n  .refine((value) => parseIsoOffsetTimestamp(value) !== null, {\n    message: \"timestamps must be valid ISO 8601 values\",\n  });\nexport const SupportPassportNamespaceSchema = z\n  .string()\n  .min(1)\n  .refine((namespace) => namespace === normalizeNamespaceIdentity(namespace), {\n    message: \"namespaces must be canonical\",\n  });\nexport const SupportPassportMemoryIdSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .max(128)\n  .regex(/^[A-Za-z0-9._:-]+$/);\nexport const SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH = 512;\nexport const SupportPassportSourceMemoryIdSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .max(SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH);\n\nexport const SupportPassportCardSchema = z\n  .object({\n    cardId: SupportPassportMemoryIdSchema,\n    title: SupportPassportCardTitleSchema,\n    statement: z.string().trim().min(1).max(500),\n    category: SupportPassportCardCategorySchema,\n    status: SupportPassportCardStatusSchema,\n    updatedAt: IsoTimestampSchema,\n    reviewBy: IsoTimestampSchema,\n    revision: z.string().regex(/^[a-f0-9]{64}$/),\n  })\n  .strict();\n\nexport const SupportPassportCardListSchema = z\n  .array(SupportPassportCardSchema)\n  .max(100)\n  .superRefine((cards, ctx) => {\n    const seen = new Set<string>();\n    for (const [index, card] of cards.entries()) {\n      if (seen.has(card.cardId)) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: \"card IDs must be unique\",\n          path: [index, \"cardId\"],\n        });\n      }\n      seen.add(card.cardId);\n    }\n  });\n\nexport const SupportPassportListCardsInputSchema = z\n  .object({\n    principal: z.string().trim().min(1).max(512),\n  })\n  .strict();\n\nexport const SupportPassportManualDraftInputSchema = z\n  .object({\n    principal: z.string().trim().min(1).max(512),\n    title: SupportPassportCardTitleSchema,\n    statement: z.string().trim().min(1).max(500),\n    category: SupportPassportCardCategorySchema,\n    reviewBy: IsoTimestampSchema,\n  })\n  .strict();\n\nexport const SupportPassportCardMutationInputSchema = z\n  .object({\n    principal: z.string().trim().min(1).max(512),\n    cardId: SupportPassportMemoryIdSchema,\n    expectedRevision: z.string().regex(/^[a-f0-9]{64}$/),\n    reasonCode: z\n      .string()\n      .trim()\n      .min(1)\n      .max(64)\n      .regex(/^[a-z0-9-]+$/)\n      .optional(),\n  })\n  .strict();\n\nexport const SupportPassportReplaceCardInputSchema = SupportPassportCardMutationInputSchema.extend({\n  title: SupportPassportCardTitleSchema,\n  statement: z.string().trim().min(1).max(500),\n  category: SupportPassportCardCategorySchema,\n  reviewBy: IsoTimestampSchema,\n}).strict();\n\nexport type SupportPassportCard = z.infer<typeof SupportPassportCardSchema>;\nexport type SupportPassportCardCategory = z.infer<typeof SupportPassportCardCategorySchema>;\nexport type SupportPassportCardStatus = z.infer<typeof SupportPassportCardStatusSchema>;\nexport type SupportPassportManualDraftInput = z.input<typeof SupportPassportManualDraftInputSchema>;\nexport type SupportPassportCardMutationInput = z.input<typeof SupportPassportCardMutationInputSchema>;\nexport type SupportPassportReplaceCardInput = z.input<typeof SupportPassportReplaceCardInputSchema>;\n\ntype RevisionFields = Omit<SupportPassportCard, \"revision\">;\n\nexport function computeSupportPassportCardRevision(fields: RevisionFields): string {\n  const canonicalFields = {\n    cardId: fields.cardId,\n    category: fields.category,\n    reviewBy: fields.reviewBy,\n    statement: fields.statement,\n    status: fields.status,\n    title: fields.title,\n    updatedAt: fields.updatedAt,\n  };\n  return createHash(\"sha256\").update(JSON.stringify(canonicalFields)).digest(\"hex\");\n}\n","import { createHash } from \"node:crypto\";\nimport { lstat } from \"node:fs/promises\";\n\nimport type { OfflineSyncExcludeFile } from \"../offline-sync-file-io.js\";\nimport { stripAttributesSuffix } from \"../structured-attributes.js\";\nimport type { MemoryFile } from \"../types.js\";\nimport {\n  type SupportPassportCard,\n  SupportPassportCardCategorySchema,\n  SupportPassportCardSchema,\n  SupportPassportCardStatusSchema,\n  SupportPassportMemoryIdSchema,\n  SupportPassportNamespaceSchema,\n  SupportPassportSourceMemoryIdSchema,\n  computeSupportPassportCardRevision,\n} from \"./contracts.js\";\n\nexport const SUPPORT_PASSPORT_CARD_TAG = \"support-passport-card\";\nexport const SUPPORT_PASSPORT_AUDIT_TAG = \"support-passport-audit\";\n\nexport function isSupportPassportPrivateMemory(memory: {\n  frontmatter: {\n    tags?: readonly string[];\n    structuredAttributes?: Readonly<Record<string, string>>;\n  };\n}): boolean {\n  const tags = memory.frontmatter.tags;\n  if (tags?.includes(SUPPORT_PASSPORT_CARD_TAG) === true || tags?.includes(SUPPORT_PASSPORT_AUDIT_TAG) === true) {\n    return true;\n  }\n  return Object.keys(memory.frontmatter.structuredAttributes ?? {})\n    .some((key) => key.startsWith(\"support-passport-\"));\n}\n\nexport function excludeSupportPassportPrivateMemories<T extends Pick<MemoryFile, \"frontmatter\">>(\n  memories: readonly T[]\n): T[] {\n  return memories.filter((memory) => !isSupportPassportPrivateMemory(memory));\n}\n\nexport function createSupportPassportPrivateFileExclusion(storage: {\n  readMemoryByPath(filePath: string): Promise<MemoryFile | null>;\n}): OfflineSyncExcludeFile {\n  const classifications = new Map<string, { identity: string; excluded: Promise<boolean> }>();\n  return async ({ filePath }) => {\n    let file: Awaited<ReturnType<typeof lstat>>;\n    try {\n      file = await lstat(filePath);\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n        classifications.delete(filePath);\n        return false;\n      }\n      throw error;\n    }\n    const identity = `${file.dev}:${file.ino}:${file.size}:${file.mtimeMs}:${file.ctimeMs}`;\n    const cached = classifications.get(filePath);\n    if (cached?.identity === identity) return await cached.excluded;\n    const excluded = storage\n      .readMemoryByPath(filePath)\n      .then((memory) => (memory ? isSupportPassportPrivateMemory(memory) : false));\n    classifications.set(filePath, { identity, excluded });\n    try {\n      return await excluded;\n    } catch (error) {\n      if (classifications.get(filePath)?.excluded === excluded) classifications.delete(filePath);\n      throw error;\n    }\n  };\n}\n\nexport const SUPPORT_PASSPORT_ATTRIBUTE_KEYS = Object.freeze({\n  namespace: \"support-passport-namespace\",\n  namespaceEncoding: \"support-passport-namespace-encoding\",\n  owner: \"support-passport-owner\",\n  title: \"support-passport-title\",\n  category: \"support-passport-category\",\n  order: \"support-passport-order\",\n  reviewBy: \"support-passport-review-by\",\n  sourceMemoryIds: \"support-passport-source-ids\",\n  replacesDraftId: \"support-passport-replaces-draft-id\",\n  replacedRevision: \"support-passport-replaced-revision\",\n  draftReplacementPrepared: \"support-passport-draft-replacement-prepared\",\n  replacementComplete: \"support-passport-replacement-complete\",\n  generatedBatchId: \"support-passport-generated-batch-id\",\n  generatedBatchSize: \"support-passport-generated-batch-size\",\n});\n\nconst SUPPORT_PASSPORT_NAMESPACE_ENCODING = \"base64url-v1\";\nconst SUPPORT_PASSPORT_NAMESPACE_CHUNK_PREFIX = \"support-passport-namespace-\";\nconst SUPPORT_PASSPORT_NAMESPACE_CHUNK_SIZE = 1_024;\nconst LegacySupportPassportNamespaceSchema = SupportPassportNamespaceSchema.refine(\n  (namespace) =>\n    !namespace.includes(\"/\") &&\n    !namespace.includes(\"\\\\\") &&\n    !namespace.includes(\"..\") &&\n    !namespace.includes(\"]\") &&\n    !namespace.includes(\"\\0\") &&\n    !namespace.includes(\"\\n\") &&\n    !namespace.includes(\"\\r\")\n);\n\nexport function encodeSupportPassportNamespaceAttributes(namespace: string): Record<string, string> {\n  const canonical = SupportPassportNamespaceSchema.parse(namespace);\n  const encoded = Buffer.from(canonical, \"utf8\").toString(\"base64url\");\n  const chunks = encoded.match(new RegExp(`.{1,${SUPPORT_PASSPORT_NAMESPACE_CHUNK_SIZE}}`, \"g\")) ?? [];\n  const digest = createHash(\"sha256\").update(encoded).digest(\"hex\");\n  return Object.fromEntries([\n    [SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespace, chunks[0] ?? \"\"],\n    [\n      SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespaceEncoding,\n      `${SUPPORT_PASSPORT_NAMESPACE_ENCODING}:${chunks.length}:${digest}`,\n    ],\n    ...chunks.slice(1).map((chunk, index) => [`${SUPPORT_PASSPORT_NAMESPACE_CHUNK_PREFIX}${index + 1}`, chunk]),\n  ]);\n}\n\nexport function decodeSupportPassportNamespaceAttributes(attributes: Readonly<Record<string, string>>): string | null {\n  const firstChunk = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespace];\n  const encoding = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.namespaceEncoding];\n  if (encoding === undefined) {\n    const legacy = LegacySupportPassportNamespaceSchema.safeParse(firstChunk);\n    return legacy.success ? legacy.data : null;\n  }\n  const match = /^base64url-v1:([1-9]\\d*):([a-f0-9]{64})$/.exec(encoding);\n  if (!match || typeof firstChunk !== \"string\") return null;\n  const chunkCount = Number(match[1]);\n  if (!Number.isSafeInteger(chunkCount)) return null;\n  const chunkIndexes = Object.keys(attributes).flatMap((key) => {\n    const chunkMatch = /^support-passport-namespace-(\\d+)$/.exec(key);\n    return chunkMatch ? [Number(chunkMatch[1])] : [];\n  });\n  if (\n    chunkIndexes.length !== chunkCount - 1 ||\n    chunkIndexes.some((index) => !Number.isSafeInteger(index) || index < 1 || index >= chunkCount)\n  )\n    return null;\n  const chunks = [firstChunk];\n  for (let index = 1; index < chunkCount; index += 1) {\n    const chunk = attributes[`${SUPPORT_PASSPORT_NAMESPACE_CHUNK_PREFIX}${index}`];\n    if (typeof chunk !== \"string\" || chunk.length === 0) return null;\n    chunks.push(chunk);\n  }\n  const encoded = chunks.join(\"\");\n  if (createHash(\"sha256\").update(encoded).digest(\"hex\") !== match[2]) return null;\n  const decoded = Buffer.from(encoded, \"base64url\").toString(\"utf8\");\n  if (Buffer.from(decoded, \"utf8\").toString(\"base64url\") !== encoded) return null;\n  const namespace = SupportPassportNamespaceSchema.safeParse(decoded);\n  return namespace.success ? namespace.data : null;\n}\n\nexport interface StoredSupportPassportCard {\n  card: SupportPassportCard;\n  memory: MemoryFile;\n  order: number;\n  sourceMemoryIds: string[];\n  namespace: string;\n  owner: string;\n  replacesDraftId?: string;\n  replacedRevision?: string;\n  draftReplacementPrepared: boolean;\n  generatedBatchId?: string;\n  generatedBatchSize?: number;\n}\n\nexport function computeSupportPassportOwnerKey(principal: string): string {\n  return createHash(\"sha256\").update(principal).digest(\"hex\");\n}\n\nexport function activeSupportPassportReplacementPredecessorIds(\n  cards: readonly StoredSupportPassportCard[],\n): Set<string> {\n  return new Set(\n    cards\n      .filter((item) => item.card.status === \"active\")\n      .map((item) => item.memory.frontmatter.supersedes)\n      .filter((cardId): cardId is string => typeof cardId === \"string\"),\n  );\n}\n\nfunction parseSourceMemoryIds(frontmatter: MemoryFile[\"frontmatter\"]): string[] | null {\n  const lineage = frontmatter.lineage;\n  const legacyValue = frontmatter.structuredAttributes?.[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.sourceMemoryIds];\n  const rawIds = lineage ?? (legacyValue === undefined || legacyValue === \"\" ? [] : legacyValue.split(\",\"));\n  if (rawIds.length > 5) return null;\n  const normalized: string[] = [];\n  for (const rawId of rawIds) {\n    const parsed = SupportPassportSourceMemoryIdSchema.safeParse(rawId);\n    if (!parsed.success) return null;\n    normalized.push(parsed.data);\n  }\n  if (new Set(normalized).size !== normalized.length) return null;\n  return normalized;\n}\n\ninterface SupportPassportCardMetadata {\n  fields: Omit<SupportPassportCard, \"revision\" | \"statement\">;\n  order: number;\n  sourceMemoryIds: string[];\n  namespace: string;\n  owner: string;\n  replacesDraftId?: string;\n  replacedRevision?: string;\n  draftReplacementPrepared: boolean;\n  generatedBatchId?: string;\n  generatedBatchSize?: number;\n}\n\nfunction parseSupportPassportCardMetadata(\n  memory: Pick<MemoryFile, \"frontmatter\">,\n): SupportPassportCardMetadata | null {\n  const frontmatter = memory.frontmatter;\n  const attributes = frontmatter.structuredAttributes;\n  if (frontmatter.category !== \"preference\") return null;\n  if (!frontmatter.tags?.includes(SUPPORT_PASSPORT_CARD_TAG)) return null;\n  if (\n    !attributes ||\n    frontmatter.blockedBy ||\n    frontmatter.archivedAt ||\n    frontmatter.supersededBy\n  )\n    return null;\n\n  const category = SupportPassportCardCategorySchema.safeParse(\n    attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.category],\n  );\n  const status = SupportPassportCardStatusSchema.safeParse(frontmatter.status);\n  const rawOrder = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.order];\n  const order = Number(rawOrder);\n  const sourceMemoryIds = parseSourceMemoryIds(frontmatter);\n  const namespace = decodeSupportPassportNamespaceAttributes(attributes);\n  const owner = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.owner];\n  let replacesDraftId: string | undefined;\n  const rawReplacesDraftId =\n    attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.replacesDraftId];\n  if (rawReplacesDraftId !== undefined) {\n    const parsedReplacesDraftId =\n      SupportPassportMemoryIdSchema.safeParse(rawReplacesDraftId);\n    if (!parsedReplacesDraftId.success) return null;\n    replacesDraftId = parsedReplacesDraftId.data;\n  }\n  let replacedRevision: string | undefined;\n  const rawReplacedRevision =\n    attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.replacedRevision];\n  if (rawReplacedRevision !== undefined) {\n    if (!/^[a-f0-9]{64}$/.test(rawReplacedRevision)) return null;\n    replacedRevision = rawReplacedRevision;\n  }\n  const generatedBatchId = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.generatedBatchId];\n  const rawGeneratedBatchSize = attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.generatedBatchSize];\n  let generatedBatchSize: number | undefined;\n  if (generatedBatchId !== undefined) {\n    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(generatedBatchId)) {\n      return null;\n    }\n    if (\n      typeof rawGeneratedBatchSize !== \"string\" ||\n      !/^[1-8]$/.test(rawGeneratedBatchSize)\n    ) {\n      return null;\n    }\n    generatedBatchSize = Number(rawGeneratedBatchSize);\n  } else if (rawGeneratedBatchSize !== undefined) {\n    return null;\n  }\n  if (\n    !category.success ||\n    !status.success ||\n    status.data === \"superseded\" ||\n    typeof rawOrder !== \"string\" ||\n    !/^(?:0|[1-9]\\d*)$/.test(rawOrder) ||\n    !Number.isSafeInteger(order) ||\n    namespace === null ||\n    typeof owner !== \"string\" ||\n    !/^[a-f0-9]{64}$/.test(owner) ||\n    !sourceMemoryIds\n  )\n    return null;\n  const fields = SupportPassportCardSchema.omit({\n    revision: true,\n    statement: true,\n  }).safeParse({\n    cardId: frontmatter.id,\n    title: attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.title],\n    category: category.data,\n    status: status.data,\n    updatedAt: frontmatter.updated,\n    reviewBy: attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.reviewBy],\n  });\n  if (!fields.success) return null;\n  return {\n    fields: fields.data,\n    order,\n    sourceMemoryIds,\n    namespace,\n    owner,\n    replacesDraftId,\n    replacedRevision,\n    draftReplacementPrepared:\n      attributes[SUPPORT_PASSPORT_ATTRIBUTE_KEYS.draftReplacementPrepared] ===\n      \"true\",\n    generatedBatchId,\n    generatedBatchSize,\n  };\n}\n\nexport function hasLiveSupportPassportCard(memory: Pick<MemoryFile, \"frontmatter\" | \"content\">): boolean {\n  const metadata = parseSupportPassportCardMetadata(memory);\n  if (metadata?.fields.status !== \"active\" && metadata?.fields.status !== \"pending_review\") return false;\n  if (metadata.sourceMemoryIds.length === 0) return false;\n  return SupportPassportCardSchema.omit({ revision: true }).safeParse({\n    ...metadata.fields,\n    statement: stripAttributesSuffix(memory.content),\n  }).success;\n}\n\nexport function projectSupportPassportCard(\n  memory: MemoryFile,\n): StoredSupportPassportCard | null {\n  const metadata = parseSupportPassportCardMetadata(memory);\n  if (!metadata) return null;\n\n  const fields = {\n    ...metadata.fields,\n    statement: stripAttributesSuffix(memory.content),\n  };\n  const normalized = SupportPassportCardSchema.omit({\n    revision: true,\n  }).safeParse(fields);\n  if (!normalized.success) return null;\n  const parsed = SupportPassportCardSchema.safeParse({\n    ...normalized.data,\n    revision: computeSupportPassportCardRevision(normalized.data),\n  });\n  if (!parsed.success) return null;\n  return {\n    card: parsed.data,\n    memory,\n    order: metadata.order,\n    sourceMemoryIds: metadata.sourceMemoryIds,\n    namespace: metadata.namespace,\n    owner: metadata.owner,\n    replacesDraftId: metadata.replacesDraftId,\n    replacedRevision: metadata.replacedRevision,\n    draftReplacementPrepared: metadata.draftReplacementPrepared,\n    generatedBatchId: metadata.generatedBatchId,\n    generatedBatchSize: metadata.generatedBatchSize,\n  };\n}\n"],"mappings":"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","names":["createHash","createHash"]}

package/dist/{chunk-Q57GOHLF.js → chunk-EGALNSZ4.js}

@@ -1,7 +1,7 @@
 import {
   expandScopeProfileReadNamespaces,
   resolveScopeProfilePlan
-} from "./chunk-KCT36JAW.js";
+} from "./chunk-ESNFSSO4.js";
 import {
   canReadNamespace,
   canWriteNamespace,
@@ -22,7 +22,7 @@ import {
   combineNamespaces,
   lcmReadSessionIdsForNamespaces,
   resolveCodingNamespaceOverlay
-} from "./chunk-J2WC5LF4.js";
+} from "./chunk-QBC33MPY.js";
 
 // src/scopes/scope-plan.ts
 import path from "path";
@@ -204,4 +204,4 @@ export {
   resolveWritableNamespaceValue,
   resolveScopedWritableNamespaceValue
 };
-//# sourceMappingURL=chunk-Q57GOHLF.js.map
+//# sourceMappingURL=chunk-EGALNSZ4.js.map

package/dist/{chunk-DPCXDG7G.js → chunk-EH65UV2Z.js}

@@ -4,7 +4,7 @@ import {
 import {
   computeCorpusWatermarks,
   resolveCorpusNamespaceRoots
-} from "./chunk-CAMNRAJF.js";
+} from "./chunk-SZMYGDSM.js";
 
 // src/operator-doctor-corpus.ts
 var DIGEST_PREFIX_LENGTH = 12;
@@ -78,4 +78,4 @@ export {
   corpusWatermarksFromCheck,
   summarizeCorpusAndReplica
 };
-//# sourceMappingURL=chunk-DPCXDG7G.js.map
+//# sourceMappingURL=chunk-EH65UV2Z.js.map

package/dist/{chunk-KCT36JAW.js → chunk-ESNFSSO4.js}

@@ -15,7 +15,7 @@ import {
 import {
   combineNamespaces,
   stableHash
-} from "./chunk-J2WC5LF4.js";
+} from "./chunk-QBC33MPY.js";
 
 // src/namespaces/scope-profiles.ts
 import { createHash } from "crypto";
@@ -338,4 +338,4 @@ export {
   resolveScopeProfilePlan,
   expandScopeProfileReadNamespaces
 };
-//# sourceMappingURL=chunk-KCT36JAW.js.map
+//# sourceMappingURL=chunk-ESNFSSO4.js.map

package/dist/{chunk-XQ3HXAQH.js → chunk-ET2CNMLD.js}

@@ -10,12 +10,12 @@ import {
   parseEnvelope,
   seal
 } from "./chunk-A6XUJE5D.js";
-import {
-  isErrnoCode
-} from "./chunk-5UZXUTVO.js";
 import {
   RECALL_FALLBACK_DIRS
 } from "./chunk-VS2IYZRU.js";
+import {
+  isErrnoCode
+} from "./chunk-5UZXUTVO.js";
 
 // src/secure-store/secure-fs.ts
 import { createCipheriv, createDecipheriv, randomBytes, randomUUID } from "crypto";
@@ -550,4 +550,4 @@ export {
   migrateMemoryDirToEncrypted,
   decryptMemoryDirToPlaintext
 };
-//# sourceMappingURL=chunk-XQ3HXAQH.js.map
+//# sourceMappingURL=chunk-ET2CNMLD.js.map

package/dist/{chunk-TUHBYJXL.js → chunk-EWKVYCFP.js}

@@ -296,4 +296,4 @@ async function searchHarmonicRetrieval(options) {
 export {
   searchHarmonicRetrieval
 };
-//# sourceMappingURL=chunk-TUHBYJXL.js.map
+//# sourceMappingURL=chunk-EWKVYCFP.js.map

package/dist/{chunk-NPFUNWNX.js → chunk-FFUMTH27.js}

@@ -2,7 +2,7 @@ import {
   SupportPassportError,
   SupportPassportOwnerCreateGrantRequestSchema,
   getOperation
-} from "./chunk-OXRRJXPR.js";
+} from "./chunk-MUEGIKKY.js";
 
 // src/support-passport/access-http.ts
 var OWNER_ROOT = "/engram/v1/support-passport";
@@ -137,4 +137,4 @@ export {
   SUPPORT_PASSPORT_OWNER_HTTP_ROUTES,
   handleSupportPassportOwnerHttp
 };
-//# sourceMappingURL=chunk-NPFUNWNX.js.map
+//# sourceMappingURL=chunk-FFUMTH27.js.map

package/dist/{chunk-3PKAS6VL.js → chunk-GAJK3DQ5.js}

@@ -1,7 +1,7 @@
 import {
   resolveDefaultNamespaceRoot,
   resolveNamespaceStorageRoot
-} from "./chunk-F7XUD3PL.js";
+} from "./chunk-S4CDUXQY.js";
 import {
   MutationSerializer,
   withHeldFileLock
@@ -1473,4 +1473,4 @@ export {
   isNamespaceKind,
   NamespaceCatalog
 };
-//# sourceMappingURL=chunk-3PKAS6VL.js.map
+//# sourceMappingURL=chunk-GAJK3DQ5.js.map

package/dist/{chunk-DA7ITC5Z.js → chunk-GBEOUCBB.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-NOB2T2FC.js";
 import {
   parseConfig
-} from "./chunk-7WOWGRAU.js";
+} from "./chunk-AF5H7TKI.js";
 import {
   resolveObjectiveStateStoreDir,
   validateObjectiveStateSnapshot
@@ -268,4 +268,4 @@ export {
   recordResumeBundle,
   getResumeBundleStatus
 };
-//# sourceMappingURL=chunk-DA7ITC5Z.js.map
+//# sourceMappingURL=chunk-GBEOUCBB.js.map

package/dist/{chunk-UENKPWCS.js → chunk-H2IRSXZN.js}

@@ -7,10 +7,10 @@ import {
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-SEEJOGQX.js";
+} from "./chunk-QBNE55VA.js";
 import {
   StorageManager
-} from "./chunk-W2BAGGEW.js";
+} from "./chunk-2ITZ74A6.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -24,7 +24,7 @@ import {
   readProjectedGovernanceRows,
   readProjectedNativeKnowledgeRows,
   writeProjectionMetaHighWater
-} from "./chunk-5ACCD4L7.js";
+} from "./chunk-JRRQ747T.js";
 import {
   MEMORY_LIFECYCLE_EVENT_SORT_ORDER,
   buildLifecycleEventsForMemory,
@@ -41,13 +41,13 @@ import {
   memoryCurrentSelectExpressions,
   parseCurrentRow,
   parseTimelineRows
-} from "./chunk-2LWQSV6A.js";
+} from "./chunk-AL3UYZ5N.js";
 import {
   openBetterSqlite3
 } from "./chunk-RL6NEVXT.js";
 import {
   isSupportPassportPrivateMemory
-} from "./chunk-XDL5CYZN.js";
+} from "./chunk-EEOUMG3J.js";
 import {
   log
 } from "./chunk-3WCASNQZ.js";
@@ -1005,4 +1005,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-UENKPWCS.js.map
+//# sourceMappingURL=chunk-H2IRSXZN.js.map

package/dist/{chunk-CFVTRUR3.js → chunk-H6RSANGQ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-SOBJ6NEY.js";
 import {
   summarizeDisclosureTokens
-} from "./chunk-NPIBN2VL.js";
+} from "./chunk-LK4TOYPU.js";
 import {
   summarizeRetrievedMemoryProvenance
 } from "./chunk-I4WBNM3M.js";
@@ -606,4 +606,4 @@ export {
   renderRecallExplain,
   parseRecallExplainFormat
 };
-//# sourceMappingURL=chunk-CFVTRUR3.js.map
+//# sourceMappingURL=chunk-H6RSANGQ.js.map

package/dist/chunk-HVAEXYPL.js

@@ -0,0 +1,98 @@
+import {
+  coerceBooleanLike
+} from "./chunk-PQVCH2AE.js";
+
+// src/recall-state-view.ts
+var DEFAULT_RECALL_STATE_VIEWS = false;
+var CHANGE_WORDS = ["before", "after", "switch", "switches", "switched", "switching", "change", "changes", "changed", "changing"];
+function parseRecallStateViews(raw) {
+  return coerceBooleanLike(raw, "recallStateViews") === true;
+}
+function isChangeOrientedQuery(query) {
+  const lower = query.toLowerCase();
+  if (lower.includes("when did") || lower.includes("used to")) return true;
+  return CHANGE_WORDS.some((word) => {
+    const idx = lower.indexOf(word);
+    if (idx < 0) return false;
+    const before = idx === 0 || !/[a-z0-9]/.test(lower[idx - 1] ?? "");
+    const afterIdx = idx + word.length;
+    const after = afterIdx >= lower.length || !/[a-z0-9]/.test(lower[afterIdx] ?? "");
+    return before && after;
+  });
+}
+function shouldWidenSuperseded(successorId, candidateIds) {
+  return typeof successorId === "string" && successorId.length > 0 && candidateIds.has(successorId);
+}
+function formatSupersededPrefix(date, successorId) {
+  return `[superseded ${date} by ${successorId}]`;
+}
+function resultStateViewId(result) {
+  return result.id ?? result.docid ?? "";
+}
+function buildSuccessorMap(results, chains) {
+  const byPred = /* @__PURE__ */ new Map();
+  for (const chain of chains) {
+    if (chain.predecessorId && chain.successorId) {
+      byPred.set(chain.predecessorId, chain.successorId);
+    }
+  }
+  for (const result of results) {
+    const id = resultStateViewId(result);
+    if (id && result.supersededBy) byPred.set(id, result.supersededBy);
+  }
+  return byPred;
+}
+function labelFor(id, result, byPred, admittedIds) {
+  const successorId = result.supersededBy ?? byPred.get(id);
+  const isPred = shouldWidenSuperseded(successorId, admittedIds);
+  let isSucc = false;
+  for (const [predId, succId] of byPred) {
+    if (succId === id && admittedIds.has(predId)) {
+      isSucc = true;
+      break;
+    }
+  }
+  if (isPred && isSucc) return "transition";
+  if (isPred) return "historical";
+  if (isSucc) return "current";
+  return result.status === "superseded" ? "historical" : "current";
+}
+function annotateStateView(results, query, chains, options = {}) {
+  const enabled = options.enabled === true;
+  if (!enabled || !isChangeOrientedQuery(query)) return results;
+  const byPred = buildSuccessorMap(results, chains);
+  const candidateIds = /* @__PURE__ */ new Set();
+  for (const result of results) {
+    const id = resultStateViewId(result);
+    if (id) candidateIds.add(id);
+  }
+  const admitted = [];
+  for (const result of results) {
+    const id = resultStateViewId(result);
+    const successorId = result.supersededBy ?? byPred.get(id);
+    const superseded = result.status === "superseded" || Boolean(result.supersededBy) || byPred.has(id);
+    if (!superseded || shouldWidenSuperseded(successorId, candidateIds)) {
+      admitted.push(result);
+    }
+  }
+  const admittedIds = /* @__PURE__ */ new Set();
+  for (const result of admitted) {
+    const id = resultStateViewId(result);
+    if (id) admittedIds.add(id);
+  }
+  return admitted.map((result) => {
+    const id = resultStateViewId(result);
+    return { ...result, stateLabel: labelFor(id, result, byPred, admittedIds) };
+  });
+}
+
+export {
+  DEFAULT_RECALL_STATE_VIEWS,
+  parseRecallStateViews,
+  isChangeOrientedQuery,
+  shouldWidenSuperseded,
+  formatSupersededPrefix,
+  resultStateViewId,
+  annotateStateView
+};
+//# sourceMappingURL=chunk-HVAEXYPL.js.map

package/dist/chunk-HVAEXYPL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view.ts"],"sourcesContent":["/**\n * Recall state views (issue #1952).\n *\n * Config key: `recallStateViews` (default false). When false, annotateStateView\n * is identity: same array reference, no `stateLabel`. config.ts is at its\n * fileSizeGrandfather ceiling, so parseConfig wiring waits for a later PR.\n * Call `parseRecallStateViews` at the recall seam when that lands.\n *\n * Change-intent morphology lives here (do not grow intent.ts). A superseded\n * memory is admitted only when its successor is also in the candidate set.\n */\nimport { coerceBooleanLike } from \"./connectors/coerce.js\";\n\nexport type StateLabel = \"current\" | \"historical\" | \"transition\";\n\nexport interface StateViewChain {\n  predecessorId: string;\n  successorId: string;\n  supersededAt?: string;\n}\n\nexport interface StateViewResult {\n  id?: string;\n  docid?: string;\n  status?: string;\n  supersededBy?: string;\n  supersededAt?: string;\n  stateLabel?: StateLabel;\n}\n\nexport const DEFAULT_RECALL_STATE_VIEWS = false;\n\nconst CHANGE_WORDS = [\"before\", \"after\", \"switch\", \"switches\", \"switched\", \"switching\", \"change\", \"changes\", \"changed\", \"changing\"];\n\nexport function parseRecallStateViews(raw: unknown): boolean {\n  return coerceBooleanLike(raw, \"recallStateViews\") === true;\n}\n\nexport function isChangeOrientedQuery(query: string): boolean {\n  const lower = query.toLowerCase();\n  if (lower.includes(\"when did\") || lower.includes(\"used to\")) return true;\n  return CHANGE_WORDS.some((word) => {\n    const idx = lower.indexOf(word);\n    if (idx < 0) return false;\n    const before = idx === 0 || !/[a-z0-9]/.test(lower[idx - 1] ?? \"\");\n    const afterIdx = idx + word.length;\n    const after = afterIdx >= lower.length || !/[a-z0-9]/.test(lower[afterIdx] ?? \"\");\n    return before && after;\n  });\n}\n\nexport function shouldWidenSuperseded(\n  successorId: string | undefined,\n  candidateIds: ReadonlySet<string>,\n): boolean {\n  return typeof successorId === \"string\" && successorId.length > 0 && candidateIds.has(successorId);\n}\n\nexport function formatSupersededPrefix(date: string, successorId: string): string {\n  return `[superseded ${date} by ${successorId}]`;\n}\n\nexport function resultStateViewId(result: StateViewResult): string {\n  return result.id ?? result.docid ?? \"\";\n}\n\nfunction buildSuccessorMap(results: readonly StateViewResult[], chains: readonly StateViewChain[]): Map<string, string> {\n  const byPred = new Map<string, string>();\n  for (const chain of chains) {\n    if (chain.predecessorId && chain.successorId) {\n      byPred.set(chain.predecessorId, chain.successorId);\n    }\n  }\n  for (const result of results) {\n    const id = resultStateViewId(result);\n    if (id && result.supersededBy) byPred.set(id, result.supersededBy);\n  }\n  return byPred;\n}\n\nfunction labelFor(\n  id: string,\n  result: StateViewResult,\n  byPred: Map<string, string>,\n  admittedIds: ReadonlySet<string>,\n): StateLabel {\n  const successorId = result.supersededBy ?? byPred.get(id);\n  const isPred = shouldWidenSuperseded(successorId, admittedIds);\n  let isSucc = false;\n  for (const [predId, succId] of byPred) {\n    if (succId === id && admittedIds.has(predId)) {\n      isSucc = true;\n      break;\n    }\n  }\n  if (isPred && isSucc) return \"transition\";\n  if (isPred) return \"historical\";\n  if (isSucc) return \"current\";\n  return result.status === \"superseded\" ? \"historical\" : \"current\";\n}\n\nexport function annotateStateView<T extends StateViewResult>(\n  results: T[],\n  query: string,\n  chains: readonly StateViewChain[],\n  options: { enabled?: boolean } = {},\n): T[] {\n  const enabled = options.enabled === true;\n  if (!enabled || !isChangeOrientedQuery(query)) return results;\n\n  const byPred = buildSuccessorMap(results, chains);\n  const candidateIds = new Set<string>();\n  for (const result of results) {\n    const id = resultStateViewId(result);\n    if (id) candidateIds.add(id);\n  }\n\n  const admitted: T[] = [];\n  for (const result of results) {\n    const id = resultStateViewId(result);\n    const successorId = result.supersededBy ?? byPred.get(id);\n    const superseded = result.status === \"superseded\" || Boolean(result.supersededBy) || byPred.has(id);\n    if (!superseded || shouldWidenSuperseded(successorId, candidateIds)) {\n      admitted.push(result);\n    }\n  }\n\n  const admittedIds = new Set<string>();\n  for (const result of admitted) {\n    const id = resultStateViewId(result);\n    if (id) admittedIds.add(id);\n  }\n\n  return admitted.map((result) => {\n    const id = resultStateViewId(result);\n    return { ...result, stateLabel: labelFor(id, result, byPred, admittedIds) };\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-EUYWQ7TS.js → chunk-IEZ6CGTW.js}

@@ -16,7 +16,7 @@ import {
   FallbackLlmClient,
   fallbackLlmRuntimeContextFromConfig,
   gatewayTaskChainOptions
-} from "./chunk-UW5NPZJ2.js";
+} from "./chunk-JALOAKSZ.js";
 import {
   extractJsonCandidates
 } from "./chunk-RGMVMVMF.js";
@@ -690,4 +690,4 @@ ${truncatedConversation}`;
 export {
   HourlySummarizer
 };
-//# sourceMappingURL=chunk-EUYWQ7TS.js.map
+//# sourceMappingURL=chunk-IEZ6CGTW.js.map

package/dist/{chunk-3SZD4CYO.js → chunk-IGZCAHFL.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-VI637ILW.js";
 import {
   composeSalvagedEnvelope
-} from "./chunk-AHPIFKNG.js";
+} from "./chunk-N4F7ZSSG.js";
 import {
   StorageManager
-} from "./chunk-W2BAGGEW.js";
+} from "./chunk-2ITZ74A6.js";
 import {
   parseContinuityImprovementLoops
 } from "./chunk-LDXUBPMO.js";
@@ -1283,4 +1283,4 @@ export {
   defaultTierMigrationCycleBudget,
   CompoundingEngine
 };
-//# sourceMappingURL=chunk-3SZD4CYO.js.map
+//# sourceMappingURL=chunk-IGZCAHFL.js.map

package/dist/{chunk-UPFNQJC7.js → chunk-INUBU6I5.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-5JMAGU26.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-MDD2RINF.js";
+} from "./chunk-YWPLOJ7T.js";
 import {
   isSemanticConsolidationLlmOperator
 } from "./chunk-G7D6GZ5J.js";
@@ -220,4 +220,4 @@ export {
   buildExtensionsBlockForConsolidation,
   materializeAfterSemanticConsolidation
 };
-//# sourceMappingURL=chunk-UPFNQJC7.js.map
+//# sourceMappingURL=chunk-INUBU6I5.js.map

package/dist/{chunk-PMVPCZJZ.js → chunk-J2R275FN.js}

@@ -1,6 +1,6 @@
 import {
   createVersion
-} from "./chunk-UFKPQBXH.js";
+} from "./chunk-U62OK7BB.js";
 import {
   bumpMemoryCorpusVersionForDir
 } from "./chunk-XCB6QDL6.js";
@@ -12,7 +12,7 @@ import {
   repairContentAfterJournalMove,
   requestEntityCanonicalIdReconcile,
   withRawEntityPageMutation
-} from "./chunk-ZVPVTPGI.js";
+} from "./chunk-NNZFPYYX.js";
 import {
   parseExportBundle
 } from "./chunk-WEHSQBFR.js";
@@ -294,4 +294,4 @@ function mintForkId(capsuleId, originalId, now) {
 export {
   importCapsule
 };
-//# sourceMappingURL=chunk-PMVPCZJZ.js.map
+//# sourceMappingURL=chunk-J2R275FN.js.map

package/dist/{chunk-UW5NPZJ2.js → chunk-JALOAKSZ.js}

@@ -41,6 +41,16 @@ function fallbackLlmRuntimeContextFromConfig(config, overrides = {}) {
     ...overrides
   };
 }
+function isUnsupportedJsonSchemaError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (!/\b(?:400|404|422)\b/.test(message)) {
+    return false;
+  }
+  if (/(?:response[_ ]?format|json[_ ]?schema|structured[_ ]?output)/i.test(message)) {
+    return true;
+  }
+  return /\bunsupported\b[\s\S]{0,40}\b(?:schema|format)\b/i.test(message);
+}
 var PROVIDER_ALIASES = {
   "openai-codex": ["codex"],
   codex: ["openai-codex"],
@@ -97,7 +107,8 @@ var FallbackLlmClient = class {
       log.warn("fallback LLM: no models configured in gateway");
       return null;
     }
-    const runChain = async (runOptions) => {
+    const runChain = async (initialOptions) => {
+      let runOptions = initialOptions;
       let lastRejectedResponse = null;
       for (let i = 0; i < models.length; i++) {
         if (runOptions.signal?.aborted) {
@@ -127,6 +138,37 @@ var FallbackLlmClient = class {
           if (runOptions.signal?.aborted) {
             throw abortReason(runOptions.signal);
           }
+          if ((runOptions.jsonSchema || runOptions.responsesJsonSchema) && isUnsupportedJsonSchemaError(err)) {
+            log.debug(`fallback LLM: ${model.modelString} rejected native JSON schema; retrying without it`);
+            runOptions = {
+              ...runOptions,
+              jsonSchema: void 0,
+              responsesJsonSchema: void 0
+            };
+            try {
+              const result = await this.tryModel(model, messages, runOptions);
+              if (result) {
+                const response = {
+                  content: result.content,
+                  modelUsed: model.modelString,
+                  usage: result.usage
+                };
+                if (!runOptions.acceptResponse || runOptions.acceptResponse(response)) {
+                  return response;
+                }
+                lastRejectedResponse = response;
+                log.debug(`fallback LLM: ${model.modelString} unstructured retry output rejected by acceptResponse, trying next model...`);
+                continue;
+              }
+            } catch (retryError) {
+              if (runOptions.signal?.aborted) throw abortReason(runOptions.signal);
+              const retryErrorMsg = runOptions.redactProviderErrors ? "provider error details redacted" : retryError instanceof Error ? retryError.message : String(retryError);
+              log.debug(
+                `fallback LLM: ${model.modelString} unstructured retry failed (${retryErrorMsg})`
+              );
+            }
+            continue;
+          }
           const errorMsg = runOptions.redactProviderErrors ? "provider error details redacted" : err instanceof Error ? err.message : String(err);
           log.debug(`fallback LLM: ${model.modelString} failed (${errorMsg}), trying next...`);
         }
@@ -498,7 +540,17 @@ var FallbackLlmClient = class {
       }),
       ...buildChatCompletionTokenLimit(modelId, options.maxTokens ?? 4096, {
         assumeOpenAI
-      })
+      }),
+      ...options.jsonSchema ? {
+        response_format: {
+          type: "json_schema",
+          json_schema: {
+            name: options.jsonSchema.name,
+            strict: options.jsonSchema.strict ?? false,
+            schema: options.jsonSchema.schema
+          }
+        }
+      } : {}
     };
     const response = await fetch(url, {
       method: "POST",
@@ -603,13 +655,13 @@ var FallbackLlmClient = class {
         assumeOpenAI: shouldAssumeOpenAiChatCompletions(config.baseUrl)
       }),
       ...options.store === void 0 ? {} : { store: options.store },
-      ...options.responsesJsonSchema ? {
+      ...options.jsonSchema || options.responsesJsonSchema ? {
         text: {
           format: {
             type: "json_schema",
-            name: options.responsesJsonSchema.name,
-            strict: true,
-            schema: options.responsesJsonSchema.schema
+            name: (options.jsonSchema ?? options.responsesJsonSchema).name,
+            strict: options.jsonSchema?.strict ?? (options.responsesJsonSchema ? true : false),
+            schema: (options.jsonSchema ?? options.responsesJsonSchema).schema
           }
         }
       } : {}
@@ -736,4 +788,4 @@ export {
   fallbackLlmRuntimeContextFromConfig,
   FallbackLlmClient
 };
-//# sourceMappingURL=chunk-UW5NPZJ2.js.map
+//# sourceMappingURL=chunk-JALOAKSZ.js.map