@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/schemas/readiness.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"readiness.cjs","names":[],"sources":["../../../src/schemas/readiness.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Cordis service name for session-scoped package initialization. */\nexport const DOOM_READINESS_SERVICE = 'doom/readiness';\n\n/** Stable machine-readable failures produced by the readiness contract. */\nexport const DOOM_READINESS_ERROR_CODE = {\n  cancelled: 'DOOM_READINESS_CANCELLED',\n  disposed: 'DOOM_READINESS_DISPOSED',\n  duplicate: 'DOOM_READINESS_DUPLICATE',\n  failed: 'DOOM_READINESS_FAILED',\n  invalidArgument: 'DOOM_READINESS_INVALID_ARGUMENT',\n  unavailable: 'DOOM_READINESS_UNAVAILABLE',\n  waitAborted: 'DOOM_READINESS_WAIT_ABORTED',\n} as const;\n\nexport type DoomReadinessErrorCode = (typeof DOOM_READINESS_ERROR_CODE)[keyof typeof DOOM_READINESS_ERROR_CODE];\nexport type DoomReadinessState = 'pending' | 'ready' | 'degraded' | 'failed' | 'cancelled';\n\nexport interface DoomReadinessErrorDetail {\n  readonly code: DoomReadinessErrorCode;\n  readonly message: string;\n}\n\n/** Immutable public state for the latest generation of one package. */\nexport interface DoomReadinessSnapshot {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: DoomReadinessState;\n  readonly diagnostics: readonly string[];\n  readonly error?: DoomReadinessErrorDetail;\n}\n\nexport interface DoomReadinessTaskResult<TValue> {\n  readonly value: TValue;\n  readonly diagnostics?: readonly string[];\n}\n\nexport type DoomReadinessTask<TValue> = (signal: AbortSignal) => Promise<DoomReadinessTaskResult<TValue>>;\n\nexport interface DoomReadinessWaitOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport interface DoomReadinessHandle<TValue> {\n  readonly packageId: string;\n  readonly generation: string;\n  /** Waits for this package only. Degraded initialization still returns its value. */\n  wait(options?: DoomReadinessWaitOptions): Promise<TValue>;\n  /** Reads this handle's generation, even after a newer generation replaces it. */\n  snapshot(): DoomReadinessSnapshot;\n}\n\nexport interface DoomReadinessNotification {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: 'degraded' | 'failed';\n  readonly diagnostics: readonly string[];\n  readonly error?: DoomReadinessErrorDetail;\n}\n\nexport interface DoomReadinessCoordinatorOptions {\n  /** Called once when a task becomes degraded or failed. */\n  readonly notify?: (notification: DoomReadinessNotification) => void | Promise<void>;\n}\n\nexport interface DoomReadinessCoordinator {\n  start<TValue>(packageId: string, generation: string, task: DoomReadinessTask<TValue>): DoomReadinessHandle<TValue>;\n  /** Reads the latest generation registered for a package. */\n  read(packageId: string): DoomReadinessSnapshot | undefined;\n  /** Reads the latest generation of every registered package. */\n  snapshots(): readonly DoomReadinessSnapshot[];\n  /** Aborts pending work and waits for every started task to settle. */\n  dispose(): Promise<void>;\n}\n\ninterface ReadinessRecord {\n  readonly token: symbol;\n  readonly packageId: string;\n  readonly generation: string;\n  readonly controller: AbortController;\n  readonly terminal: Promise<void>;\n  readonly resolveTerminal: () => void;\n  operation: Promise<unknown>;\n  state: DoomReadinessState;\n  diagnostics: readonly string[];\n  error?: DoomReadinessError;\n  value?: unknown;\n  hasValue: boolean;\n  notified: boolean;\n}\n\nexport interface DoomReadinessErrorOptions {\n  readonly packageId?: string;\n  readonly generation?: string;\n  readonly cause?: unknown;\n}\n\n/** Error returned to package callers without exposing task-specific rejection shapes. */\nexport class DoomReadinessError extends Error {\n  readonly code: DoomReadinessErrorCode;\n  readonly packageId?: string;\n  readonly generation?: string;\n\n  constructor(code: DoomReadinessErrorCode, message: string, input: DoomReadinessErrorOptions = {}) {\n    super(message, input.cause === undefined ? undefined : { cause: input.cause });\n    this.name = 'DoomReadinessError';\n    this.code = code;\n    this.packageId = input.packageId;\n    this.generation = input.generation;\n  }\n}\n\nfunction createTerminal(): { readonly promise: Promise<void>; readonly resolve: () => void } {\n  let resolve = (): void => undefined;\n  const promise = new Promise<void>((settle) => {\n    resolve = settle;\n  });\n  return { promise, resolve };\n}\n\nfunction frozenDiagnostics(diagnostics: readonly string[] | undefined): readonly string[] {\n  if (diagnostics === undefined) return Object.freeze([]);\n  if (!Array.isArray(diagnostics) || diagnostics.some((diagnostic) => typeof diagnostic !== 'string')) {\n    throw new TypeError('Doom readiness task diagnostics must be an array of strings.');\n  }\n  return Object.freeze([...diagnostics]);\n}\n\nfunction errorDetail(error: DoomReadinessError | undefined): DoomReadinessErrorDetail | undefined {\n  return error === undefined ? undefined : Object.freeze({ code: error.code, message: error.message });\n}\n\nfunction recordSnapshot(record: ReadinessRecord): DoomReadinessSnapshot {\n  return Object.freeze({\n    packageId: record.packageId,\n    generation: record.generation,\n    state: record.state,\n    diagnostics: record.diagnostics,\n    ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n  });\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nfunction waitAbortedError(record: ReadinessRecord, signal: AbortSignal): DoomReadinessError {\n  return new DoomReadinessError(\n    DOOM_READINESS_ERROR_CODE.waitAborted,\n    `Waiting for Doom package '${record.packageId}' readiness was aborted.`,\n    { packageId: record.packageId, generation: record.generation, cause: signal.reason },\n  );\n}\n\nfunction waitForTerminal(record: ReadinessRecord, signal: AbortSignal | undefined): Promise<void> {\n  if (signal === undefined) return record.terminal;\n  if (signal.aborted) return Promise.reject(waitAbortedError(record, signal));\n\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = (): void => {\n      reject(waitAbortedError(record, signal));\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    void record.terminal.then(() => {\n      signal.removeEventListener('abort', onAbort);\n      resolve();\n    });\n  });\n}\n\n/** Creates the session-scoped coordinator value published through Cordis. */\nexport function createDoomReadinessCoordinator(\n  options: DoomReadinessCoordinatorOptions = {},\n): DoomReadinessCoordinator {\n  const records = new Map<string, ReadinessRecord>();\n  let disposed = false;\n  let disposal: Promise<void> | undefined;\n\n  const current = (record: ReadinessRecord): boolean =>\n    !disposed && records.get(record.packageId)?.token === record.token && record.state === 'pending';\n\n  const notify = (record: ReadinessRecord): void => {\n    if (record.notified || (record.state !== 'degraded' && record.state !== 'failed')) return;\n    record.notified = true;\n    const notification = Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      state: record.state,\n      diagnostics: record.diagnostics,\n      ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n    });\n    if (options.notify) void Promise.resolve(options.notify(notification)).catch(rethrowAsync);\n  };\n\n  const finish = (\n    record: ReadinessRecord,\n    state: Exclude<DoomReadinessState, 'pending'>,\n    input: {\n      readonly value?: unknown;\n      readonly hasValue?: boolean;\n      readonly diagnostics?: readonly string[];\n      readonly error?: DoomReadinessError;\n    } = {},\n  ): void => {\n    if (!current(record)) return;\n    record.state = state;\n    record.value = input.value;\n    record.hasValue = input.hasValue ?? false;\n    record.diagnostics = input.diagnostics ?? Object.freeze([]);\n    record.error = input.error;\n    record.resolveTerminal();\n    notify(record);\n  };\n\n  const handleFor = <TValue>(record: ReadinessRecord): DoomReadinessHandle<TValue> =>\n    Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      snapshot: () => recordSnapshot(record),\n      wait: async (waitOptions: DoomReadinessWaitOptions = {}): Promise<TValue> => {\n        await waitForTerminal(record, waitOptions.signal);\n        if (record.state === 'ready' || record.state === 'degraded') {\n          if (!record.hasValue) {\n            throw new DoomReadinessError(\n              DOOM_READINESS_ERROR_CODE.failed,\n              `Doom package '${record.packageId}' readiness completed without a value.`,\n              { packageId: record.packageId, generation: record.generation },\n            );\n          }\n          return record.value as TValue;\n        }\n        if (record.error) throw record.error;\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.failed,\n          `Doom package '${record.packageId}' readiness did not complete.`,\n          { packageId: record.packageId, generation: record.generation },\n        );\n      },\n    });\n\n  return Object.freeze({\n    start<TValue>(packageId: string, generation: string, task: DoomReadinessTask<TValue>): DoomReadinessHandle<TValue> {\n      if (disposed) {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.disposed,\n          'The Doom readiness coordinator has been disposed.',\n          { packageId, generation },\n        );\n      }\n      if (typeof packageId !== 'string' || packageId.trim().length === 0) {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.invalidArgument,\n          'Doom readiness requires a non-empty package id.',\n          { packageId, generation },\n        );\n      }\n      if (typeof generation !== 'string' || generation.trim().length === 0) {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.invalidArgument,\n          'Doom readiness requires a non-empty generation.',\n          { packageId, generation },\n        );\n      }\n      if (typeof task !== 'function') {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.invalidArgument,\n          'Doom readiness requires an initialization task.',\n          { packageId, generation },\n        );\n      }\n\n      const previous = records.get(packageId);\n      if (previous?.state === 'pending') {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.duplicate,\n          `Doom package '${packageId}' already has live readiness work.`,\n          { packageId, generation },\n        );\n      }\n\n      const terminal = createTerminal();\n      const controller = new AbortController();\n      const record: ReadinessRecord = {\n        token: Symbol(packageId),\n        packageId,\n        generation,\n        controller,\n        terminal: terminal.promise,\n        resolveTerminal: terminal.resolve,\n        operation: Promise.resolve(),\n        state: 'pending',\n        diagnostics: Object.freeze([]),\n        hasValue: false,\n        notified: false,\n      };\n      records.set(packageId, record);\n\n      const operation = Promise.resolve().then(() => {\n        if (controller.signal.aborted) throw controller.signal.reason;\n        return task(controller.signal);\n      });\n      record.operation = operation;\n      void operation\n        .then(\n          (result) => {\n            if (!current(record)) return;\n            if (result === null || typeof result !== 'object' || !Object.hasOwn(result, 'value')) {\n              finish(record, 'failed', {\n                error: new DoomReadinessError(\n                  DOOM_READINESS_ERROR_CODE.failed,\n                  `Doom package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation },\n                ),\n              });\n              return;\n            }\n            try {\n              const diagnostics = frozenDiagnostics(result.diagnostics);\n              finish(record, diagnostics.length === 0 ? 'ready' : 'degraded', {\n                value: result.value,\n                hasValue: true,\n                diagnostics,\n              });\n            } catch (error) {\n              finish(record, 'failed', {\n                error: new DoomReadinessError(\n                  DOOM_READINESS_ERROR_CODE.failed,\n                  `Doom package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation, cause: error },\n                ),\n              });\n            }\n          },\n          (error: unknown) => {\n            finish(record, 'failed', {\n              error: new DoomReadinessError(\n                DOOM_READINESS_ERROR_CODE.failed,\n                `Doom package '${packageId}' readiness failed: ${error instanceof Error ? error.message : String(error)}`,\n                { packageId, generation, cause: error },\n              ),\n            });\n          },\n        )\n        .catch(rethrowAsync);\n\n      return handleFor<TValue>(record);\n    },\n\n    read(packageId: string): DoomReadinessSnapshot | undefined {\n      const record = records.get(packageId);\n      return record === undefined ? undefined : recordSnapshot(record);\n    },\n\n    snapshots(): readonly DoomReadinessSnapshot[] {\n      return Object.freeze([...records.values()].map(recordSnapshot));\n    },\n\n    dispose(): Promise<void> {\n      if (disposal) return disposal;\n      disposed = true;\n      const operations = [...records.values()].map((record) => {\n        if (record.state === 'pending') {\n          const error = new DoomReadinessError(\n            DOOM_READINESS_ERROR_CODE.cancelled,\n            `Doom package '${record.packageId}' readiness was cancelled.`,\n            { packageId: record.packageId, generation: record.generation },\n          );\n          record.state = 'cancelled';\n          record.error = error;\n          record.resolveTerminal();\n          record.controller.abort(error);\n        }\n        return record.operation;\n      });\n      disposal = Promise.allSettled(operations).then(() => undefined);\n      return disposal;\n    },\n  });\n}\n\n/** Reads the coordinator visible to the current Cordis plugin context. */\nexport function readDoomReadinessCoordinator(ctx: Context): DoomReadinessCoordinator | undefined {\n  return ctx.get(DOOM_READINESS_SERVICE) as DoomReadinessCoordinator | undefined;\n}\n\n/** Reads the coordinator or reports that Config has not published session readiness. */\nexport function requireDoomReadinessCoordinator(ctx: Context): DoomReadinessCoordinator {\n  const coordinator = readDoomReadinessCoordinator(ctx);\n  if (coordinator) return coordinator;\n  throw new DoomReadinessError(\n    DOOM_READINESS_ERROR_CODE.unavailable,\n    'Doom readiness is unavailable. Load the Po Config core.',\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"readiness.cjs","names":[],"sources":["../../../src/schemas/readiness.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Cordis service name for session-scoped package initialization. */\nexport const PO_READINESS_SERVICE = 'po/readiness';\n\n/** Stable machine-readable failures produced by the readiness contract. */\nexport const PO_READINESS_ERROR_CODE = {\n  cancelled: 'PO_READINESS_CANCELLED',\n  disposed: 'PO_READINESS_DISPOSED',\n  duplicate: 'PO_READINESS_DUPLICATE',\n  failed: 'PO_READINESS_FAILED',\n  invalidArgument: 'PO_READINESS_INVALID_ARGUMENT',\n  unavailable: 'PO_READINESS_UNAVAILABLE',\n  waitAborted: 'PO_READINESS_WAIT_ABORTED',\n} as const;\n\nexport type PoReadinessErrorCode = (typeof PO_READINESS_ERROR_CODE)[keyof typeof PO_READINESS_ERROR_CODE];\nexport type PoReadinessState = 'pending' | 'ready' | 'degraded' | 'failed' | 'cancelled';\n\nexport interface PoReadinessErrorDetail {\n  readonly code: PoReadinessErrorCode;\n  readonly message: string;\n}\n\n/** Immutable public state for the latest generation of one package. */\nexport interface PoReadinessSnapshot {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: PoReadinessState;\n  readonly diagnostics: readonly string[];\n  readonly error?: PoReadinessErrorDetail;\n}\n\nexport interface PoReadinessTaskResult<TValue> {\n  readonly value: TValue;\n  readonly diagnostics?: readonly string[];\n}\n\nexport type PoReadinessTask<TValue> = (signal: AbortSignal) => Promise<PoReadinessTaskResult<TValue>>;\n\nexport interface PoReadinessWaitOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport interface PoReadinessHandle<TValue> {\n  readonly packageId: string;\n  readonly generation: string;\n  /** Waits for this package only. Degraded initialization still returns its value. */\n  wait(options?: PoReadinessWaitOptions): Promise<TValue>;\n  /** Reads this handle's generation, even after a newer generation replaces it. */\n  snapshot(): PoReadinessSnapshot;\n}\n\nexport interface PoReadinessNotification {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: 'degraded' | 'failed';\n  readonly diagnostics: readonly string[];\n  readonly error?: PoReadinessErrorDetail;\n}\n\nexport interface PoReadinessCoordinatorOptions {\n  /** Called once when a task becomes degraded or failed. */\n  readonly notify?: (notification: PoReadinessNotification) => void | Promise<void>;\n}\n\nexport interface PoReadinessCoordinator {\n  start<TValue>(packageId: string, generation: string, task: PoReadinessTask<TValue>): PoReadinessHandle<TValue>;\n  /** Reads the latest generation registered for a package. */\n  read(packageId: string): PoReadinessSnapshot | undefined;\n  /** Reads the latest generation of every registered package. */\n  snapshots(): readonly PoReadinessSnapshot[];\n  /** Aborts pending work and waits for every started task to settle. */\n  dispose(): Promise<void>;\n}\n\ninterface ReadinessRecord {\n  readonly token: symbol;\n  readonly packageId: string;\n  readonly generation: string;\n  readonly controller: AbortController;\n  readonly terminal: Promise<void>;\n  readonly resolveTerminal: () => void;\n  operation: Promise<unknown>;\n  state: PoReadinessState;\n  diagnostics: readonly string[];\n  error?: PoReadinessError;\n  value?: unknown;\n  hasValue: boolean;\n  notified: boolean;\n}\n\nexport interface PoReadinessErrorOptions {\n  readonly packageId?: string;\n  readonly generation?: string;\n  readonly cause?: unknown;\n}\n\n/** Error returned to package callers without exposing task-specific rejection shapes. */\nexport class PoReadinessError extends Error {\n  readonly code: PoReadinessErrorCode;\n  readonly packageId?: string;\n  readonly generation?: string;\n\n  constructor(code: PoReadinessErrorCode, message: string, input: PoReadinessErrorOptions = {}) {\n    super(message, input.cause === undefined ? undefined : { cause: input.cause });\n    this.name = 'PoReadinessError';\n    this.code = code;\n    this.packageId = input.packageId;\n    this.generation = input.generation;\n  }\n}\n\nfunction createTerminal(): { readonly promise: Promise<void>; readonly resolve: () => void } {\n  let resolve = (): void => undefined;\n  const promise = new Promise<void>((settle) => {\n    resolve = settle;\n  });\n  return { promise, resolve };\n}\n\nfunction frozenDiagnostics(diagnostics: readonly string[] | undefined): readonly string[] {\n  if (diagnostics === undefined) return Object.freeze([]);\n  if (!Array.isArray(diagnostics) || diagnostics.some((diagnostic) => typeof diagnostic !== 'string')) {\n    throw new TypeError('Po readiness task diagnostics must be an array of strings.');\n  }\n  return Object.freeze([...diagnostics]);\n}\n\nfunction errorDetail(error: PoReadinessError | undefined): PoReadinessErrorDetail | undefined {\n  return error === undefined ? undefined : Object.freeze({ code: error.code, message: error.message });\n}\n\nfunction recordSnapshot(record: ReadinessRecord): PoReadinessSnapshot {\n  return Object.freeze({\n    packageId: record.packageId,\n    generation: record.generation,\n    state: record.state,\n    diagnostics: record.diagnostics,\n    ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n  });\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nfunction waitAbortedError(record: ReadinessRecord, signal: AbortSignal): PoReadinessError {\n  return new PoReadinessError(\n    PO_READINESS_ERROR_CODE.waitAborted,\n    `Waiting for Po package '${record.packageId}' readiness was aborted.`,\n    { packageId: record.packageId, generation: record.generation, cause: signal.reason },\n  );\n}\n\nfunction waitForTerminal(record: ReadinessRecord, signal: AbortSignal | undefined): Promise<void> {\n  if (signal === undefined) return record.terminal;\n  if (signal.aborted) return Promise.reject(waitAbortedError(record, signal));\n\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = (): void => {\n      reject(waitAbortedError(record, signal));\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    void record.terminal.then(() => {\n      signal.removeEventListener('abort', onAbort);\n      resolve();\n    });\n  });\n}\n\n/** Creates the session-scoped coordinator value published through Cordis. */\nexport function createPoReadinessCoordinator(options: PoReadinessCoordinatorOptions = {}): PoReadinessCoordinator {\n  const records = new Map<string, ReadinessRecord>();\n  let disposed = false;\n  let disposal: Promise<void> | undefined;\n\n  const current = (record: ReadinessRecord): boolean =>\n    !disposed && records.get(record.packageId)?.token === record.token && record.state === 'pending';\n\n  const notify = (record: ReadinessRecord): void => {\n    if (record.notified || (record.state !== 'degraded' && record.state !== 'failed')) return;\n    record.notified = true;\n    const notification = Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      state: record.state,\n      diagnostics: record.diagnostics,\n      ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n    });\n    if (options.notify) void Promise.resolve(options.notify(notification)).catch(rethrowAsync);\n  };\n\n  const finish = (\n    record: ReadinessRecord,\n    state: Exclude<PoReadinessState, 'pending'>,\n    input: {\n      readonly value?: unknown;\n      readonly hasValue?: boolean;\n      readonly diagnostics?: readonly string[];\n      readonly error?: PoReadinessError;\n    } = {},\n  ): void => {\n    if (!current(record)) return;\n    record.state = state;\n    record.value = input.value;\n    record.hasValue = input.hasValue ?? false;\n    record.diagnostics = input.diagnostics ?? Object.freeze([]);\n    record.error = input.error;\n    record.resolveTerminal();\n    notify(record);\n  };\n\n  const handleFor = <TValue>(record: ReadinessRecord): PoReadinessHandle<TValue> =>\n    Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      snapshot: () => recordSnapshot(record),\n      wait: async (waitOptions: PoReadinessWaitOptions = {}): Promise<TValue> => {\n        await waitForTerminal(record, waitOptions.signal);\n        if (record.state === 'ready' || record.state === 'degraded') {\n          if (!record.hasValue) {\n            throw new PoReadinessError(\n              PO_READINESS_ERROR_CODE.failed,\n              `Po package '${record.packageId}' readiness completed without a value.`,\n              { packageId: record.packageId, generation: record.generation },\n            );\n          }\n          return record.value as TValue;\n        }\n        if (record.error) throw record.error;\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.failed,\n          `Po package '${record.packageId}' readiness did not complete.`,\n          { packageId: record.packageId, generation: record.generation },\n        );\n      },\n    });\n\n  return Object.freeze({\n    start<TValue>(packageId: string, generation: string, task: PoReadinessTask<TValue>): PoReadinessHandle<TValue> {\n      if (disposed) {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.disposed,\n          'The Po readiness coordinator has been disposed.',\n          { packageId, generation },\n        );\n      }\n      if (typeof packageId !== 'string' || packageId.trim().length === 0) {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.invalidArgument,\n          'Po readiness requires a non-empty package id.',\n          { packageId, generation },\n        );\n      }\n      if (typeof generation !== 'string' || generation.trim().length === 0) {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.invalidArgument,\n          'Po readiness requires a non-empty generation.',\n          { packageId, generation },\n        );\n      }\n      if (typeof task !== 'function') {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.invalidArgument,\n          'Po readiness requires an initialization task.',\n          { packageId, generation },\n        );\n      }\n\n      const previous = records.get(packageId);\n      if (previous?.state === 'pending') {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.duplicate,\n          `Po package '${packageId}' already has live readiness work.`,\n          { packageId, generation },\n        );\n      }\n\n      const terminal = createTerminal();\n      const controller = new AbortController();\n      const record: ReadinessRecord = {\n        token: Symbol(packageId),\n        packageId,\n        generation,\n        controller,\n        terminal: terminal.promise,\n        resolveTerminal: terminal.resolve,\n        operation: Promise.resolve(),\n        state: 'pending',\n        diagnostics: Object.freeze([]),\n        hasValue: false,\n        notified: false,\n      };\n      records.set(packageId, record);\n\n      const operation = Promise.resolve().then(() => {\n        if (controller.signal.aborted) throw controller.signal.reason;\n        return task(controller.signal);\n      });\n      record.operation = operation;\n      void operation\n        .then(\n          (result) => {\n            if (!current(record)) return;\n            if (result === null || typeof result !== 'object' || !Object.hasOwn(result, 'value')) {\n              finish(record, 'failed', {\n                error: new PoReadinessError(\n                  PO_READINESS_ERROR_CODE.failed,\n                  `Po package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation },\n                ),\n              });\n              return;\n            }\n            try {\n              const diagnostics = frozenDiagnostics(result.diagnostics);\n              finish(record, diagnostics.length === 0 ? 'ready' : 'degraded', {\n                value: result.value,\n                hasValue: true,\n                diagnostics,\n              });\n            } catch (error) {\n              finish(record, 'failed', {\n                error: new PoReadinessError(\n                  PO_READINESS_ERROR_CODE.failed,\n                  `Po package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation, cause: error },\n                ),\n              });\n            }\n          },\n          (error: unknown) => {\n            finish(record, 'failed', {\n              error: new PoReadinessError(\n                PO_READINESS_ERROR_CODE.failed,\n                `Po package '${packageId}' readiness failed: ${error instanceof Error ? error.message : String(error)}`,\n                { packageId, generation, cause: error },\n              ),\n            });\n          },\n        )\n        .catch(rethrowAsync);\n\n      return handleFor<TValue>(record);\n    },\n\n    read(packageId: string): PoReadinessSnapshot | undefined {\n      const record = records.get(packageId);\n      return record === undefined ? undefined : recordSnapshot(record);\n    },\n\n    snapshots(): readonly PoReadinessSnapshot[] {\n      return Object.freeze([...records.values()].map(recordSnapshot));\n    },\n\n    dispose(): Promise<void> {\n      if (disposal) return disposal;\n      disposed = true;\n      const operations = [...records.values()].map((record) => {\n        if (record.state === 'pending') {\n          const error = new PoReadinessError(\n            PO_READINESS_ERROR_CODE.cancelled,\n            `Po package '${record.packageId}' readiness was cancelled.`,\n            { packageId: record.packageId, generation: record.generation },\n          );\n          record.state = 'cancelled';\n          record.error = error;\n          record.resolveTerminal();\n          record.controller.abort(error);\n        }\n        return record.operation;\n      });\n      disposal = Promise.allSettled(operations).then(() => undefined);\n      return disposal;\n    },\n  });\n}\n\n/** Reads the coordinator visible to the current Cordis plugin context. */\nexport function readPoReadinessCoordinator(ctx: Context): PoReadinessCoordinator | undefined {\n  return ctx.get(PO_READINESS_SERVICE) as PoReadinessCoordinator | undefined;\n}\n\n/** Reads the coordinator or reports that Config has not published session readiness. */\nexport function requirePoReadinessCoordinator(ctx: Context): PoReadinessCoordinator {\n  const coordinator = readPoReadinessCoordinator(ctx);\n  if (coordinator) return coordinator;\n  throw new PoReadinessError(\n    PO_READINESS_ERROR_CODE.unavailable,\n    'Po readiness is unavailable. Load the Po Config core.',\n  );\n}\n"],"mappings":"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"}

