@xemahq/kernel-contracts 0.22.3 → 0.23.1

package/src/workflow/lib/enums.ts

@@ -3,7 +3,7 @@
 //
 // Closed domains for every workflow/job/step state + policy value.
 // Every workflow-plane decision point uses one of these enums. Free-form
-// strings are forbidden for closed sets (see docs/API_STANDARDS.md §5.3).
+// strings are forbidden for closed sets per the API standards.
 // ═══════════════════════════════════════════════════════════════════════════
 
 /** How a workflow run was initiated. */
@@ -227,8 +227,8 @@ export enum BuiltInActionId {
   SCM_POST_REVIEW = 'software-dev/scm-post-review',
   DISPATCH_WORKFLOW = 'xema/dispatch-workflow',
   /**
-   * Send an email via AWS Simple Email Service. Shipped by
-   * `biomes/platform/aws-integration`. Credentials come from the
+   * Send an email via AWS Simple Email Service. Shipped by the
+   * `aws-integration` biome. Credentials come from the
    * caller's wallet via `${{ secrets.AWS_SECRET_ACCESS_KEY }}` etc.
    */
   AWS_SES_SEND = 'aws-integration/ses-send',
@@ -252,7 +252,7 @@ export enum BuiltInActionId {
   /**
    * Trigger an org-database migration via org-database-pool-api and
    * block until the run reaches a terminal state. Generic primitive
-   * (Phase G of the org-managed-databases plan) — any sub-app that
+   * — any sub-app that
    * needs to materialize a schema against a pool-managed database
    * dispatches this action; the caller is responsible for resolving
    * the `databaseId` and providing a `workspaceDir` containing the

package/src/workflow/lib/errors.ts

@@ -3,7 +3,7 @@
  * the engine, compiler, evaluator, or worker picks a code from this enum.
  *
  * Enum-based so:
- *   - OpenAPI emits a stable `code` field (docs/API_STANDARDS §3.5).
+ *   - OpenAPI emits a stable `code` field per the API standards.
  *   - The retry policy can mark specific codes as non-retryable
  *     deterministically (see CompiledRetryPolicy.nonRetryableErrorTypes).
  *   - Frontend switches are exhaustive.

package/src/workflow/lib/model-ref.ts

@@ -30,7 +30,7 @@ import type { PermissionMap } from '../../agent-permission';
  * consumer (DTOs, Zod schemas, frontend lookups) MUST import from here
  * (or re-export this enum) instead of restating the literal list.
  *
- * Mirrors `biomes/agent-runtime/api/llm-registry-api`'s Prisma `ModelClass` column.
+ * Mirrors llm-registry-api's Prisma `ModelClass` column.
  *
  * IMPORTANT — the one allowed copy is in `@xemahq/biome-sdk/builder`'s
  * `contribution-schemas.ts`, kept inline so the public biome-authoring SDK

package/src/workflow/lib/mount-plan.ts

@@ -110,7 +110,7 @@ export type MountSource =
   | { readonly kind: 'deliverable-specs'; readonly contractKey: string }
   | { readonly kind: 'deliverables'; readonly contractKey: string }
   | { readonly kind: 'static-literal'; readonly pathWithinWorkspace: string; readonly bytes: string }
-  // Platform-rendered (PR 1 of unified-workspace-image refactor):
+  // Platform-rendered:
   | {
       readonly kind: 'agent-kernel';
       readonly orgId: string;

package/src/workflow/lib/platform-task-queue.ts

@@ -1,6 +1,6 @@
 /**
- * Internal-workflow task-queue naming — Epic T (Temporal internal-workflow
- * platform).
+ * Internal-workflow task-queue naming for the Temporal internal-workflow
+ * platform.
  *
  * Every internal/platform workflow runs in the `xema` namespace
  * (`PLATFORM_TEMPORAL_NAMESPACE`) on a task queue named for its domain. One
@@ -43,7 +43,7 @@ export enum PlatformWorkflowDomain {
   /** Biome-installation cleanup cascade. */
   BIOME_LIFECYCLE = 'biome-lifecycle',
   /**
-   * Integration-ingress webhook-outbox forward dispatch (Phase J). One
+   * Integration-ingress webhook-outbox forward dispatch. One
    * workflow per outbox row; Temporal owns retries + DLQ semantics.
    */
   INTEGRATION_INGRESS = 'integration-ingress',

package/src/workflow/lib/role-capability.ts

@@ -2,7 +2,7 @@
 // ── RoleCapabilityProfile types + closed-domain enums ──
 //
 // The DATA (one profile per `AgentRunRole`) lives in biome contributions
-// at `biomes/kernel/runtime/role-capabilities/<role>.role-capability.yaml`.
+// as per-role role-capability definitions.
 // llm-registry-api's `RoleCapabilityRegistryService` loads + serves them
 // in-process, exposes them via `GET /role-capabilities/:role`, and writes
 // the resolved `allowedXemaTools` array into each invocation's

package/src/workflow/lib/run-progress.ts

@@ -52,8 +52,8 @@ export enum RunActivityKind {
   SCHEDULED_DISPATCH = 'scheduled_dispatch',
   REVIEW = 'review',
   /**
-   * Org-database migration dispatched via `xema/run-migrations@v1`
-   * (Phase G of the org-managed-databases plan). The activity calls
+   * Org-database migration dispatched via `xema/run-migrations@v1`.
+   * The activity calls
    * org-database-pool-api to start a migration workflow and polls
    * the per-database migration listing until the run reaches a
    * terminal state.

package/src/workflow/lib/trigger-payload.ts

@@ -6,8 +6,8 @@ import { WorkflowTriggerKind } from './enums';
  * every consumer switches exhaustively; unknown `kind` is a compile error.
  *
  * Webhook trigger payloads are the canonical envelopes produced by
- * `integration-adapters-api` (see `docs/API_STANDARDS.md §17`), so the
- * workflow plane never touches provider-specific shapes.
+ * `integration-adapters-api`, so the workflow plane never touches
+ * provider-specific shapes.
  */
 export type TriggerPayload =
   | WorkflowDispatchTriggerPayload

package/src/workflow/lib/variable-requirement.ts

@@ -2,7 +2,7 @@
  * Variable + secret contract a workflow declares it needs.
  *
  * Authored in YAML under `requires.variables`. Each entry is the name of an
- * org/project Variable (per `biomes/project-registry/api/project-registry-api`) that the workflow
+ * org/project Variable (managed by project-registry-api) that the workflow
  * expects to be present at dispatch time. Names follow the same
  * `[A-Z][A-Z0-9_]*` convention as `CreateVariableDto.key`.
  *

package/src/workflow/lib/workspace-manifest-enums.ts

@@ -69,7 +69,7 @@ export const CREDENTIAL_KINDS: readonly CredentialKind[] = [
 
 /**
  * Kinds of output surface a workspace can expose. Consumed by
- * `biomes/workspace-proxy/api/workspace-proxy/src/output-surface/engine.ts` to wire route lifecycle.
+ * workspace-proxy's output-surface engine to wire route lifecycle.
  *
  * `none` is the explicit no-output-surface default (omitting `outputSurface`
  * is equivalent). `web` is a long-running webserver on `port`. `static`

package/src/workspace-storage/lib/types.ts

@@ -47,7 +47,7 @@ export interface PoolSpec {
    */
   readonly driverConfig: Record<string, unknown>;
   readonly capacityBytes: bigint;
-  /** Required for region-aware co-scheduling (see plan §15). */
+  /** Required for region-aware co-scheduling. */
   readonly region: string;
   readonly environment?: string;
   /** Free-form cost class label for billing/observability dashboards. */