@logixjs/core 0.0.1 → 1.0.0

package/dist/chunk-J3CWXIPV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/state-trait/meta.ts"],"sourcesContent":["import type { JsonValue } from '../observability/jsonValue.js'\n\nexport type TraitMeta = Readonly<{\n  readonly label?: string\n  readonly description?: string\n  readonly tags?: ReadonlyArray<string>\n  readonly group?: string\n  readonly docsUrl?: string\n  readonly cacheGroup?: string\n  /**\n   * Extension annotations: only accepts `x-*` keys (anchors for capabilities like Phantom Source / Drift Detection).\n   *\n   * Constraints:\n   * - Must be serializable (JSON values).\n   * - Must be slim (keep only a few key hints; don't stuff large objects).\n   */\n  readonly annotations?: Readonly<Record<string, JsonValue>>\n  /**\n   * Semantic hint: when the same entity (e.g. the same resourceId) has multiple inconsistent meta declarations,\n   * the one with canonical=true becomes the \"display canonical\", and others are recorded as conflicts.\n   */\n  readonly canonical?: boolean\n}>\n\nexport type TraitMetaSanitizeReport = Readonly<{\n  /**\n   * invalidInput:\n   * - Input was not a plain object (e.g. string/array/function/etc).\n   */\n  readonly invalidInput?: boolean\n  /**\n   * unknownKeys:\n   * - Top-level keys that are ignored (not part of TraitMeta, and not `x-*` legacy annotations).\n   */\n  readonly unknownKeys?: ReadonlyArray<string>\n  readonly unknownKeyCount?: number\n  /**\n   * droppedKeys:\n   * - Known keys that exist but are dropped due to invalid value type (e.g. tags is not string/array).\n   */\n  readonly droppedKeys?: ReadonlyArray<string>\n  /**\n   * droppedTagItems:\n   * - Number of non-string/empty tag items dropped during normalization.\n   */\n  readonly droppedTagItems?: number\n  /**\n   * annotations:\n   * - Only accepts `x-*` keys; invalid keys/values are dropped.\n   */\n  readonly ignoredAnnotationKeys?: ReadonlyArray<string>\n  readonly ignoredAnnotationKeyCount?: number\n  readonly droppedAnnotationKeys?: ReadonlyArray<string>\n  readonly droppedAnnotationKeyCount?: number\n  readonly droppedAnnotationValues?: number\n  readonly droppedAnnotationNonSerializable?: number\n  readonly droppedAnnotationDepthExceeded?: number\n  readonly droppedAnnotationNonFiniteNumber?: number\n}>\n\nexport type TraitMetaConflict = Readonly<{\n  readonly origin: string\n  readonly meta: TraitMeta\n}>\n\nconst uniqSortedStrings = (input: ReadonlyArray<string>): ReadonlyArray<string> => {\n  const set = new Set<string>()\n  for (const item of input) {\n    const v = item.trim()\n    if (!v) continue\n    set.add(v)\n  }\n  return Array.from(set).sort()\n}\n\nconst isPlainRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\ntype SanitizeJsonValueStats = {\n  dropped: number\n  nonSerializable: number\n  depthExceeded: number\n  nonFiniteNumber: number\n}\n\nconst sanitizeJsonValue = (input: unknown, depth: number, stats: SanitizeJsonValueStats): JsonValue | undefined => {\n  if (input === null) return null\n\n  if (typeof input === 'string') return input\n  if (typeof input === 'boolean') return input\n  if (typeof input === 'number') {\n    if (!Number.isFinite(input)) {\n      stats.dropped += 1\n      stats.nonSerializable += 1\n      stats.nonFiniteNumber += 1\n      return undefined\n    }\n    return input\n  }\n\n  if (depth >= 6) {\n    stats.dropped += 1\n    stats.depthExceeded += 1\n    return undefined\n  }\n\n  if (Array.isArray(input)) {\n    const out: Array<JsonValue> = []\n    for (const item of input) {\n      const v = sanitizeJsonValue(item, depth + 1, stats)\n      if (v !== undefined) out.push(v)\n    }\n    return out\n  }\n\n  if (isPlainRecord(input)) {\n    const keys = Object.keys(input).sort()\n    const out: Record<string, JsonValue> = {}\n    for (const key of keys) {\n      const v = sanitizeJsonValue(input[key], depth + 1, stats)\n      if (v !== undefined) out[key] = v\n    }\n    return out\n  }\n\n  stats.dropped += 1\n  stats.nonSerializable += 1\n  return undefined\n}\n\nconst pushSample = (target: Array<string>, value: string, limit: number): void => {\n  if (target.length >= limit) return\n  target.push(value)\n}\n\nexport const sanitizeWithReport = (input: unknown): Readonly<{\n  readonly meta?: TraitMeta\n  readonly report?: TraitMetaSanitizeReport\n}> => {\n  if (input === null || input === undefined) return {}\n  if (typeof input !== 'object' || Array.isArray(input)) {\n    return { report: { invalidInput: true } }\n  }\n\n  const record = input as Record<string, unknown>\n  const out: Record<string, unknown> = {}\n\n  const reportUnknownKeys: Array<string> = []\n  let unknownKeyCount = 0\n  const reportDroppedKeys: Array<string> = []\n  let droppedTagItems = 0\n\n  const reportIgnoredAnnotationKeys: Array<string> = []\n  let ignoredAnnotationKeyCount = 0\n  const reportDroppedAnnotationKeys: Array<string> = []\n  let droppedAnnotationKeyCount = 0\n  const stats: SanitizeJsonValueStats = { dropped: 0, nonSerializable: 0, depthExceeded: 0, nonFiniteNumber: 0 }\n\n  const allowed = new Set([\n    'label',\n    'description',\n    'group',\n    'docsUrl',\n    'cacheGroup',\n    'canonical',\n    'tags',\n    'annotations',\n  ])\n\n  for (const key of Object.keys(record)) {\n    if (allowed.has(key) || key.startsWith('x-')) continue\n    unknownKeyCount += 1\n    pushSample(reportUnknownKeys, key, 8)\n  }\n\n  const pickString = (key: keyof TraitMeta): void => {\n    const value = record[key as string]\n    if (typeof value !== 'string') return\n    const trimmed = value.trim()\n    if (!trimmed) return\n    out[key] = trimmed\n  }\n\n  pickString('label')\n  pickString('description')\n  pickString('group')\n  pickString('docsUrl')\n  pickString('cacheGroup')\n\n  const canonical = record.canonical\n  if (canonical !== undefined && canonical !== null && typeof canonical !== 'boolean') {\n    pushSample(reportDroppedKeys, 'canonical', 8)\n  } else if (typeof canonical === 'boolean') {\n    out.canonical = canonical\n  }\n\n  const tagsRaw = record.tags\n  if (typeof tagsRaw === 'string') {\n    const tags = uniqSortedStrings([tagsRaw])\n    if (tags.length > 0) out.tags = tags\n  } else if (Array.isArray(tagsRaw)) {\n    const raw = tagsRaw.filter((x): x is string => typeof x === 'string')\n    droppedTagItems += tagsRaw.length - raw.length\n    const tags = uniqSortedStrings(raw)\n    if (tags.length > 0) out.tags = tags\n    // count empty/whitespace tags dropped by uniqSortedStrings\n    droppedTagItems += raw.length - tags.length\n  } else if (tagsRaw !== undefined && tagsRaw !== null) {\n    pushSample(reportDroppedKeys, 'tags', 8)\n  }\n\n  const annotations: Record<string, JsonValue> = {}\n\n  // legacy: allow passing `x-*` keys at the top-level (untyped input), then normalize into `annotations`.\n  const annotationKeys = Object.keys(record)\n    .filter((k) => k.startsWith('x-'))\n    .sort()\n  for (const key of annotationKeys) {\n    const v = sanitizeJsonValue(record[key], 0, stats)\n    if (v !== undefined) {\n      annotations[key] = v\n    } else {\n      droppedAnnotationKeyCount += 1\n      pushSample(reportDroppedAnnotationKeys, key, 8)\n    }\n  }\n\n  // preferred: typed `annotations` field (only accepts `x-*` keys).\n  const annotationsRaw = record.annotations\n  if (annotationsRaw !== undefined && annotationsRaw !== null && !isPlainRecord(annotationsRaw)) {\n    pushSample(reportDroppedKeys, 'annotations', 8)\n  } else if (isPlainRecord(annotationsRaw)) {\n    const keys = Object.keys(annotationsRaw)\n      .sort()\n    for (const key of keys) {\n      if (!key.startsWith('x-')) {\n        ignoredAnnotationKeyCount += 1\n        pushSample(reportIgnoredAnnotationKeys, key, 8)\n        continue\n      }\n\n      const v = sanitizeJsonValue(annotationsRaw[key], 0, stats)\n      if (v !== undefined) {\n        annotations[key] = v\n      } else {\n        droppedAnnotationKeyCount += 1\n        pushSample(reportDroppedAnnotationKeys, key, 8)\n      }\n    }\n  }\n\n  if (Object.keys(annotations).length > 0) out.annotations = annotations\n\n  // Dropped keys for invalid string fields (only track invalid types; empty string is ignored as low-signal).\n  for (const key of ['label', 'description', 'group', 'docsUrl', 'cacheGroup'] as const) {\n    const value = record[key]\n    if (value !== undefined && value !== null && typeof value !== 'string') {\n      pushSample(reportDroppedKeys, key, 8)\n    }\n  }\n\n  const meta = Object.keys(out).length > 0 ? (out as TraitMeta) : undefined\n\n  const report: TraitMetaSanitizeReport | undefined = (() => {\n    const hasUnknownKeys = unknownKeyCount > 0\n    const hasDroppedKeys = reportDroppedKeys.length > 0\n    const hasDroppedTagItems = droppedTagItems > 0\n    const hasIgnoredAnnotationKeys = ignoredAnnotationKeyCount > 0\n    const hasDroppedAnnotations = droppedAnnotationKeyCount > 0 || stats.dropped > 0\n\n    if (\n      !hasUnknownKeys &&\n      !hasDroppedKeys &&\n      !hasDroppedTagItems &&\n      !hasIgnoredAnnotationKeys &&\n      !hasDroppedAnnotations\n    ) {\n      return undefined\n    }\n\n    return {\n      ...(hasUnknownKeys ? { unknownKeys: reportUnknownKeys, unknownKeyCount } : {}),\n      ...(hasDroppedKeys ? { droppedKeys: uniqSortedStrings(reportDroppedKeys) } : {}),\n      ...(hasDroppedTagItems ? { droppedTagItems } : {}),\n      ...(hasIgnoredAnnotationKeys\n        ? { ignoredAnnotationKeys: uniqSortedStrings(reportIgnoredAnnotationKeys), ignoredAnnotationKeyCount }\n        : {}),\n      ...(hasDroppedAnnotations\n        ? {\n            droppedAnnotationKeys: uniqSortedStrings(reportDroppedAnnotationKeys),\n            droppedAnnotationKeyCount,\n            droppedAnnotationValues: stats.dropped,\n            droppedAnnotationNonSerializable: stats.nonSerializable,\n            droppedAnnotationDepthExceeded: stats.depthExceeded,\n            droppedAnnotationNonFiniteNumber: stats.nonFiniteNumber,\n          }\n        : {}),\n    } satisfies TraitMetaSanitizeReport\n  })()\n\n  return report ? { meta, report } : { meta }\n}\n\nexport const sanitize = (input: unknown): TraitMeta | undefined => sanitizeWithReport(input).meta\n\nconst stableStringify = (meta: TraitMeta): string => {\n  const out: Record<string, unknown> = {}\n  const keys = Object.keys(meta).sort()\n  for (const k of keys) {\n    out[k] = (meta as any)[k]\n  }\n  return JSON.stringify(out)\n}\n\nexport const equals = (a: TraitMeta | undefined, b: TraitMeta | undefined): boolean => {\n  if (a === b) return true\n  if (!a || !b) return false\n  return stableStringify(a) === stableStringify(b)\n}\n\nexport type CanonicalMergeInput = Readonly<{\n  readonly meta?: TraitMeta\n  readonly origin?: string\n  readonly conflicts?: ReadonlyArray<TraitMetaConflict>\n}>\n\nexport type CanonicalMergeResult = Readonly<{\n  readonly meta?: TraitMeta\n  readonly origin?: string\n  readonly conflicts?: ReadonlyArray<TraitMetaConflict>\n}>\n\nexport const mergeCanonical = (\n  current: CanonicalMergeInput,\n  incoming: Readonly<{ readonly origin: string; readonly meta: TraitMeta }>,\n): CanonicalMergeResult => {\n  const existing = current.meta\n  if (!existing) {\n    return {\n      meta: incoming.meta,\n      origin: incoming.origin,\n      conflicts: current.conflicts,\n    }\n  }\n\n  if (equals(existing, incoming.meta)) {\n    return current\n  }\n\n  const conflicts: Array<TraitMetaConflict> = [...((current.conflicts ?? []) as ReadonlyArray<TraitMetaConflict>)]\n\n  const push = (conflict: TraitMetaConflict): void => {\n    const exists = conflicts.some((c) => c.origin === conflict.origin && equals(c.meta, conflict.meta))\n    if (!exists) conflicts.push(conflict)\n  }\n\n  const existingCanonical = existing.canonical === true\n  const incomingCanonical = incoming.meta.canonical === true\n\n  if (!existingCanonical && incomingCanonical) {\n    push({\n      origin: current.origin ?? 'unknown',\n      meta: existing,\n    })\n    return {\n      meta: incoming.meta,\n      origin: incoming.origin,\n      conflicts,\n    }\n  }\n\n  push({\n    origin: incoming.origin,\n    meta: incoming.meta,\n  })\n\n  return {\n    meta: existing,\n    origin: current.origin ?? incoming.origin,\n    conflicts,\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-K6JQW266.js

@@ -0,0 +1,42 @@
+// src/internal/runtime/core/diagnosticsBudget.ts
+var DIAGNOSTICS_BUDGET_CONTRACT_V1 = "diagnostics_budget.v1";
+var normalizePositiveInteger = (value) => {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return void 0;
+  return Math.floor(value);
+};
+var makeRunBudgetEnvelopeV1 = (args) => {
+  const maxEvents = normalizePositiveInteger(args.limits?.maxEvents);
+  const maxBytes = normalizePositiveInteger(args.limits?.maxBytes);
+  const emitted = normalizePositiveInteger(args.usage?.emitted);
+  const dropped = normalizePositiveInteger(args.usage?.dropped);
+  const downgraded = normalizePositiveInteger(args.usage?.downgraded);
+  return {
+    contract: DIAGNOSTICS_BUDGET_CONTRACT_V1,
+    domain: args.domain,
+    runId: args.runId,
+    ...maxEvents !== void 0 || maxBytes !== void 0 ? {
+      limits: {
+        ...maxEvents !== void 0 ? { maxEvents } : null,
+        ...maxBytes !== void 0 ? { maxBytes } : null
+      }
+    } : null,
+    ...emitted !== void 0 || dropped !== void 0 || downgraded !== void 0 ? {
+      usage: {
+        ...emitted !== void 0 ? { emitted } : null,
+        ...dropped !== void 0 ? { dropped } : null,
+        ...downgraded !== void 0 ? { downgraded } : null
+      }
+    } : null
+  };
+};
+var makeRunDegradeMarkerV1 = (degraded, reason) => ({
+  contract: DIAGNOSTICS_BUDGET_CONTRACT_V1,
+  degraded,
+  ...degraded && reason ? { reason } : null
+});
+
+export {
+  makeRunBudgetEnvelopeV1,
+  makeRunDegradeMarkerV1
+};
+//# sourceMappingURL=chunk-K6JQW266.js.map

package/dist/chunk-K6JQW266.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/runtime/core/diagnosticsBudget.ts"],"sourcesContent":["export const DIAGNOSTICS_BUDGET_CONTRACT_V1 = 'diagnostics_budget.v1' as const\n\nexport type RunBudgetDomain = 'process' | 'workflow' | 'flow'\n\nexport type RunBudgetEnvelopeV1 = {\n  readonly contract: typeof DIAGNOSTICS_BUDGET_CONTRACT_V1\n  readonly domain: RunBudgetDomain\n  readonly runId: string\n  readonly limits?: {\n    readonly maxEvents?: number\n    readonly maxBytes?: number\n  }\n  readonly usage?: {\n    readonly emitted?: number\n    readonly dropped?: number\n    readonly downgraded?: number\n  }\n}\n\nexport type RunDegradeReasonV1 =\n  | 'budget_exceeded'\n  | 'payload_oversized'\n  | 'payload_non_serializable'\n  | 'observer_disabled'\n  | 'sampled_out'\n  | 'unknown'\n\nexport type RunDegradeMarkerV1 = {\n  readonly contract: typeof DIAGNOSTICS_BUDGET_CONTRACT_V1\n  readonly degraded: boolean\n  readonly reason?: RunDegradeReasonV1\n}\n\nconst normalizePositiveInteger = (value: unknown): number | undefined => {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) return undefined\n  return Math.floor(value)\n}\n\nexport const makeRunBudgetEnvelopeV1 = (args: {\n  readonly domain: RunBudgetDomain\n  readonly runId: string\n  readonly limits?: {\n    readonly maxEvents?: number\n    readonly maxBytes?: number\n  }\n  readonly usage?: {\n    readonly emitted?: number\n    readonly dropped?: number\n    readonly downgraded?: number\n  }\n}): RunBudgetEnvelopeV1 => {\n  const maxEvents = normalizePositiveInteger(args.limits?.maxEvents)\n  const maxBytes = normalizePositiveInteger(args.limits?.maxBytes)\n  const emitted = normalizePositiveInteger(args.usage?.emitted)\n  const dropped = normalizePositiveInteger(args.usage?.dropped)\n  const downgraded = normalizePositiveInteger(args.usage?.downgraded)\n\n  return {\n    contract: DIAGNOSTICS_BUDGET_CONTRACT_V1,\n    domain: args.domain,\n    runId: args.runId,\n    ...((maxEvents !== undefined || maxBytes !== undefined\n      ? {\n          limits: {\n            ...(maxEvents !== undefined ? { maxEvents } : null),\n            ...(maxBytes !== undefined ? { maxBytes } : null),\n          },\n        }\n      : null) as object),\n    ...((emitted !== undefined || dropped !== undefined || downgraded !== undefined\n      ? {\n          usage: {\n            ...(emitted !== undefined ? { emitted } : null),\n            ...(dropped !== undefined ? { dropped } : null),\n            ...(downgraded !== undefined ? { downgraded } : null),\n          },\n        }\n      : null) as object),\n  } satisfies RunBudgetEnvelopeV1\n}\n\nexport const makeRunDegradeMarkerV1 = (\n  degraded: boolean,\n  reason?: RunDegradeReasonV1,\n): RunDegradeMarkerV1 => ({\n  contract: DIAGNOSTICS_BUDGET_CONTRACT_V1,\n  degraded,\n  ...(degraded && reason ? { reason } : null),\n})\n"],"mappings":";AAAO,IAAM,iCAAiC;AAiC9C,IAAM,2BAA2B,CAAC,UAAuC;AACvE,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,EAAG,QAAO;AAC9E,SAAO,KAAK,MAAM,KAAK;AACzB;AAEO,IAAM,0BAA0B,CAAC,SAYb;AACzB,QAAM,YAAY,yBAAyB,KAAK,QAAQ,SAAS;AACjE,QAAM,WAAW,yBAAyB,KAAK,QAAQ,QAAQ;AAC/D,QAAM,UAAU,yBAAyB,KAAK,OAAO,OAAO;AAC5D,QAAM,UAAU,yBAAyB,KAAK,OAAO,OAAO;AAC5D,QAAM,aAAa,yBAAyB,KAAK,OAAO,UAAU;AAElE,SAAO;AAAA,IACL,UAAU;AAAA,IACV,QAAQ,KAAK;AAAA,IACb,OAAO,KAAK;AAAA,IACZ,GAAK,cAAc,UAAa,aAAa,SACzC;AAAA,MACE,QAAQ;AAAA,QACN,GAAI,cAAc,SAAY,EAAE,UAAU,IAAI;AAAA,QAC9C,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI;AAAA,MAC9C;AAAA,IACF,IACA;AAAA,IACJ,GAAK,YAAY,UAAa,YAAY,UAAa,eAAe,SAClE;AAAA,MACE,OAAO;AAAA,QACL,GAAI,YAAY,SAAY,EAAE,QAAQ,IAAI;AAAA,QAC1C,GAAI,YAAY,SAAY,EAAE,QAAQ,IAAI;AAAA,QAC1C,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI;AAAA,MAClD;AAAA,IACF,IACA;AAAA,EACN;AACF;AAEO,IAAM,yBAAyB,CACpC,UACA,YACwB;AAAA,EACxB,UAAU;AAAA,EACV;AAAA,EACA,GAAI,YAAY,SAAS,EAAE,OAAO,IAAI;AACxC;","names":[]}

package/dist/chunk-KMZYQF6Q.js

@@ -0,0 +1,202 @@
+import {
+  compile,
+  evaluateStrictGate,
+  hasBuildQualityGrade,
+  isReadQuery,
+  isReadQueryCompiled,
+  make,
+  markRuntimeMissingBuildGrade,
+  resolveBuildGradeStrictGateDecision,
+  shouldEvaluateStrictGateAtRuntime
+} from "./chunk-PBD7BJUN.js";
+import {
+  fnv1a32,
+  stableStringify
+} from "./chunk-4MZ7BT3R.js";
+import {
+  __export
+} from "./chunk-PZ5AY32C.js";
+
+// src/ReadQuery.ts
+var ReadQuery_exports = {};
+__export(ReadQuery_exports, {
+  buildSelectorQualityReport: () => buildSelectorQualityReport2,
+  compile: () => compile2,
+  evaluateStrictGate: () => evaluateStrictGate2,
+  gradeReadQueryAtBuild: () => gradeReadQueryAtBuild2,
+  hasBuildGateFailure: () => hasBuildGateFailure2,
+  hasBuildQualityGrade: () => hasBuildQualityGrade2,
+  isReadQuery: () => isReadQuery2,
+  isReadQueryCompiled: () => isReadQueryCompiled2,
+  make: () => make2,
+  markRuntimeMissingBuildGrade: () => markRuntimeMissingBuildGrade2,
+  resolveBuildGradeStrictGateDecision: () => resolveBuildGradeStrictGateDecision2,
+  shouldEvaluateStrictGateAtRuntime: () => shouldEvaluateStrictGateAtRuntime2
+});
+
+// src/internal/runtime/core/ReadQueryBuildGate.ts
+var toVerdict = (decision) => decision.verdict;
+var toRule = (decision) => {
+  if (decision.verdict === "PASS") return void 0;
+  return decision.details.rule;
+};
+var toFallbackReason = (decision, compiled) => {
+  if (decision.verdict !== "PASS") return decision.details.fallbackReason;
+  return compiled.fallbackReason;
+};
+var gradeReadQueryAtBuild = (args) => {
+  const compiled = isReadQueryCompiled(args.input) ? args.input : compile(args.input);
+  const strictGateDecision = args.strictGate && args.strictGate.mode !== "off" ? evaluateStrictGate({
+    config: args.strictGate,
+    moduleId: args.moduleId,
+    instanceId: "build",
+    txnSeq: 0,
+    compiled
+  }) : { verdict: "PASS" };
+  const strictGateVerdict = toVerdict(strictGateDecision);
+  const strictGateRule = toRule(strictGateDecision);
+  const fallbackReason = toFallbackReason(strictGateDecision, compiled);
+  const entry = {
+    moduleId: args.moduleId,
+    selectorId: compiled.selectorId,
+    debugKey: compiled.debugKey,
+    lane: compiled.lane,
+    producer: compiled.producer,
+    readsDigest: compiled.readsDigest,
+    fallbackReason,
+    strictGateVerdict,
+    strictGateRule,
+    diagnosticCode: strictGateVerdict === "PASS" ? void 0 : "read_query::strict_gate"
+  };
+  const graded = {
+    ...compiled,
+    quality: {
+      source: "build",
+      reportId: args.reportId,
+      strictGate: {
+        evaluatedAt: "build",
+        verdict: strictGateVerdict,
+        rule: strictGateRule,
+        fallbackReason
+      }
+    }
+  };
+  return {
+    compiled: graded,
+    entry,
+    strictGateDecision
+  };
+};
+var summarizeEntries = (entries) => {
+  let staticCount = 0;
+  let dynamicCount = 0;
+  let warnCount = 0;
+  let failCount = 0;
+  const fallbackBreakdown = {};
+  for (const entry of entries) {
+    if (entry.lane === "static") {
+      staticCount += 1;
+    } else {
+      dynamicCount += 1;
+    }
+    if (entry.strictGateVerdict === "WARN") warnCount += 1;
+    if (entry.strictGateVerdict === "FAIL") failCount += 1;
+    if (entry.fallbackReason) {
+      fallbackBreakdown[entry.fallbackReason] = (fallbackBreakdown[entry.fallbackReason] ?? 0) + 1;
+    }
+  }
+  return {
+    total: entries.length,
+    staticCount,
+    dynamicCount,
+    warnCount,
+    failCount,
+    fallbackBreakdown
+  };
+};
+var makeReportId = (moduleId, entries) => {
+  const digestInput = entries.map((entry) => ({
+    selectorId: entry.selectorId,
+    lane: entry.lane,
+    producer: entry.producer,
+    fallbackReason: entry.fallbackReason,
+    strictGateVerdict: entry.strictGateVerdict,
+    strictGateRule: entry.strictGateRule,
+    readsDigest: entry.readsDigest
+  }));
+  return `rq_report_${fnv1a32(stableStringify({ moduleId, entries: digestInput }))}`;
+};
+var buildSelectorQualityReport = (args) => {
+  const gradedWithoutReportId = args.selectors.map(
+    (input) => gradeReadQueryAtBuild({
+      moduleId: args.moduleId,
+      input,
+      strictGate: args.strictGate
+    })
+  );
+  const reportId = makeReportId(
+    args.moduleId,
+    gradedWithoutReportId.map((it) => it.entry)
+  );
+  const graded = gradedWithoutReportId.map((result) => {
+    const quality = result.compiled.quality;
+    if (!quality) {
+      throw new Error("gradeReadQueryAtBuild must attach quality metadata");
+    }
+    return {
+      ...result,
+      compiled: {
+        ...result.compiled,
+        quality: {
+          ...quality,
+          reportId
+        }
+      }
+    };
+  });
+  const entries = graded.map((it) => it.entry);
+  const summary = summarizeEntries(entries);
+  const report = {
+    reportId,
+    moduleId: args.moduleId,
+    generatedAt: args.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    entries,
+    summary
+  };
+  return {
+    report,
+    graded
+  };
+};
+var hasBuildGateFailure = (report) => report.summary.failCount > 0;
+
+// src/ReadQuery.ts
+var isReadQuery2 = isReadQuery;
+var isReadQueryCompiled2 = isReadQueryCompiled;
+var hasBuildQualityGrade2 = hasBuildQualityGrade;
+var shouldEvaluateStrictGateAtRuntime2 = shouldEvaluateStrictGateAtRuntime;
+var markRuntimeMissingBuildGrade2 = markRuntimeMissingBuildGrade;
+var resolveBuildGradeStrictGateDecision2 = resolveBuildGradeStrictGateDecision;
+var make2 = make;
+var compile2 = compile;
+var evaluateStrictGate2 = evaluateStrictGate;
+var gradeReadQueryAtBuild2 = gradeReadQueryAtBuild;
+var buildSelectorQualityReport2 = buildSelectorQualityReport;
+var hasBuildGateFailure2 = hasBuildGateFailure;
+
+export {
+  isReadQuery2 as isReadQuery,
+  isReadQueryCompiled2 as isReadQueryCompiled,
+  hasBuildQualityGrade2 as hasBuildQualityGrade,
+  shouldEvaluateStrictGateAtRuntime2 as shouldEvaluateStrictGateAtRuntime,
+  markRuntimeMissingBuildGrade2 as markRuntimeMissingBuildGrade,
+  resolveBuildGradeStrictGateDecision2 as resolveBuildGradeStrictGateDecision,
+  make2 as make,
+  compile2 as compile,
+  evaluateStrictGate2 as evaluateStrictGate,
+  gradeReadQueryAtBuild2 as gradeReadQueryAtBuild,
+  buildSelectorQualityReport2 as buildSelectorQualityReport,
+  hasBuildGateFailure2 as hasBuildGateFailure,
+  ReadQuery_exports
+};
+//# sourceMappingURL=chunk-KMZYQF6Q.js.map

package/dist/chunk-KMZYQF6Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ReadQuery.ts","../src/internal/runtime/core/ReadQueryBuildGate.ts"],"sourcesContent":["import * as ReadQueryCore from './internal/runtime/core/ReadQuery.js'\nimport * as ReadQueryBuildGateCore from './internal/runtime/core/ReadQueryBuildGate.js'\n\nexport type ReadLane = ReadQueryCore.ReadLane\nexport type ReadProducer = ReadQueryCore.ReadProducer\nexport type EqualsKind = ReadQueryCore.EqualsKind\nexport type ReadsDigest = ReadQueryCore.ReadsDigest\nexport type ReadQueryStrictGateRule = ReadQueryCore.ReadQueryStrictGateRule\nexport type ReadQueryFallbackReason = ReadQueryCore.ReadQueryFallbackReason\nexport type ReadQueryQualityMeta = ReadQueryCore.ReadQueryQualityMeta\nexport type ReadQueryStrictGateGrade = ReadQueryCore.ReadQueryStrictGateGrade\n\nexport type ReadQueryStaticIr = ReadQueryCore.ReadQueryStaticIr\n\nexport type ReadQuery<S, V> = ReadQueryCore.ReadQuery<S, V>\nexport type ReadQueryCompiled<S, V> = ReadQueryCore.ReadQueryCompiled<S, V>\nexport type ReadQueryInput<S, V> = ReadQueryCore.ReadQueryInput<S, V>\nexport type ReadQueryStrictGateConfig = ReadQueryCore.ReadQueryStrictGateConfig\nexport type ReadQueryStrictGateDecision = ReadQueryCore.ReadQueryStrictGateDecision\n\nexport const isReadQuery = ReadQueryCore.isReadQuery\nexport const isReadQueryCompiled = ReadQueryCore.isReadQueryCompiled\nexport const hasBuildQualityGrade = ReadQueryCore.hasBuildQualityGrade\nexport const shouldEvaluateStrictGateAtRuntime = ReadQueryCore.shouldEvaluateStrictGateAtRuntime\nexport const markRuntimeMissingBuildGrade = ReadQueryCore.markRuntimeMissingBuildGrade\nexport const resolveBuildGradeStrictGateDecision = ReadQueryCore.resolveBuildGradeStrictGateDecision\n\nexport const make = ReadQueryCore.make\n\nexport const compile = ReadQueryCore.compile\nexport const evaluateStrictGate = ReadQueryCore.evaluateStrictGate\n\nexport type SelectorQualityEntry = ReadQueryBuildGateCore.SelectorQualityEntry\nexport type SelectorQualitySummary = ReadQueryBuildGateCore.SelectorQualitySummary\nexport type SelectorQualityReport = ReadQueryBuildGateCore.SelectorQualityReport\nexport type SelectorQualityReportResult = ReadQueryBuildGateCore.SelectorQualityReportResult\nexport type BuildReadQueryGradeResult<S, V> = ReadQueryBuildGateCore.BuildReadQueryGradeResult<S, V>\n\nexport const gradeReadQueryAtBuild = ReadQueryBuildGateCore.gradeReadQueryAtBuild\nexport const buildSelectorQualityReport = ReadQueryBuildGateCore.buildSelectorQualityReport\nexport const hasBuildGateFailure = ReadQueryBuildGateCore.hasBuildGateFailure\n","import { fnv1a32, stableStringify } from '../../digest.js'\nimport {\n  compile,\n  evaluateStrictGate,\n  isReadQueryCompiled,\n  type ReadQueryCompiled,\n  type ReadQueryFallbackReason,\n  type ReadQueryInput,\n  type ReadQueryStrictGateConfig,\n  type ReadQueryStrictGateDecision,\n  type ReadQueryStrictGateRule,\n} from './ReadQuery.js'\n\nexport interface SelectorQualityEntry {\n  readonly moduleId: string\n  readonly selectorId: string\n  readonly debugKey?: string\n  readonly lane: ReadQueryCompiled<any, any>['lane']\n  readonly producer: ReadQueryCompiled<any, any>['producer']\n  readonly readsDigest?: ReadQueryCompiled<any, any>['readsDigest']\n  readonly fallbackReason?: ReadQueryFallbackReason\n  readonly strictGateVerdict: 'PASS' | 'WARN' | 'FAIL'\n  readonly strictGateRule?: ReadQueryStrictGateRule\n  readonly diagnosticCode?: 'read_query::strict_gate'\n}\n\nexport interface SelectorQualitySummary {\n  readonly total: number\n  readonly staticCount: number\n  readonly dynamicCount: number\n  readonly warnCount: number\n  readonly failCount: number\n  readonly fallbackBreakdown: Readonly<Record<string, number>>\n}\n\nexport interface SelectorQualityReport {\n  readonly reportId: string\n  readonly moduleId: string\n  readonly generatedAt: string\n  readonly entries: ReadonlyArray<SelectorQualityEntry>\n  readonly summary: SelectorQualitySummary\n}\n\nexport interface BuildReadQueryGradeResult<S, V> {\n  readonly compiled: ReadQueryCompiled<S, V>\n  readonly entry: SelectorQualityEntry\n  readonly strictGateDecision: ReadQueryStrictGateDecision\n}\n\nconst toVerdict = (decision: ReadQueryStrictGateDecision): 'PASS' | 'WARN' | 'FAIL' => decision.verdict\n\nconst toRule = (decision: ReadQueryStrictGateDecision): ReadQueryStrictGateRule | undefined => {\n  if (decision.verdict === 'PASS') return undefined\n  return decision.details.rule\n}\n\nconst toFallbackReason = (\n  decision: ReadQueryStrictGateDecision,\n  compiled: ReadQueryCompiled<any, any>,\n): ReadQueryFallbackReason | undefined => {\n  if (decision.verdict !== 'PASS') return decision.details.fallbackReason\n  return compiled.fallbackReason\n}\n\nexport const gradeReadQueryAtBuild = <S, V>(args: {\n  readonly moduleId: string\n  readonly input: ReadQueryInput<S, V> | ReadQueryCompiled<S, V>\n  readonly strictGate?: ReadQueryStrictGateConfig\n  readonly reportId?: string\n}): BuildReadQueryGradeResult<S, V> => {\n  const compiled = isReadQueryCompiled<S, V>(args.input) ? args.input : compile(args.input)\n\n  const strictGateDecision: ReadQueryStrictGateDecision =\n    args.strictGate && args.strictGate.mode !== 'off'\n      ? evaluateStrictGate({\n          config: args.strictGate,\n          moduleId: args.moduleId,\n          instanceId: 'build',\n          txnSeq: 0,\n          compiled,\n        })\n      : { verdict: 'PASS' }\n\n  const strictGateVerdict = toVerdict(strictGateDecision)\n  const strictGateRule = toRule(strictGateDecision)\n  const fallbackReason = toFallbackReason(strictGateDecision, compiled)\n\n  const entry: SelectorQualityEntry = {\n    moduleId: args.moduleId,\n    selectorId: compiled.selectorId,\n    debugKey: compiled.debugKey,\n    lane: compiled.lane,\n    producer: compiled.producer,\n    readsDigest: compiled.readsDigest,\n    fallbackReason,\n    strictGateVerdict,\n    strictGateRule,\n    diagnosticCode: strictGateVerdict === 'PASS' ? undefined : 'read_query::strict_gate',\n  }\n\n  const graded: ReadQueryCompiled<S, V> = {\n    ...compiled,\n    quality: {\n      source: 'build',\n      reportId: args.reportId,\n      strictGate: {\n        evaluatedAt: 'build',\n        verdict: strictGateVerdict,\n        rule: strictGateRule,\n        fallbackReason,\n      },\n    },\n  }\n\n  return {\n    compiled: graded,\n    entry,\n    strictGateDecision,\n  }\n}\n\nconst summarizeEntries = (entries: ReadonlyArray<SelectorQualityEntry>): SelectorQualitySummary => {\n  let staticCount = 0\n  let dynamicCount = 0\n  let warnCount = 0\n  let failCount = 0\n  const fallbackBreakdown: Record<string, number> = {}\n\n  for (const entry of entries) {\n    if (entry.lane === 'static') {\n      staticCount += 1\n    } else {\n      dynamicCount += 1\n    }\n\n    if (entry.strictGateVerdict === 'WARN') warnCount += 1\n    if (entry.strictGateVerdict === 'FAIL') failCount += 1\n\n    if (entry.fallbackReason) {\n      fallbackBreakdown[entry.fallbackReason] = (fallbackBreakdown[entry.fallbackReason] ?? 0) + 1\n    }\n  }\n\n  return {\n    total: entries.length,\n    staticCount,\n    dynamicCount,\n    warnCount,\n    failCount,\n    fallbackBreakdown,\n  }\n}\n\nconst makeReportId = (moduleId: string, entries: ReadonlyArray<SelectorQualityEntry>): string => {\n  const digestInput = entries.map((entry) => ({\n    selectorId: entry.selectorId,\n    lane: entry.lane,\n    producer: entry.producer,\n    fallbackReason: entry.fallbackReason,\n    strictGateVerdict: entry.strictGateVerdict,\n    strictGateRule: entry.strictGateRule,\n    readsDigest: entry.readsDigest,\n  }))\n\n  return `rq_report_${fnv1a32(stableStringify({ moduleId, entries: digestInput }))}`\n}\n\nexport interface SelectorQualityReportResult {\n  readonly report: SelectorQualityReport\n  readonly graded: ReadonlyArray<BuildReadQueryGradeResult<any, any>>\n}\n\nexport const buildSelectorQualityReport = (args: {\n  readonly moduleId: string\n  readonly selectors: ReadonlyArray<ReadQueryInput<any, any> | ReadQueryCompiled<any, any>>\n  readonly strictGate?: ReadQueryStrictGateConfig\n  readonly generatedAt?: string\n}): SelectorQualityReportResult => {\n  const gradedWithoutReportId = args.selectors.map((input) =>\n    gradeReadQueryAtBuild({\n      moduleId: args.moduleId,\n      input,\n      strictGate: args.strictGate,\n    }),\n  )\n\n  const reportId = makeReportId(\n    args.moduleId,\n    gradedWithoutReportId.map((it) => it.entry),\n  )\n\n  const graded = gradedWithoutReportId.map((result) => {\n    const quality = result.compiled.quality\n    if (!quality) {\n      throw new Error('gradeReadQueryAtBuild must attach quality metadata')\n    }\n\n    return {\n      ...result,\n      compiled: {\n        ...result.compiled,\n        quality: {\n          ...quality,\n          reportId,\n        },\n      },\n    }\n  })\n\n  const entries = graded.map((it) => it.entry)\n  const summary = summarizeEntries(entries)\n\n  const report: SelectorQualityReport = {\n    reportId,\n    moduleId: args.moduleId,\n    generatedAt: args.generatedAt ?? new Date().toISOString(),\n    entries,\n    summary,\n  }\n\n  return {\n    report,\n    graded,\n  }\n}\n\nexport const hasBuildGateFailure = (report: SelectorQualityReport): boolean => report.summary.failCount > 0\n"],"mappings":"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","names":["buildSelectorQualityReport","compile","evaluateStrictGate","gradeReadQueryAtBuild","hasBuildGateFailure","hasBuildQualityGrade","isReadQuery","isReadQueryCompiled","make","markRuntimeMissingBuildGrade","resolveBuildGradeStrictGateDecision","shouldEvaluateStrictGateAtRuntime","isReadQuery","isReadQueryCompiled","hasBuildQualityGrade","shouldEvaluateStrictGateAtRuntime","markRuntimeMissingBuildGrade","resolveBuildGradeStrictGateDecision","make","compile","evaluateStrictGate","gradeReadQueryAtBuild","buildSelectorQualityReport","hasBuildGateFailure"]}

package/dist/{chunk-JWOYLO27.js → chunk-LPPZDFTD.js}

@@ -1,6 +1,8 @@
 // src/internal/runtime/core/EffectOpCore.ts
-import { Context, Effect, FiberRef } from "effect";
-var currentLinkId = FiberRef.unsafeMake(void 0);
+import { Effect, ServiceMap } from "effect";
+var currentLinkId = ServiceMap.Reference("@logixjs/core/CurrentLinkId", {
+  defaultValue: () => void 0
+});
 var makeOperationRejected = (params) => ({
   _tag: "OperationRejected",
   message: params.message,
@@ -9,17 +11,24 @@ var makeOperationRejected = (params) => ({
   linkId: params.linkId,
   details: params.details
 });
-var EffectOpMiddlewareTag = class extends Context.Tag("Logix/EffectOpMiddleware")() {
+var composeMiddlewareCache = /* @__PURE__ */ new WeakMap();
+var EffectOpMiddlewareTag = class extends ServiceMap.Service()("Logix/EffectOpMiddleware") {
 };
 var composeMiddleware = (stack) => {
-  return (op) => stack.reduceRight(
+  const cached = composeMiddlewareCache.get(stack);
+  if (cached) {
+    return cached;
+  }
+  const composed = (op) => stack.reduceRight(
     (eff, mw) => mw({ ...op, effect: eff }),
     op.effect
   );
+  composeMiddlewareCache.set(stack, composed);
+  return composed;
 };
 var runWithMiddleware = (op, stack) => {
   return Effect.gen(function* () {
-    const existing = yield* FiberRef.get(currentLinkId);
+    const existing = yield* Effect.service(currentLinkId);
     const metaLinkId = op.meta?.linkId;
     const linkId = typeof metaLinkId === "string" && metaLinkId.length > 0 ? metaLinkId : existing ?? op.id;
     const nextOp = {
@@ -30,7 +39,7 @@ var runWithMiddleware = (op, stack) => {
       }
     };
     const program = stack.length ? composeMiddleware(stack)(nextOp) : nextOp.effect;
-    return yield* Effect.locally(currentLinkId, linkId)(program);
+    return yield* Effect.provideService(program, currentLinkId, linkId);
   });
 };
 
@@ -157,11 +166,12 @@ var toJsonValueInternal = (input, options, stats, seen, depth) => {
     stats.nonSerializable += 1;
     return truncateString(String(input), options.maxStringLength, stats);
   }
-  const entries = Object.entries(input);
-  const limit = Math.min(entries.length, options.maxObjectKeys);
+  const keys = Object.keys(input).sort();
+  const limit = Math.min(keys.length, options.maxObjectKeys);
   const out = {};
   for (let i = 0; i < limit; i++) {
-    const [rawKey, rawValue] = entries[i];
+    const rawKey = keys[i];
+    const rawValue = input[rawKey];
     const key = truncateString(rawKey, options.maxStringLength, stats);
     if (rawValue === void 0) {
       stats.dropped += 1;
@@ -169,9 +179,9 @@ var toJsonValueInternal = (input, options, stats, seen, depth) => {
     }
     out[key] = toJsonValueInternal(rawValue, options, stats, seen, depth + 1);
   }
-  if (entries.length > limit) {
+  if (keys.length > limit) {
     stats.oversized += 1;
-    out.__truncatedKeys = entries.length - limit;
+    out.__truncatedKeys = keys.length - limit;
   }
   return out;
 };
@@ -238,4 +248,4 @@ export {
   composeMiddleware,
   runWithMiddleware
 };
-//# sourceMappingURL=chunk-JWOYLO27.js.map
+//# sourceMappingURL=chunk-LPPZDFTD.js.map

package/dist/chunk-LPPZDFTD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/runtime/core/EffectOpCore.ts","../src/internal/observability/jsonValue.ts"],"sourcesContent":["// EffectOp core model and middleware composition logic.\n// For higher-level Runtime / Devtools integration, see:\n// specs/000-module-traits-runtime/references/effectop-and-middleware.md\n\nimport { Effect, ServiceMap } from 'effect'\n\nexport const currentLinkId = ServiceMap.Reference<string | undefined>('@logixjs/core/CurrentLinkId', {\n  defaultValue: () => undefined,\n})\n\n/**\n * OperationPolicy：\n * - Local policy markers (intent only; no rule logic attached).\n *\n * Constraints (enforced by Runtime/middleware together):\n * - Only observation-only capabilities (Observer) may be disabled; global guards must not be disabled.\n */\nexport interface OperationPolicy {\n  readonly disableObservers?: boolean\n}\n\n/**\n * OperationRejected：\n * - Unified failure result when a guard rejects execution.\n * - Semantics: explicit failure with no business side effects (rejection must happen before user code executes).\n */\nexport interface OperationRejected {\n  readonly _tag: 'OperationRejected'\n  readonly message: string\n  readonly kind?: EffectOp['kind']\n  readonly name?: string\n  readonly linkId?: string\n  readonly details?: unknown\n}\n\n/**\n * OperationError：\n * - Any boundary operation executed via EffectOp may be explicitly rejected by Guard middleware.\n * - Therefore, the middleware error channel must allow OperationRejected to be added.\n */\nexport type OperationError<E> = E | OperationRejected\n\nexport const makeOperationRejected = (params: {\n  readonly message: string\n  readonly kind?: EffectOp['kind']\n  readonly name?: string\n  readonly linkId?: string\n  readonly details?: unknown\n}): OperationRejected => ({\n  _tag: 'OperationRejected',\n  message: params.message,\n  kind: params.kind,\n  name: params.name,\n  linkId: params.linkId,\n  details: params.details,\n})\n\n/**\n * EffectOp: a unified representation of an Effect execution at an \"observable boundary\".\n *\n * - Out / Err / Env are the generic parameters of the underlying Effect.\n * - meta carries structured context needed by Devtools / Middleware.\n */\nexport interface EffectOp<Out = unknown, Err = unknown, Env = unknown> {\n  readonly id: string\n  readonly kind:\n    | 'action'\n    | 'flow'\n    | 'state'\n    | 'service'\n    | 'lifecycle'\n    | 'trait-computed'\n    | 'trait-link'\n    | 'trait-source'\n    | 'devtools'\n  readonly name: string\n  readonly payload?: unknown\n  readonly meta?: {\n    /**\n     * linkId：\n     * - Operation chain id: multiple boundary ops in the same chain must share it.\n     * - Runtime ensures this field is populated on all boundary ops.\n     */\n    linkId?: string\n    moduleId?: string\n    instanceId?: string\n    runtimeLabel?: string\n    txnId?: string\n    txnSeq?: number\n    opSeq?: number\n    fieldPath?: string\n    deps?: ReadonlyArray<string>\n    from?: string\n    to?: string\n    traitNodeId?: string\n    stepId?: string\n    resourceId?: string\n    key?: unknown\n    trace?: ReadonlyArray<string>\n    tags?: ReadonlyArray<string>\n    policy?: OperationPolicy\n    // Reserved extension slot for middleware/devtools to attach extra information.\n    readonly [k: string]: unknown\n  }\n  readonly effect: Effect.Effect<Out, Err, Env>\n}\n\n/**\n * Middleware: the general middleware model for observing / wrapping / guarding EffectOps.\n */\nexport type Middleware = <A, E, R>(op: EffectOp<A, E, R>) => Effect.Effect<A, OperationError<E>, R>\n\nexport type MiddlewareStack = ReadonlyArray<Middleware>\n\nconst composeMiddlewareCache = new WeakMap<MiddlewareStack, Middleware>()\n\n/**\n * EffectOpMiddlewareEnv：\n * - A Service in Effect Env that carries the current Runtime's MiddlewareStack.\n * - Injected by Runtime.ts when constructing a ManagedRuntime.\n * - Runtime code (e.g. StateTrait.install) uses this Service to decide which MiddlewareStack to use.\n */\nexport interface EffectOpMiddlewareEnv {\n  readonly stack: MiddlewareStack\n}\n\nexport class EffectOpMiddlewareTag extends ServiceMap.Service<\n  EffectOpMiddlewareTag,\n  EffectOpMiddlewareEnv\n>()('Logix/EffectOpMiddleware') {}\n\n/**\n * composeMiddleware：\n * - Composes Middleware from \"outer to inner\" in declaration order:\n *   - stack = [mw1, mw2] => mw1 -> mw2 -> effect -> mw2 -> mw1\n * - Matches the reduceRight example in the reference docs.\n */\nexport const composeMiddleware = (stack: MiddlewareStack): Middleware => {\n  const cached = composeMiddlewareCache.get(stack)\n  if (cached) {\n    return cached\n  }\n\n  const composed: Middleware = <A, E, R>(op: EffectOp<A, E, R>): Effect.Effect<A, OperationError<E>, R> =>\n    stack.reduceRight<Effect.Effect<A, OperationError<E>, R>>(\n      (eff, mw) => mw({ ...op, effect: eff } as any) as any,\n      op.effect as Effect.Effect<A, OperationError<E>, R>,\n    )\n\n  composeMiddlewareCache.set(stack, composed)\n  return composed\n}\n\n/**\n * runWithMiddleware：\n * - Executes a given EffectOp with a MiddlewareStack according to the composition rules.\n * - If the stack is empty, returns op.effect directly.\n */\nexport const runWithMiddleware = <A, E, R>(op: EffectOp<A, E, R>, stack: MiddlewareStack): Effect.Effect<A, E, R> => {\n  return Effect.gen(function* () {\n    const existing = yield* Effect.service(currentLinkId)\n    const metaLinkId = (op.meta as any)?.linkId\n    const linkId = typeof metaLinkId === 'string' && metaLinkId.length > 0 ? metaLinkId : (existing ?? op.id)\n\n    const nextOp: EffectOp<A, E, R> = {\n      ...op,\n      meta: {\n        ...(op.meta ?? {}),\n        linkId,\n      },\n    }\n\n    const program = stack.length ? composeMiddleware(stack)(nextOp) : nextOp.effect\n\n    // linkId is created at the boundary root and reused for nested ops (the FiberRef is the global single source of truth).\n    // NOTE: middleware may explicitly reject with OperationRejected.\n    return yield* Effect.provideService(program as any, currentLinkId, linkId)\n  }) as Effect.Effect<A, E, R>\n}\n","export type JsonValue =\n  | null\n  | boolean\n  | number\n  | string\n  | ReadonlyArray<JsonValue>\n  | { readonly [key: string]: JsonValue }\n\nexport type DowngradeReason = 'non_serializable' | 'oversized' | 'unknown'\n\nexport const isJsonValue = (input: unknown): input is JsonValue => {\n  const seen = new WeakSet<object>()\n\n  const loop = (value: unknown, depth: number): value is JsonValue => {\n    if (depth > 64) return false\n    if (value === null) return true\n\n    switch (typeof value) {\n      case 'string':\n      case 'boolean':\n        return true\n      case 'number':\n        return Number.isFinite(value)\n      case 'object': {\n        if (Array.isArray(value)) {\n          if (seen.has(value)) return false\n          seen.add(value)\n          for (const item of value) {\n            if (!loop(item, depth + 1)) return false\n          }\n          return true\n        }\n\n        if (!isPlainRecord(value)) return false\n        if (seen.has(value)) return false\n        seen.add(value)\n\n        for (const v of Object.values(value)) {\n          if (!loop(v, depth + 1)) return false\n        }\n\n        return true\n      }\n      default:\n        return false\n    }\n  }\n\n  return loop(input, 0)\n}\n\nexport interface JsonValueProjectionStats {\n  readonly dropped: number\n  readonly oversized: number\n  readonly nonSerializable: number\n}\n\nexport interface JsonValueProjection {\n  readonly value: JsonValue\n  readonly stats: JsonValueProjectionStats\n  readonly downgrade?: DowngradeReason\n}\n\nexport interface JsonValueProjectOptions {\n  readonly maxDepth?: number\n  readonly maxObjectKeys?: number\n  readonly maxArrayLength?: number\n  readonly maxStringLength?: number\n  readonly maxJsonBytes?: number\n  readonly oversizedPreviewBytes?: number\n}\n\nconst defaultOptions: Required<JsonValueProjectOptions> = {\n  maxDepth: 6,\n  maxObjectKeys: 32,\n  maxArrayLength: 32,\n  maxStringLength: 256,\n  maxJsonBytes: 4 * 1024,\n  oversizedPreviewBytes: 256,\n}\n\nconst truncateString = (value: string, maxLen: number, stats: MutableStats): string => {\n  if (value.length <= maxLen) return value\n  stats.oversized += 1\n  return value.slice(0, maxLen)\n}\n\ntype MutableStats = {\n  dropped: number\n  oversized: number\n  nonSerializable: number\n}\n\nconst mergeDowngrade = (current: DowngradeReason | undefined, next: DowngradeReason): DowngradeReason => {\n  if (!current) return next\n  if (current === 'non_serializable' || next === 'non_serializable') return 'non_serializable'\n  if (current === 'oversized' || next === 'oversized') return 'oversized'\n  return 'unknown'\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null) return false\n  const proto = Object.getPrototypeOf(value)\n  return proto === Object.prototype || proto === null\n}\n\nconst asNumber = (value: number, stats: MutableStats): JsonValue => {\n  if (Number.isFinite(value)) return value\n  stats.nonSerializable += 1\n  return String(value)\n}\n\nconst toJsonValueInternal = (\n  input: unknown,\n  options: Required<JsonValueProjectOptions>,\n  stats: MutableStats,\n  seen: WeakSet<object>,\n  depth: number,\n): JsonValue => {\n  if (input === null) return null\n\n  switch (typeof input) {\n    case 'string':\n      return truncateString(input, options.maxStringLength, stats)\n    case 'number':\n      return asNumber(input, stats)\n    case 'boolean':\n      return input\n    case 'bigint':\n      stats.nonSerializable += 1\n      return truncateString(input.toString(), options.maxStringLength, stats)\n    case 'symbol':\n      stats.nonSerializable += 1\n      return truncateString(input.toString(), options.maxStringLength, stats)\n    case 'function':\n      stats.nonSerializable += 1\n      return '[Function]'\n    case 'undefined':\n      stats.dropped += 1\n      return null\n  }\n\n  // object\n  if (depth >= options.maxDepth) {\n    stats.oversized += 1\n    return '[Truncated]'\n  }\n\n  if (input instanceof Date) {\n    return input.toISOString()\n  }\n\n  if (input instanceof Error) {\n    stats.nonSerializable += 1\n    return {\n      name: truncateString(input.name, options.maxStringLength, stats),\n      message: truncateString(input.message, options.maxStringLength, stats),\n    }\n  }\n\n  if (typeof input === 'object') {\n    if (seen.has(input)) {\n      stats.nonSerializable += 1\n      return '[Circular]'\n    }\n    seen.add(input)\n  }\n\n  if (Array.isArray(input)) {\n    const out: Array<JsonValue> = []\n    const limit = Math.min(input.length, options.maxArrayLength)\n    for (let i = 0; i < limit; i++) {\n      out.push(toJsonValueInternal(input[i], options, stats, seen, depth + 1))\n    }\n    if (input.length > limit) {\n      stats.oversized += 1\n      out.push(`[...${input.length - limit} more]`)\n    }\n    return out\n  }\n\n  if (!isPlainRecord(input)) {\n    stats.nonSerializable += 1\n    return truncateString(String(input), options.maxStringLength, stats)\n  }\n\n  const keys = Object.keys(input).sort()\n  const limit = Math.min(keys.length, options.maxObjectKeys)\n  const out: Record<string, JsonValue> = {}\n\n  for (let i = 0; i < limit; i++) {\n    const rawKey = keys[i]!\n    const rawValue = (input as any)[rawKey]\n    const key = truncateString(rawKey, options.maxStringLength, stats)\n    if (rawValue === undefined) {\n      stats.dropped += 1\n      continue\n    }\n    out[key] = toJsonValueInternal(rawValue, options, stats, seen, depth + 1)\n  }\n\n  if (keys.length > limit) {\n    stats.oversized += 1\n    out.__truncatedKeys = keys.length - limit\n  }\n\n  return out\n}\n\nexport const projectJsonValue = (input: unknown, options?: JsonValueProjectOptions): JsonValueProjection => {\n  const resolved: Required<JsonValueProjectOptions> = { ...defaultOptions, ...(options ?? {}) }\n  const stats: MutableStats = { dropped: 0, oversized: 0, nonSerializable: 0 }\n  const seen = new WeakSet<object>()\n\n  let downgrade: DowngradeReason | undefined\n  const value = toJsonValueInternal(input, resolved, stats, seen, 0)\n\n  if (stats.nonSerializable > 0) {\n    downgrade = mergeDowngrade(downgrade, 'non_serializable')\n  }\n  if (stats.oversized > 0) {\n    downgrade = mergeDowngrade(downgrade, 'oversized')\n  }\n\n  // Hard gate: ensure JSON.stringify never throws and respect the max byte budget.\n  try {\n    const json = JSON.stringify(value)\n    if (json.length > resolved.maxJsonBytes) {\n      downgrade = mergeDowngrade(downgrade, 'oversized')\n      const preview = json.slice(0, Math.min(resolved.oversizedPreviewBytes, resolved.maxJsonBytes))\n      return {\n        value: {\n          _tag: 'oversized',\n          bytes: json.length,\n          preview,\n        },\n        stats: {\n          dropped: stats.dropped,\n          oversized: stats.oversized + 1,\n          nonSerializable: stats.nonSerializable,\n        },\n        downgrade,\n      }\n    }\n  } catch {\n    downgrade = mergeDowngrade(downgrade, 'non_serializable')\n    return {\n      value: '[Unserializable]',\n      stats: {\n        dropped: stats.dropped,\n        oversized: stats.oversized,\n        nonSerializable: stats.nonSerializable + 1,\n      },\n      downgrade,\n    }\n  }\n\n  return {\n    value,\n    stats: {\n      dropped: stats.dropped,\n      oversized: stats.oversized,\n      nonSerializable: stats.nonSerializable,\n    },\n    downgrade,\n  }\n}\n"],"mappings":"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","names":["out","limit"]}