package/dist/src/schemas/readiness.d.mts

@@ -1,84 +1,84 @@
 import { Context } from "@deepseek-ai/cordis";
 //#region src/schemas/readiness.d.ts
 /** Cordis service name for session-scoped package initialization. */
-export declare const DOOM_READINESS_SERVICE = "doom/readiness";
+export declare const PO_READINESS_SERVICE = "po/readiness";
 /** Stable machine-readable failures produced by the readiness contract. */
-export declare const DOOM_READINESS_ERROR_CODE: {
-  readonly cancelled: 'DOOM_READINESS_CANCELLED';
-  readonly disposed: 'DOOM_READINESS_DISPOSED';
-  readonly duplicate: 'DOOM_READINESS_DUPLICATE';
-  readonly failed: 'DOOM_READINESS_FAILED';
-  readonly invalidArgument: 'DOOM_READINESS_INVALID_ARGUMENT';
-  readonly unavailable: 'DOOM_READINESS_UNAVAILABLE';
-  readonly waitAborted: 'DOOM_READINESS_WAIT_ABORTED';
+export declare const PO_READINESS_ERROR_CODE: {
+  readonly cancelled: 'PO_READINESS_CANCELLED';
+  readonly disposed: 'PO_READINESS_DISPOSED';
+  readonly duplicate: 'PO_READINESS_DUPLICATE';
+  readonly failed: 'PO_READINESS_FAILED';
+  readonly invalidArgument: 'PO_READINESS_INVALID_ARGUMENT';
+  readonly unavailable: 'PO_READINESS_UNAVAILABLE';
+  readonly waitAborted: 'PO_READINESS_WAIT_ABORTED';
 };
-export type DoomReadinessErrorCode = (typeof DOOM_READINESS_ERROR_CODE)[keyof typeof DOOM_READINESS_ERROR_CODE];
-export type DoomReadinessState = 'pending' | 'ready' | 'degraded' | 'failed' | 'cancelled';
-export interface DoomReadinessErrorDetail {
-  readonly code: DoomReadinessErrorCode;
+export type PoReadinessErrorCode = (typeof PO_READINESS_ERROR_CODE)[keyof typeof PO_READINESS_ERROR_CODE];
+export type PoReadinessState = 'pending' | 'ready' | 'degraded' | 'failed' | 'cancelled';
+export interface PoReadinessErrorDetail {
+  readonly code: PoReadinessErrorCode;
   readonly message: string;
 }
 /** Immutable public state for the latest generation of one package. */
-export interface DoomReadinessSnapshot {
+export interface PoReadinessSnapshot {
   readonly packageId: string;
   readonly generation: string;
-  readonly state: DoomReadinessState;
+  readonly state: PoReadinessState;
   readonly diagnostics: readonly string[];
-  readonly error?: DoomReadinessErrorDetail;
+  readonly error?: PoReadinessErrorDetail;
 }
-export interface DoomReadinessTaskResult<TValue> {
+export interface PoReadinessTaskResult<TValue> {
   readonly value: TValue;
   readonly diagnostics?: readonly string[];
 }
-export type DoomReadinessTask<TValue> = (signal: AbortSignal) => Promise<DoomReadinessTaskResult<TValue>>;
-export interface DoomReadinessWaitOptions {
+export type PoReadinessTask<TValue> = (signal: AbortSignal) => Promise<PoReadinessTaskResult<TValue>>;
+export interface PoReadinessWaitOptions {
   readonly signal?: AbortSignal;
 }
-export interface DoomReadinessHandle<TValue> {
+export interface PoReadinessHandle<TValue> {
   readonly packageId: string;
   readonly generation: string;
   /** Waits for this package only. Degraded initialization still returns its value. */
-  wait(options?: DoomReadinessWaitOptions): Promise<TValue>;
+  wait(options?: PoReadinessWaitOptions): Promise<TValue>;
   /** Reads this handle's generation, even after a newer generation replaces it. */
-  snapshot(): DoomReadinessSnapshot;
+  snapshot(): PoReadinessSnapshot;
 }
-export interface DoomReadinessNotification {
+export interface PoReadinessNotification {
   readonly packageId: string;
   readonly generation: string;
   readonly state: 'degraded' | 'failed';
   readonly diagnostics: readonly string[];
-  readonly error?: DoomReadinessErrorDetail;
+  readonly error?: PoReadinessErrorDetail;
 }
-export interface DoomReadinessCoordinatorOptions {
+export interface PoReadinessCoordinatorOptions {
   /** Called once when a task becomes degraded or failed. */
-  readonly notify?: (notification: DoomReadinessNotification) => void | Promise<void>;
+  readonly notify?: (notification: PoReadinessNotification) => void | Promise<void>;
 }
-export interface DoomReadinessCoordinator {
-  start<TValue>(packageId: string, generation: string, task: DoomReadinessTask<TValue>): DoomReadinessHandle<TValue>;
+export interface PoReadinessCoordinator {
+  start<TValue>(packageId: string, generation: string, task: PoReadinessTask<TValue>): PoReadinessHandle<TValue>;
   /** Reads the latest generation registered for a package. */
-  read(packageId: string): DoomReadinessSnapshot | undefined;
+  read(packageId: string): PoReadinessSnapshot | undefined;
   /** Reads the latest generation of every registered package. */
-  snapshots(): readonly DoomReadinessSnapshot[];
+  snapshots(): readonly PoReadinessSnapshot[];
   /** Aborts pending work and waits for every started task to settle. */
   dispose(): Promise<void>;
 }
-export interface DoomReadinessErrorOptions {
+export interface PoReadinessErrorOptions {
   readonly packageId?: string;
   readonly generation?: string;
   readonly cause?: unknown;
 }
 /** Error returned to package callers without exposing task-specific rejection shapes. */
-export declare class DoomReadinessError extends Error {
-  readonly code: DoomReadinessErrorCode;
+export declare class PoReadinessError extends Error {
+  readonly code: PoReadinessErrorCode;
   readonly packageId?: string;
   readonly generation?: string;
-  constructor(code: DoomReadinessErrorCode, message: string, input?: DoomReadinessErrorOptions);
+  constructor(code: PoReadinessErrorCode, message: string, input?: PoReadinessErrorOptions);
 }
 /** Creates the session-scoped coordinator value published through Cordis. */
-export declare function createDoomReadinessCoordinator(options?: DoomReadinessCoordinatorOptions): DoomReadinessCoordinator;
+export declare function createPoReadinessCoordinator(options?: PoReadinessCoordinatorOptions): PoReadinessCoordinator;
 /** Reads the coordinator visible to the current Cordis plugin context. */
-export declare function readDoomReadinessCoordinator(ctx: Context): DoomReadinessCoordinator | undefined;
+export declare function readPoReadinessCoordinator(ctx: Context): PoReadinessCoordinator | undefined;
 /** Reads the coordinator or reports that Config has not published session readiness. */
-export declare function requireDoomReadinessCoordinator(ctx: Context): DoomReadinessCoordinator;
+export declare function requirePoReadinessCoordinator(ctx: Context): PoReadinessCoordinator;
 //#endregion
 //# sourceMappingURL=readiness.d.mts.map

package/dist/src/schemas/readiness.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"readiness.d.mts","names":[],"sources":["../../../src/schemas/readiness.ts"],"mappings":";;;qBAGa;;qBAGA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;;YAGU,iCAAiC,wCAAwC;YACzE;iBAEK;WACN,MAAM;WACN;;;iBAIM;WACN;WACA;WACA,OAAO;WACP;WACA,QAAQ;;iBAGF,wBAAwB;WAC9B,OAAO;WACP;;YAGC,kBAAkB,WAAW,QAAQ,gBAAgB,QAAQ,wBAAwB;iBAEhF;WACN,SAAS;;iBAGH,oBAAoB;WAC1B;WACA;;EAET,KAAK,UAAU,2BAA2B,QAAQ;;EAElD,YAAY;;iBAGG;WACN;WACA;WACA;WACA;WACA,QAAQ;;iBAGF;;WAEN,UAAU,cAAc,qCAAqC;;iBAGvD;EACf,MAAM,QAAQ,mBAAmB,oBAAoB,MAAM,kBAAkB,UAAU,oBAAoB;;EAE3G,KAAK,oBAAoB;;EAEzB,sBAAsB;;EAEtB,WAAW;;iBAmBI;WACN;WACA;WACA;;;qBAIE,2BAA2B;WAC7B,MAAM;WACN;WACA;EAET,YAAY,MAAM,wBAAwB,iBAAiB,QAAO;;;wBAsEpD,+BACd,UAAS,kCACR;;wBAgNa,6BAA6B,KAAK,UAAU;;wBAK5C,gCAAgC,KAAK,UAAU"}
+{"version":3,"file":"readiness.d.mts","names":[],"sources":["../../../src/schemas/readiness.ts"],"mappings":";;;qBAGa;;qBAGA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;;YAGU,+BAA+B,sCAAsC;YACrE;iBAEK;WACN,MAAM;WACN;;;iBAIM;WACN;WACA;WACA,OAAO;WACP;WACA,QAAQ;;iBAGF,sBAAsB;WAC5B,OAAO;WACP;;YAGC,gBAAgB,WAAW,QAAQ,gBAAgB,QAAQ,sBAAsB;iBAE5E;WACN,SAAS;;iBAGH,kBAAkB;WACxB;WACA;;EAET,KAAK,UAAU,yBAAyB,QAAQ;;EAEhD,YAAY;;iBAGG;WACN;WACA;WACA;WACA;WACA,QAAQ;;iBAGF;;WAEN,UAAU,cAAc,mCAAmC;;iBAGrD;EACf,MAAM,QAAQ,mBAAmB,oBAAoB,MAAM,gBAAgB,UAAU,kBAAkB;;EAEvG,KAAK,oBAAoB;;EAEzB,sBAAsB;;EAEtB,WAAW;;iBAmBI;WACN;WACA;WACA;;;qBAIE,yBAAyB;WAC3B,MAAM;WACN;WACA;EAET,YAAY,MAAM,sBAAsB,iBAAiB,QAAO;;;wBAsElD,6BAA6B,UAAS,gCAAqC;;wBAgN3E,2BAA2B,KAAK,UAAU;;wBAK1C,8BAA8B,KAAK,UAAU"}

package/dist/src/schemas/readiness.mjs

@@ -1,24 +1,24 @@
 //#region src/schemas/readiness.ts
 /** Cordis service name for session-scoped package initialization. */
-const DOOM_READINESS_SERVICE = "doom/readiness";
+const PO_READINESS_SERVICE = "po/readiness";
 /** Stable machine-readable failures produced by the readiness contract. */
-const DOOM_READINESS_ERROR_CODE = {
-	cancelled: "DOOM_READINESS_CANCELLED",
-	disposed: "DOOM_READINESS_DISPOSED",
-	duplicate: "DOOM_READINESS_DUPLICATE",
-	failed: "DOOM_READINESS_FAILED",
-	invalidArgument: "DOOM_READINESS_INVALID_ARGUMENT",
-	unavailable: "DOOM_READINESS_UNAVAILABLE",
-	waitAborted: "DOOM_READINESS_WAIT_ABORTED"
+const PO_READINESS_ERROR_CODE = {
+	cancelled: "PO_READINESS_CANCELLED",
+	disposed: "PO_READINESS_DISPOSED",
+	duplicate: "PO_READINESS_DUPLICATE",
+	failed: "PO_READINESS_FAILED",
+	invalidArgument: "PO_READINESS_INVALID_ARGUMENT",
+	unavailable: "PO_READINESS_UNAVAILABLE",
+	waitAborted: "PO_READINESS_WAIT_ABORTED"
 };
 /** Error returned to package callers without exposing task-specific rejection shapes. */
-var DoomReadinessError = class extends Error {
+var PoReadinessError = class extends Error {
 	code;
 	packageId;
 	generation;
 	constructor(code, message, input = {}) {
 		super(message, input.cause === void 0 ? void 0 : { cause: input.cause });
-		this.name = "DoomReadinessError";
+		this.name = "PoReadinessError";
 		this.code = code;
 		this.packageId = input.packageId;
 		this.generation = input.generation;
@@ -35,7 +35,7 @@ function createTerminal() {
 }
 function frozenDiagnostics(diagnostics) {
 	if (diagnostics === void 0) return Object.freeze([]);
-	if (!Array.isArray(diagnostics) || diagnostics.some((diagnostic) => typeof diagnostic !== "string")) throw new TypeError("Doom readiness task diagnostics must be an array of strings.");
+	if (!Array.isArray(diagnostics) || diagnostics.some((diagnostic) => typeof diagnostic !== "string")) throw new TypeError("Po readiness task diagnostics must be an array of strings.");
 	return Object.freeze([...diagnostics]);
 }
 function errorDetail(error) {
@@ -59,7 +59,7 @@ function rethrowAsync(error) {
 	});
 }
 function waitAbortedError(record, signal) {
-	return new DoomReadinessError(DOOM_READINESS_ERROR_CODE.waitAborted, `Waiting for Doom package '${record.packageId}' readiness was aborted.`, {
+	return new PoReadinessError(PO_READINESS_ERROR_CODE.waitAborted, `Waiting for Po package '${record.packageId}' readiness was aborted.`, {
 		packageId: record.packageId,
 		generation: record.generation,
 		cause: signal.reason
@@ -80,7 +80,7 @@ function waitForTerminal(record, signal) {
 	});
 }
 /** Creates the session-scoped coordinator value published through Cordis. */
-function createDoomReadinessCoordinator(options = {}) {
+function createPoReadinessCoordinator(options = {}) {
 	const records = /* @__PURE__ */ new Map();
 	let disposed = false;
 	let disposal;
@@ -114,14 +114,14 @@ function createDoomReadinessCoordinator(options = {}) {
 		wait: async (waitOptions = {}) => {
 			await waitForTerminal(record, waitOptions.signal);
 			if (record.state === "ready" || record.state === "degraded") {
-				if (!record.hasValue) throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.failed, `Doom package '${record.packageId}' readiness completed without a value.`, {
+				if (!record.hasValue) throw new PoReadinessError(PO_READINESS_ERROR_CODE.failed, `Po package '${record.packageId}' readiness completed without a value.`, {
 					packageId: record.packageId,
 					generation: record.generation
 				});
 				return record.value;
 			}
 			if (record.error) throw record.error;
-			throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.failed, `Doom package '${record.packageId}' readiness did not complete.`, {
+			throw new PoReadinessError(PO_READINESS_ERROR_CODE.failed, `Po package '${record.packageId}' readiness did not complete.`, {
 				packageId: record.packageId,
 				generation: record.generation
 			});
@@ -129,23 +129,23 @@ function createDoomReadinessCoordinator(options = {}) {
 	});
 	return Object.freeze({
 		start(packageId, generation, task) {
-			if (disposed) throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.disposed, "The Doom readiness coordinator has been disposed.", {
+			if (disposed) throw new PoReadinessError(PO_READINESS_ERROR_CODE.disposed, "The Po readiness coordinator has been disposed.", {
 				packageId,
 				generation
 			});
-			if (typeof packageId !== "string" || packageId.trim().length === 0) throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.invalidArgument, "Doom readiness requires a non-empty package id.", {
+			if (typeof packageId !== "string" || packageId.trim().length === 0) throw new PoReadinessError(PO_READINESS_ERROR_CODE.invalidArgument, "Po readiness requires a non-empty package id.", {
 				packageId,
 				generation
 			});
-			if (typeof generation !== "string" || generation.trim().length === 0) throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.invalidArgument, "Doom readiness requires a non-empty generation.", {
+			if (typeof generation !== "string" || generation.trim().length === 0) throw new PoReadinessError(PO_READINESS_ERROR_CODE.invalidArgument, "Po readiness requires a non-empty generation.", {
 				packageId,
 				generation
 			});
-			if (typeof task !== "function") throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.invalidArgument, "Doom readiness requires an initialization task.", {
+			if (typeof task !== "function") throw new PoReadinessError(PO_READINESS_ERROR_CODE.invalidArgument, "Po readiness requires an initialization task.", {
 				packageId,
 				generation
 			});
-			if (records.get(packageId)?.state === "pending") throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.duplicate, `Doom package '${packageId}' already has live readiness work.`, {
+			if (records.get(packageId)?.state === "pending") throw new PoReadinessError(PO_READINESS_ERROR_CODE.duplicate, `Po package '${packageId}' already has live readiness work.`, {
 				packageId,
 				generation
 			});
@@ -173,7 +173,7 @@ function createDoomReadinessCoordinator(options = {}) {
 			operation.then((result) => {
 				if (!current(record)) return;
 				if (result === null || typeof result !== "object" || !Object.hasOwn(result, "value")) {
-					finish(record, "failed", { error: new DoomReadinessError(DOOM_READINESS_ERROR_CODE.failed, `Doom package '${packageId}' returned an invalid readiness result.`, {
+					finish(record, "failed", { error: new PoReadinessError(PO_READINESS_ERROR_CODE.failed, `Po package '${packageId}' returned an invalid readiness result.`, {
 						packageId,
 						generation
 					}) });
@@ -187,14 +187,14 @@ function createDoomReadinessCoordinator(options = {}) {
 						diagnostics
 					});
 				} catch (error) {
-					finish(record, "failed", { error: new DoomReadinessError(DOOM_READINESS_ERROR_CODE.failed, `Doom package '${packageId}' returned an invalid readiness result.`, {
+					finish(record, "failed", { error: new PoReadinessError(PO_READINESS_ERROR_CODE.failed, `Po package '${packageId}' returned an invalid readiness result.`, {
 						packageId,
 						generation,
 						cause: error
 					}) });
 				}
 			}, (error) => {
-				finish(record, "failed", { error: new DoomReadinessError(DOOM_READINESS_ERROR_CODE.failed, `Doom package '${packageId}' readiness failed: ${error instanceof Error ? error.message : String(error)}`, {
+				finish(record, "failed", { error: new PoReadinessError(PO_READINESS_ERROR_CODE.failed, `Po package '${packageId}' readiness failed: ${error instanceof Error ? error.message : String(error)}`, {
 					packageId,
 					generation,
 					cause: error
@@ -214,7 +214,7 @@ function createDoomReadinessCoordinator(options = {}) {
 			disposed = true;
 			const operations = [...records.values()].map((record) => {
 				if (record.state === "pending") {
-					const error = new DoomReadinessError(DOOM_READINESS_ERROR_CODE.cancelled, `Doom package '${record.packageId}' readiness was cancelled.`, {
+					const error = new PoReadinessError(PO_READINESS_ERROR_CODE.cancelled, `Po package '${record.packageId}' readiness was cancelled.`, {
 						packageId: record.packageId,
 						generation: record.generation
 					});
@@ -231,16 +231,16 @@ function createDoomReadinessCoordinator(options = {}) {
 	});
 }
 /** Reads the coordinator visible to the current Cordis plugin context. */
-function readDoomReadinessCoordinator(ctx) {
-	return ctx.get(DOOM_READINESS_SERVICE);
+function readPoReadinessCoordinator(ctx) {
+	return ctx.get(PO_READINESS_SERVICE);
 }
 /** Reads the coordinator or reports that Config has not published session readiness. */
-function requireDoomReadinessCoordinator(ctx) {
-	const coordinator = readDoomReadinessCoordinator(ctx);
+function requirePoReadinessCoordinator(ctx) {
+	const coordinator = readPoReadinessCoordinator(ctx);
 	if (coordinator) return coordinator;
-	throw new DoomReadinessError(DOOM_READINESS_ERROR_CODE.unavailable, "Doom readiness is unavailable. Load the Po Config core.");
+	throw new PoReadinessError(PO_READINESS_ERROR_CODE.unavailable, "Po readiness is unavailable. Load the Po Config core.");
 }
 //#endregion
-export { DOOM_READINESS_ERROR_CODE, DOOM_READINESS_SERVICE, DoomReadinessError, createDoomReadinessCoordinator, readDoomReadinessCoordinator, requireDoomReadinessCoordinator };
+export { PO_READINESS_ERROR_CODE, PO_READINESS_SERVICE, PoReadinessError, createPoReadinessCoordinator, readPoReadinessCoordinator, requirePoReadinessCoordinator };
 
 //# sourceMappingURL=readiness.mjs.map

package/dist/src/schemas/readiness.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"readiness.mjs","names":[],"sources":["../../../src/schemas/readiness.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Cordis service name for session-scoped package initialization. */\nexport const DOOM_READINESS_SERVICE = 'doom/readiness';\n\n/** Stable machine-readable failures produced by the readiness contract. */\nexport const DOOM_READINESS_ERROR_CODE = {\n  cancelled: 'DOOM_READINESS_CANCELLED',\n  disposed: 'DOOM_READINESS_DISPOSED',\n  duplicate: 'DOOM_READINESS_DUPLICATE',\n  failed: 'DOOM_READINESS_FAILED',\n  invalidArgument: 'DOOM_READINESS_INVALID_ARGUMENT',\n  unavailable: 'DOOM_READINESS_UNAVAILABLE',\n  waitAborted: 'DOOM_READINESS_WAIT_ABORTED',\n} as const;\n\nexport type DoomReadinessErrorCode = (typeof DOOM_READINESS_ERROR_CODE)[keyof typeof DOOM_READINESS_ERROR_CODE];\nexport type DoomReadinessState = 'pending' | 'ready' | 'degraded' | 'failed' | 'cancelled';\n\nexport interface DoomReadinessErrorDetail {\n  readonly code: DoomReadinessErrorCode;\n  readonly message: string;\n}\n\n/** Immutable public state for the latest generation of one package. */\nexport interface DoomReadinessSnapshot {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: DoomReadinessState;\n  readonly diagnostics: readonly string[];\n  readonly error?: DoomReadinessErrorDetail;\n}\n\nexport interface DoomReadinessTaskResult<TValue> {\n  readonly value: TValue;\n  readonly diagnostics?: readonly string[];\n}\n\nexport type DoomReadinessTask<TValue> = (signal: AbortSignal) => Promise<DoomReadinessTaskResult<TValue>>;\n\nexport interface DoomReadinessWaitOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport interface DoomReadinessHandle<TValue> {\n  readonly packageId: string;\n  readonly generation: string;\n  /** Waits for this package only. Degraded initialization still returns its value. */\n  wait(options?: DoomReadinessWaitOptions): Promise<TValue>;\n  /** Reads this handle's generation, even after a newer generation replaces it. */\n  snapshot(): DoomReadinessSnapshot;\n}\n\nexport interface DoomReadinessNotification {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: 'degraded' | 'failed';\n  readonly diagnostics: readonly string[];\n  readonly error?: DoomReadinessErrorDetail;\n}\n\nexport interface DoomReadinessCoordinatorOptions {\n  /** Called once when a task becomes degraded or failed. */\n  readonly notify?: (notification: DoomReadinessNotification) => void | Promise<void>;\n}\n\nexport interface DoomReadinessCoordinator {\n  start<TValue>(packageId: string, generation: string, task: DoomReadinessTask<TValue>): DoomReadinessHandle<TValue>;\n  /** Reads the latest generation registered for a package. */\n  read(packageId: string): DoomReadinessSnapshot | undefined;\n  /** Reads the latest generation of every registered package. */\n  snapshots(): readonly DoomReadinessSnapshot[];\n  /** Aborts pending work and waits for every started task to settle. */\n  dispose(): Promise<void>;\n}\n\ninterface ReadinessRecord {\n  readonly token: symbol;\n  readonly packageId: string;\n  readonly generation: string;\n  readonly controller: AbortController;\n  readonly terminal: Promise<void>;\n  readonly resolveTerminal: () => void;\n  operation: Promise<unknown>;\n  state: DoomReadinessState;\n  diagnostics: readonly string[];\n  error?: DoomReadinessError;\n  value?: unknown;\n  hasValue: boolean;\n  notified: boolean;\n}\n\nexport interface DoomReadinessErrorOptions {\n  readonly packageId?: string;\n  readonly generation?: string;\n  readonly cause?: unknown;\n}\n\n/** Error returned to package callers without exposing task-specific rejection shapes. */\nexport class DoomReadinessError extends Error {\n  readonly code: DoomReadinessErrorCode;\n  readonly packageId?: string;\n  readonly generation?: string;\n\n  constructor(code: DoomReadinessErrorCode, message: string, input: DoomReadinessErrorOptions = {}) {\n    super(message, input.cause === undefined ? undefined : { cause: input.cause });\n    this.name = 'DoomReadinessError';\n    this.code = code;\n    this.packageId = input.packageId;\n    this.generation = input.generation;\n  }\n}\n\nfunction createTerminal(): { readonly promise: Promise<void>; readonly resolve: () => void } {\n  let resolve = (): void => undefined;\n  const promise = new Promise<void>((settle) => {\n    resolve = settle;\n  });\n  return { promise, resolve };\n}\n\nfunction frozenDiagnostics(diagnostics: readonly string[] | undefined): readonly string[] {\n  if (diagnostics === undefined) return Object.freeze([]);\n  if (!Array.isArray(diagnostics) || diagnostics.some((diagnostic) => typeof diagnostic !== 'string')) {\n    throw new TypeError('Doom readiness task diagnostics must be an array of strings.');\n  }\n  return Object.freeze([...diagnostics]);\n}\n\nfunction errorDetail(error: DoomReadinessError | undefined): DoomReadinessErrorDetail | undefined {\n  return error === undefined ? undefined : Object.freeze({ code: error.code, message: error.message });\n}\n\nfunction recordSnapshot(record: ReadinessRecord): DoomReadinessSnapshot {\n  return Object.freeze({\n    packageId: record.packageId,\n    generation: record.generation,\n    state: record.state,\n    diagnostics: record.diagnostics,\n    ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n  });\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nfunction waitAbortedError(record: ReadinessRecord, signal: AbortSignal): DoomReadinessError {\n  return new DoomReadinessError(\n    DOOM_READINESS_ERROR_CODE.waitAborted,\n    `Waiting for Doom package '${record.packageId}' readiness was aborted.`,\n    { packageId: record.packageId, generation: record.generation, cause: signal.reason },\n  );\n}\n\nfunction waitForTerminal(record: ReadinessRecord, signal: AbortSignal | undefined): Promise<void> {\n  if (signal === undefined) return record.terminal;\n  if (signal.aborted) return Promise.reject(waitAbortedError(record, signal));\n\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = (): void => {\n      reject(waitAbortedError(record, signal));\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    void record.terminal.then(() => {\n      signal.removeEventListener('abort', onAbort);\n      resolve();\n    });\n  });\n}\n\n/** Creates the session-scoped coordinator value published through Cordis. */\nexport function createDoomReadinessCoordinator(\n  options: DoomReadinessCoordinatorOptions = {},\n): DoomReadinessCoordinator {\n  const records = new Map<string, ReadinessRecord>();\n  let disposed = false;\n  let disposal: Promise<void> | undefined;\n\n  const current = (record: ReadinessRecord): boolean =>\n    !disposed && records.get(record.packageId)?.token === record.token && record.state === 'pending';\n\n  const notify = (record: ReadinessRecord): void => {\n    if (record.notified || (record.state !== 'degraded' && record.state !== 'failed')) return;\n    record.notified = true;\n    const notification = Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      state: record.state,\n      diagnostics: record.diagnostics,\n      ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n    });\n    if (options.notify) void Promise.resolve(options.notify(notification)).catch(rethrowAsync);\n  };\n\n  const finish = (\n    record: ReadinessRecord,\n    state: Exclude<DoomReadinessState, 'pending'>,\n    input: {\n      readonly value?: unknown;\n      readonly hasValue?: boolean;\n      readonly diagnostics?: readonly string[];\n      readonly error?: DoomReadinessError;\n    } = {},\n  ): void => {\n    if (!current(record)) return;\n    record.state = state;\n    record.value = input.value;\n    record.hasValue = input.hasValue ?? false;\n    record.diagnostics = input.diagnostics ?? Object.freeze([]);\n    record.error = input.error;\n    record.resolveTerminal();\n    notify(record);\n  };\n\n  const handleFor = <TValue>(record: ReadinessRecord): DoomReadinessHandle<TValue> =>\n    Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      snapshot: () => recordSnapshot(record),\n      wait: async (waitOptions: DoomReadinessWaitOptions = {}): Promise<TValue> => {\n        await waitForTerminal(record, waitOptions.signal);\n        if (record.state === 'ready' || record.state === 'degraded') {\n          if (!record.hasValue) {\n            throw new DoomReadinessError(\n              DOOM_READINESS_ERROR_CODE.failed,\n              `Doom package '${record.packageId}' readiness completed without a value.`,\n              { packageId: record.packageId, generation: record.generation },\n            );\n          }\n          return record.value as TValue;\n        }\n        if (record.error) throw record.error;\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.failed,\n          `Doom package '${record.packageId}' readiness did not complete.`,\n          { packageId: record.packageId, generation: record.generation },\n        );\n      },\n    });\n\n  return Object.freeze({\n    start<TValue>(packageId: string, generation: string, task: DoomReadinessTask<TValue>): DoomReadinessHandle<TValue> {\n      if (disposed) {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.disposed,\n          'The Doom readiness coordinator has been disposed.',\n          { packageId, generation },\n        );\n      }\n      if (typeof packageId !== 'string' || packageId.trim().length === 0) {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.invalidArgument,\n          'Doom readiness requires a non-empty package id.',\n          { packageId, generation },\n        );\n      }\n      if (typeof generation !== 'string' || generation.trim().length === 0) {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.invalidArgument,\n          'Doom readiness requires a non-empty generation.',\n          { packageId, generation },\n        );\n      }\n      if (typeof task !== 'function') {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.invalidArgument,\n          'Doom readiness requires an initialization task.',\n          { packageId, generation },\n        );\n      }\n\n      const previous = records.get(packageId);\n      if (previous?.state === 'pending') {\n        throw new DoomReadinessError(\n          DOOM_READINESS_ERROR_CODE.duplicate,\n          `Doom package '${packageId}' already has live readiness work.`,\n          { packageId, generation },\n        );\n      }\n\n      const terminal = createTerminal();\n      const controller = new AbortController();\n      const record: ReadinessRecord = {\n        token: Symbol(packageId),\n        packageId,\n        generation,\n        controller,\n        terminal: terminal.promise,\n        resolveTerminal: terminal.resolve,\n        operation: Promise.resolve(),\n        state: 'pending',\n        diagnostics: Object.freeze([]),\n        hasValue: false,\n        notified: false,\n      };\n      records.set(packageId, record);\n\n      const operation = Promise.resolve().then(() => {\n        if (controller.signal.aborted) throw controller.signal.reason;\n        return task(controller.signal);\n      });\n      record.operation = operation;\n      void operation\n        .then(\n          (result) => {\n            if (!current(record)) return;\n            if (result === null || typeof result !== 'object' || !Object.hasOwn(result, 'value')) {\n              finish(record, 'failed', {\n                error: new DoomReadinessError(\n                  DOOM_READINESS_ERROR_CODE.failed,\n                  `Doom package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation },\n                ),\n              });\n              return;\n            }\n            try {\n              const diagnostics = frozenDiagnostics(result.diagnostics);\n              finish(record, diagnostics.length === 0 ? 'ready' : 'degraded', {\n                value: result.value,\n                hasValue: true,\n                diagnostics,\n              });\n            } catch (error) {\n              finish(record, 'failed', {\n                error: new DoomReadinessError(\n                  DOOM_READINESS_ERROR_CODE.failed,\n                  `Doom package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation, cause: error },\n                ),\n              });\n            }\n          },\n          (error: unknown) => {\n            finish(record, 'failed', {\n              error: new DoomReadinessError(\n                DOOM_READINESS_ERROR_CODE.failed,\n                `Doom package '${packageId}' readiness failed: ${error instanceof Error ? error.message : String(error)}`,\n                { packageId, generation, cause: error },\n              ),\n            });\n          },\n        )\n        .catch(rethrowAsync);\n\n      return handleFor<TValue>(record);\n    },\n\n    read(packageId: string): DoomReadinessSnapshot | undefined {\n      const record = records.get(packageId);\n      return record === undefined ? undefined : recordSnapshot(record);\n    },\n\n    snapshots(): readonly DoomReadinessSnapshot[] {\n      return Object.freeze([...records.values()].map(recordSnapshot));\n    },\n\n    dispose(): Promise<void> {\n      if (disposal) return disposal;\n      disposed = true;\n      const operations = [...records.values()].map((record) => {\n        if (record.state === 'pending') {\n          const error = new DoomReadinessError(\n            DOOM_READINESS_ERROR_CODE.cancelled,\n            `Doom package '${record.packageId}' readiness was cancelled.`,\n            { packageId: record.packageId, generation: record.generation },\n          );\n          record.state = 'cancelled';\n          record.error = error;\n          record.resolveTerminal();\n          record.controller.abort(error);\n        }\n        return record.operation;\n      });\n      disposal = Promise.allSettled(operations).then(() => undefined);\n      return disposal;\n    },\n  });\n}\n\n/** Reads the coordinator visible to the current Cordis plugin context. */\nexport function readDoomReadinessCoordinator(ctx: Context): DoomReadinessCoordinator | undefined {\n  return ctx.get(DOOM_READINESS_SERVICE) as DoomReadinessCoordinator | undefined;\n}\n\n/** Reads the coordinator or reports that Config has not published session readiness. */\nexport function requireDoomReadinessCoordinator(ctx: Context): DoomReadinessCoordinator {\n  const coordinator = readDoomReadinessCoordinator(ctx);\n  if (coordinator) return coordinator;\n  throw new DoomReadinessError(\n    DOOM_READINESS_ERROR_CODE.unavailable,\n    'Doom readiness is unavailable. Load the Po Config core.',\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"readiness.mjs","names":[],"sources":["../../../src/schemas/readiness.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Cordis service name for session-scoped package initialization. */\nexport const PO_READINESS_SERVICE = 'po/readiness';\n\n/** Stable machine-readable failures produced by the readiness contract. */\nexport const PO_READINESS_ERROR_CODE = {\n  cancelled: 'PO_READINESS_CANCELLED',\n  disposed: 'PO_READINESS_DISPOSED',\n  duplicate: 'PO_READINESS_DUPLICATE',\n  failed: 'PO_READINESS_FAILED',\n  invalidArgument: 'PO_READINESS_INVALID_ARGUMENT',\n  unavailable: 'PO_READINESS_UNAVAILABLE',\n  waitAborted: 'PO_READINESS_WAIT_ABORTED',\n} as const;\n\nexport type PoReadinessErrorCode = (typeof PO_READINESS_ERROR_CODE)[keyof typeof PO_READINESS_ERROR_CODE];\nexport type PoReadinessState = 'pending' | 'ready' | 'degraded' | 'failed' | 'cancelled';\n\nexport interface PoReadinessErrorDetail {\n  readonly code: PoReadinessErrorCode;\n  readonly message: string;\n}\n\n/** Immutable public state for the latest generation of one package. */\nexport interface PoReadinessSnapshot {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: PoReadinessState;\n  readonly diagnostics: readonly string[];\n  readonly error?: PoReadinessErrorDetail;\n}\n\nexport interface PoReadinessTaskResult<TValue> {\n  readonly value: TValue;\n  readonly diagnostics?: readonly string[];\n}\n\nexport type PoReadinessTask<TValue> = (signal: AbortSignal) => Promise<PoReadinessTaskResult<TValue>>;\n\nexport interface PoReadinessWaitOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport interface PoReadinessHandle<TValue> {\n  readonly packageId: string;\n  readonly generation: string;\n  /** Waits for this package only. Degraded initialization still returns its value. */\n  wait(options?: PoReadinessWaitOptions): Promise<TValue>;\n  /** Reads this handle's generation, even after a newer generation replaces it. */\n  snapshot(): PoReadinessSnapshot;\n}\n\nexport interface PoReadinessNotification {\n  readonly packageId: string;\n  readonly generation: string;\n  readonly state: 'degraded' | 'failed';\n  readonly diagnostics: readonly string[];\n  readonly error?: PoReadinessErrorDetail;\n}\n\nexport interface PoReadinessCoordinatorOptions {\n  /** Called once when a task becomes degraded or failed. */\n  readonly notify?: (notification: PoReadinessNotification) => void | Promise<void>;\n}\n\nexport interface PoReadinessCoordinator {\n  start<TValue>(packageId: string, generation: string, task: PoReadinessTask<TValue>): PoReadinessHandle<TValue>;\n  /** Reads the latest generation registered for a package. */\n  read(packageId: string): PoReadinessSnapshot | undefined;\n  /** Reads the latest generation of every registered package. */\n  snapshots(): readonly PoReadinessSnapshot[];\n  /** Aborts pending work and waits for every started task to settle. */\n  dispose(): Promise<void>;\n}\n\ninterface ReadinessRecord {\n  readonly token: symbol;\n  readonly packageId: string;\n  readonly generation: string;\n  readonly controller: AbortController;\n  readonly terminal: Promise<void>;\n  readonly resolveTerminal: () => void;\n  operation: Promise<unknown>;\n  state: PoReadinessState;\n  diagnostics: readonly string[];\n  error?: PoReadinessError;\n  value?: unknown;\n  hasValue: boolean;\n  notified: boolean;\n}\n\nexport interface PoReadinessErrorOptions {\n  readonly packageId?: string;\n  readonly generation?: string;\n  readonly cause?: unknown;\n}\n\n/** Error returned to package callers without exposing task-specific rejection shapes. */\nexport class PoReadinessError extends Error {\n  readonly code: PoReadinessErrorCode;\n  readonly packageId?: string;\n  readonly generation?: string;\n\n  constructor(code: PoReadinessErrorCode, message: string, input: PoReadinessErrorOptions = {}) {\n    super(message, input.cause === undefined ? undefined : { cause: input.cause });\n    this.name = 'PoReadinessError';\n    this.code = code;\n    this.packageId = input.packageId;\n    this.generation = input.generation;\n  }\n}\n\nfunction createTerminal(): { readonly promise: Promise<void>; readonly resolve: () => void } {\n  let resolve = (): void => undefined;\n  const promise = new Promise<void>((settle) => {\n    resolve = settle;\n  });\n  return { promise, resolve };\n}\n\nfunction frozenDiagnostics(diagnostics: readonly string[] | undefined): readonly string[] {\n  if (diagnostics === undefined) return Object.freeze([]);\n  if (!Array.isArray(diagnostics) || diagnostics.some((diagnostic) => typeof diagnostic !== 'string')) {\n    throw new TypeError('Po readiness task diagnostics must be an array of strings.');\n  }\n  return Object.freeze([...diagnostics]);\n}\n\nfunction errorDetail(error: PoReadinessError | undefined): PoReadinessErrorDetail | undefined {\n  return error === undefined ? undefined : Object.freeze({ code: error.code, message: error.message });\n}\n\nfunction recordSnapshot(record: ReadinessRecord): PoReadinessSnapshot {\n  return Object.freeze({\n    packageId: record.packageId,\n    generation: record.generation,\n    state: record.state,\n    diagnostics: record.diagnostics,\n    ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n  });\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nfunction waitAbortedError(record: ReadinessRecord, signal: AbortSignal): PoReadinessError {\n  return new PoReadinessError(\n    PO_READINESS_ERROR_CODE.waitAborted,\n    `Waiting for Po package '${record.packageId}' readiness was aborted.`,\n    { packageId: record.packageId, generation: record.generation, cause: signal.reason },\n  );\n}\n\nfunction waitForTerminal(record: ReadinessRecord, signal: AbortSignal | undefined): Promise<void> {\n  if (signal === undefined) return record.terminal;\n  if (signal.aborted) return Promise.reject(waitAbortedError(record, signal));\n\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = (): void => {\n      reject(waitAbortedError(record, signal));\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    void record.terminal.then(() => {\n      signal.removeEventListener('abort', onAbort);\n      resolve();\n    });\n  });\n}\n\n/** Creates the session-scoped coordinator value published through Cordis. */\nexport function createPoReadinessCoordinator(options: PoReadinessCoordinatorOptions = {}): PoReadinessCoordinator {\n  const records = new Map<string, ReadinessRecord>();\n  let disposed = false;\n  let disposal: Promise<void> | undefined;\n\n  const current = (record: ReadinessRecord): boolean =>\n    !disposed && records.get(record.packageId)?.token === record.token && record.state === 'pending';\n\n  const notify = (record: ReadinessRecord): void => {\n    if (record.notified || (record.state !== 'degraded' && record.state !== 'failed')) return;\n    record.notified = true;\n    const notification = Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      state: record.state,\n      diagnostics: record.diagnostics,\n      ...(record.error === undefined ? {} : { error: errorDetail(record.error) }),\n    });\n    if (options.notify) void Promise.resolve(options.notify(notification)).catch(rethrowAsync);\n  };\n\n  const finish = (\n    record: ReadinessRecord,\n    state: Exclude<PoReadinessState, 'pending'>,\n    input: {\n      readonly value?: unknown;\n      readonly hasValue?: boolean;\n      readonly diagnostics?: readonly string[];\n      readonly error?: PoReadinessError;\n    } = {},\n  ): void => {\n    if (!current(record)) return;\n    record.state = state;\n    record.value = input.value;\n    record.hasValue = input.hasValue ?? false;\n    record.diagnostics = input.diagnostics ?? Object.freeze([]);\n    record.error = input.error;\n    record.resolveTerminal();\n    notify(record);\n  };\n\n  const handleFor = <TValue>(record: ReadinessRecord): PoReadinessHandle<TValue> =>\n    Object.freeze({\n      packageId: record.packageId,\n      generation: record.generation,\n      snapshot: () => recordSnapshot(record),\n      wait: async (waitOptions: PoReadinessWaitOptions = {}): Promise<TValue> => {\n        await waitForTerminal(record, waitOptions.signal);\n        if (record.state === 'ready' || record.state === 'degraded') {\n          if (!record.hasValue) {\n            throw new PoReadinessError(\n              PO_READINESS_ERROR_CODE.failed,\n              `Po package '${record.packageId}' readiness completed without a value.`,\n              { packageId: record.packageId, generation: record.generation },\n            );\n          }\n          return record.value as TValue;\n        }\n        if (record.error) throw record.error;\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.failed,\n          `Po package '${record.packageId}' readiness did not complete.`,\n          { packageId: record.packageId, generation: record.generation },\n        );\n      },\n    });\n\n  return Object.freeze({\n    start<TValue>(packageId: string, generation: string, task: PoReadinessTask<TValue>): PoReadinessHandle<TValue> {\n      if (disposed) {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.disposed,\n          'The Po readiness coordinator has been disposed.',\n          { packageId, generation },\n        );\n      }\n      if (typeof packageId !== 'string' || packageId.trim().length === 0) {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.invalidArgument,\n          'Po readiness requires a non-empty package id.',\n          { packageId, generation },\n        );\n      }\n      if (typeof generation !== 'string' || generation.trim().length === 0) {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.invalidArgument,\n          'Po readiness requires a non-empty generation.',\n          { packageId, generation },\n        );\n      }\n      if (typeof task !== 'function') {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.invalidArgument,\n          'Po readiness requires an initialization task.',\n          { packageId, generation },\n        );\n      }\n\n      const previous = records.get(packageId);\n      if (previous?.state === 'pending') {\n        throw new PoReadinessError(\n          PO_READINESS_ERROR_CODE.duplicate,\n          `Po package '${packageId}' already has live readiness work.`,\n          { packageId, generation },\n        );\n      }\n\n      const terminal = createTerminal();\n      const controller = new AbortController();\n      const record: ReadinessRecord = {\n        token: Symbol(packageId),\n        packageId,\n        generation,\n        controller,\n        terminal: terminal.promise,\n        resolveTerminal: terminal.resolve,\n        operation: Promise.resolve(),\n        state: 'pending',\n        diagnostics: Object.freeze([]),\n        hasValue: false,\n        notified: false,\n      };\n      records.set(packageId, record);\n\n      const operation = Promise.resolve().then(() => {\n        if (controller.signal.aborted) throw controller.signal.reason;\n        return task(controller.signal);\n      });\n      record.operation = operation;\n      void operation\n        .then(\n          (result) => {\n            if (!current(record)) return;\n            if (result === null || typeof result !== 'object' || !Object.hasOwn(result, 'value')) {\n              finish(record, 'failed', {\n                error: new PoReadinessError(\n                  PO_READINESS_ERROR_CODE.failed,\n                  `Po package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation },\n                ),\n              });\n              return;\n            }\n            try {\n              const diagnostics = frozenDiagnostics(result.diagnostics);\n              finish(record, diagnostics.length === 0 ? 'ready' : 'degraded', {\n                value: result.value,\n                hasValue: true,\n                diagnostics,\n              });\n            } catch (error) {\n              finish(record, 'failed', {\n                error: new PoReadinessError(\n                  PO_READINESS_ERROR_CODE.failed,\n                  `Po package '${packageId}' returned an invalid readiness result.`,\n                  { packageId, generation, cause: error },\n                ),\n              });\n            }\n          },\n          (error: unknown) => {\n            finish(record, 'failed', {\n              error: new PoReadinessError(\n                PO_READINESS_ERROR_CODE.failed,\n                `Po package '${packageId}' readiness failed: ${error instanceof Error ? error.message : String(error)}`,\n                { packageId, generation, cause: error },\n              ),\n            });\n          },\n        )\n        .catch(rethrowAsync);\n\n      return handleFor<TValue>(record);\n    },\n\n    read(packageId: string): PoReadinessSnapshot | undefined {\n      const record = records.get(packageId);\n      return record === undefined ? undefined : recordSnapshot(record);\n    },\n\n    snapshots(): readonly PoReadinessSnapshot[] {\n      return Object.freeze([...records.values()].map(recordSnapshot));\n    },\n\n    dispose(): Promise<void> {\n      if (disposal) return disposal;\n      disposed = true;\n      const operations = [...records.values()].map((record) => {\n        if (record.state === 'pending') {\n          const error = new PoReadinessError(\n            PO_READINESS_ERROR_CODE.cancelled,\n            `Po package '${record.packageId}' readiness was cancelled.`,\n            { packageId: record.packageId, generation: record.generation },\n          );\n          record.state = 'cancelled';\n          record.error = error;\n          record.resolveTerminal();\n          record.controller.abort(error);\n        }\n        return record.operation;\n      });\n      disposal = Promise.allSettled(operations).then(() => undefined);\n      return disposal;\n    },\n  });\n}\n\n/** Reads the coordinator visible to the current Cordis plugin context. */\nexport function readPoReadinessCoordinator(ctx: Context): PoReadinessCoordinator | undefined {\n  return ctx.get(PO_READINESS_SERVICE) as PoReadinessCoordinator | undefined;\n}\n\n/** Reads the coordinator or reports that Config has not published session readiness. */\nexport function requirePoReadinessCoordinator(ctx: Context): PoReadinessCoordinator {\n  const coordinator = readPoReadinessCoordinator(ctx);\n  if (coordinator) return coordinator;\n  throw new PoReadinessError(\n    PO_READINESS_ERROR_CODE.unavailable,\n    'Po readiness is unavailable. Load the Po Config core.',\n  );\n}\n"],"mappings":"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"}

package/dist/src/schemas/serverBundle.d.mts

@@ -1,18 +1,18 @@
-import { DoomApiScope } from "./packageApi.mjs";
+import { PoApiScope } from "./packageApi.mjs";
 //#region src/schemas/serverBundle.d.ts
 /** Every occurrence that can activate a package in this repository. */
-export interface DoomServerBundleOwner {
+export interface PoServerBundleOwner {
   readonly majorMode: string;
   readonly layer: string;
 }
-export interface DoomServerBundleEntry {
+export interface PoServerBundleEntry {
   readonly packageName: string;
   /** The declared package-relative source entry, retained for attribution. */
   readonly entry: string;
   /** Absolute path of the package's built module; the live loader imports it from its content URL. */
   readonly module: string;
-  readonly scopes: readonly DoomApiScope[];
-  readonly owners: readonly DoomServerBundleOwner[];
+  readonly scopes: readonly PoApiScope[];
+  readonly owners: readonly PoServerBundleOwner[];
   readonly required: boolean;
 }
 //#endregion

package/dist/src/schemas/serverPlugin.cjs

@@ -0,0 +1,103 @@
+//#region src/schemas/serverPlugin.ts
+/** The host service each scope level publishes for the packages installed into it. */
+const PO_SERVER_HOST_SERVICE = "po/server-host";
+function readPoServerHost(context) {
+	return context.get(PO_SERVER_HOST_SERVICE);
+}
+function requirePoServerHost(context) {
+	const service = readPoServerHost(context);
+	if (!service) throw new Error("The Po server host is unavailable. Start a Po server first.");
+	return service;
+}
+/** The package.json field a package declares its server plugin under. */
+const PO_SERVER_MANIFEST_FIELD = "poServer";
+/** Read pure root metadata without initializing or mounting the root. */
+function composeServerProviderOverrides(...roots) {
+	return (context) => roots.flatMap((root) => {
+		if (typeof root !== "function" && typeof root !== "object" || root === null) return [];
+		const callback = root.providerOverrides;
+		return typeof callback === "function" ? callback(context) : [];
+	});
+}
+/** Capture schema inference before heterogeneous methods enter a contribution array. */
+function defineServerMethod(definition, handler) {
+	return { register: (host) => host.registerMethod(definition, handler) };
+}
+var PoServerManifestError = class extends Error {
+	constructor(packageDir, message) {
+		super(`${PO_SERVER_MANIFEST_FIELD} manifest in ${packageDir}: ${message}`);
+		this.name = "PoServerManifestError";
+	}
+};
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizePath(packageDir, field, value) {
+	if (typeof value !== "string" || !value.startsWith("./") || value.includes("..")) throw new PoServerManifestError(packageDir, `${field} must be a package-relative ./path with no '..'.`);
+	return value;
+}
+function normalizeScopes(packageDir, value) {
+	if (value === void 0) throw new PoServerManifestError(packageDir, "scopes must be declared explicitly.");
+	if (!Array.isArray(value) || value.length === 0) throw new PoServerManifestError(packageDir, "scopes must name 'global', 'workspace', or 'session'.");
+	const scopes = [];
+	for (const scope of value) {
+		if (scope !== "session" && scope !== "global" && scope !== "workspace") throw new PoServerManifestError(packageDir, `Unknown scope '${String(scope)}'; resync for the three-level host.`);
+		if (!scopes.includes(scope)) scopes.push(scope);
+	}
+	return scopes;
+}
+/**
+* Validates one package.json's `poServer` block.
+*
+* `dist` is required because a host imports the built entry the package ships,
+* never its source.
+*/
+function declaredServerPackagesOf(packageDir, manifest) {
+	const declared = manifest[PO_SERVER_MANIFEST_FIELD];
+	if (declared === void 0) return [];
+	if (!isRecord(declared)) throw new PoServerManifestError(packageDir, "the block must be an object naming entry and dist.");
+	const entry = normalizePath(packageDir, "entry", declared.entry);
+	if (declared.dist === void 0) throw new PoServerManifestError(packageDir, "dist is required: a host imports the built entry the package ships, never its source.");
+	const dist = normalizePath(packageDir, "dist", declared.dist);
+	if (declared.required !== void 0 && typeof declared.required !== "boolean") throw new PoServerManifestError(packageDir, "required must be a boolean.");
+	return [{
+		packageName: typeof manifest.name === "string" ? manifest.name : packageDir,
+		packageDir,
+		entry,
+		dist,
+		scopes: normalizeScopes(packageDir, declared.scopes),
+		...typeof declared.required === "boolean" ? { required: declared.required } : {}
+	}];
+}
+/**
+* The deterministic order hosts install in. A package appears once: the first
+* directory claiming a package name keeps it and the later one is dropped with
+* a notice, so a duplicated install never installs a package twice.
+*/
+function orderServerPackages(packages, onNotice = () => void 0) {
+	const sorted = [...packages].sort((left, right) => left.packageName.localeCompare(right.packageName) || left.packageDir.localeCompare(right.packageDir));
+	const owners = /* @__PURE__ */ new Map();
+	const kept = [];
+	for (const declared of sorted) {
+		const holder = owners.get(declared.packageName);
+		if (holder !== void 0) {
+			onNotice(`server package '${declared.packageName}' from ${declared.packageDir} is skipped: ${holder.packageDir} already claims it.`);
+			continue;
+		}
+		owners.set(declared.packageName, declared);
+		kept.push(declared);
+	}
+	return kept;
+}
+//#endregion
+exports.PO_SERVER_HOST_SERVICE = PO_SERVER_HOST_SERVICE;
+exports.PO_SERVER_MANIFEST_FIELD = PO_SERVER_MANIFEST_FIELD;
+exports.PoServerManifestError = PoServerManifestError;
+exports.composeServerProviderOverrides = composeServerProviderOverrides;
+exports.declaredServerPackagesOf = declaredServerPackagesOf;
+exports.defineServerMethod = defineServerMethod;
+exports.orderServerPackages = orderServerPackages;
+exports.readPoServerHost = readPoServerHost;
+exports.requirePoServerHost = requirePoServerHost;
+
+//# sourceMappingURL=serverPlugin.cjs.map