bazis 0.100.0 → 0.100.1

package/core/infra/connectors/codex/CodexAppServerClient.ts

@@ -232,7 +232,7 @@ export class CodexAppServerClient implements CodexClient {
         if (method === "account/updated") this.modelCache = undefined;
       }, () => { this.clearLogin(); this.modelCache = undefined; });
       const initialized = await client.request("initialize", {
-        clientInfo: { name: "bazis", title: "Bazis", version: "0.100.0" }, capabilities: { experimentalApi: true },
+        clientInfo: { name: "bazis", title: "Bazis", version: "0.100.1" }, capabilities: { experimentalApi: true },
       }, 15_000, signal);
       if (resolve(text(initialized.codexHome, 4096)) !== this.paths.home) throw new CodexError("PROTOCOL_ERROR");
       client.notify("initialized");

package/core/infra/connectors/opensearch.ts

@@ -3,6 +3,7 @@ import type { AppConfig, ConfigRegistry, Secret } from "../../kernel";
 import { reader, requireValue, settingNames } from "../connectorConfig";
 import { errorMessage, InfraError, type InfraConnector } from "../InfraConnector";
 import { redactSensitive, redactSensitiveText } from "../../../library/redaction";
+import { identifyConnector } from "../connectorIdentity";
 
 /** Default cluster request timeout (ms): fail fast instead of hanging. */
 const DEFAULT_OPENSEARCH_TIMEOUT_MS = 5000;
@@ -295,7 +296,7 @@ export function openSearchConnect<T extends OpenSearchConfigShape>(
   options: OpenSearchConnectorOptions = {},
 ): InfraConnector<OpenSearchClient> {
   const settings = new WeakMap<OpenSearchClient, string[]>();
-  return {
+  return identifyConnector({
     token: options.token ?? IOpenSearch,
     config,
     create(configs) {
@@ -334,5 +335,5 @@ export function openSearchConnect<T extends OpenSearchConfigShape>(
     healthCheck(client, signal) {
       return client.ping(signal);
     },
-  };
+  }, "opensearch");
 }

package/core/infra/connectors/postgres.ts

@@ -3,6 +3,7 @@ import { createToken, type InjectionToken } from "../../di";
 import type { AppConfig, ConfigRegistry, Secret } from "../../kernel";
 import { reader, requireValue, settingNames } from "../connectorConfig";
 import { errorMessage, InfraError, type InfraConnector } from "../InfraConnector";
+import { identifyConnector } from "../connectorIdentity";
 
 /**
  * PostgreSQL client (native Bun `SQL`, no external dependencies) of the
@@ -83,7 +84,7 @@ export function postgres<T extends PostgresConfigShape>(config: AppConfig<T>, op
     throw new InfraError("postgres shutdownTimeoutMs must be an integer 0..2147483647");
   }
   const described = new WeakMap<SQL, { options: { hostname?: string; port?: number; database?: string; username?: string; max?: number }; settings: string[] }>();
-  return {
+  return identifyConnector({
     token: options.token ?? IPostgres,
     config,
     create(configs) {
@@ -118,7 +119,7 @@ export function postgres<T extends PostgresConfigShape>(config: AppConfig<T>, op
         return false;
       }
     },
-  };
+  }, "postgres");
 }
 
 /** `postgres@127.0.0.1:5432/app`: user, host, port and database, never the password. */

package/core/infra/connectors/redis.ts

@@ -12,6 +12,7 @@ import { RedisDistributedCacheBackend, type RedisDistributedCacheTuning } from "
 import { reader, requireValue, settingNames } from "../connectorConfig";
 import { errorMessage, InfraError, type InfraConnector } from "../InfraConnector";
 import { redactSensitiveText } from "../../../library/redaction";
+import { identifyConnector } from "../connectorIdentity";
 
 const DEFAULT_REDIS_CONNECT_TIMEOUT_MS = 5_000;
 
@@ -115,7 +116,7 @@ export function redisConnect<T extends RedisConfigShape>(
       ? undefined
       : distributedCacheProviders(cache === "distributed" ? {} : withoutMode(cache), token);
 
-  return {
+  return identifyConnector({
     token,
     config,
     providers: cacheProviders,
@@ -166,7 +167,7 @@ export function redisConnect<T extends RedisConfigShape>(
         return false;
       }
     },
-  };
+  }, "redis");
 }
 
 function redisUrl(value: unknown): string {

package/core/orm/OrmHostedPlan.validator.ts

@@ -1,6 +1,6 @@
 import type { HostedService, HostedServicePlanValidator } from "../di";
 import { SchemaAdmissionError } from "../../library/orm";
-import { isOrmProviderLifecycle, isStrictSchemaPrerequisiteLifecycle } from "./strictSchemaHostedIdentity";
+import { describePhaseConflict, isOrmProviderLifecycle, isStrictSchemaPrerequisiteLifecycle } from "./strictSchemaHostedIdentity";
 
 /** Stateless strategy shared by ORM lifecycles; it owns no connection or application state. */
 export const ormHostedPlanValidator: HostedServicePlanValidator = Object.freeze({ validate: validateOrmHostedPlan });
@@ -18,7 +18,7 @@ function validateOrmHostedPlan(services: readonly HostedService[]): void {
         || (service as { __bazisOrmOwnedStoreAdmission?: unknown }).__bazisOrmOwnedStoreAdmission === true
         || (service as { __bazisOrmLegacyLifecycle?: unknown }).__bazisOrmLegacyLifecycle === true
         || isStrictSchemaPrerequisiteLifecycle(service);
-      if (!framework && (service.phase ?? 0) < 0) throw new SchemaAdmissionError("ORM_SCHEMA_HOSTED_PHASE_CONFLICT", "Application hosted services must use phase 0 or later with ORM owned-store admission.");
+      if (!framework && (service.phase ?? 0) < 0) throw new SchemaAdmissionError("ORM_SCHEMA_HOSTED_PHASE_CONFLICT", `Application hosted services must use phase 0 or later with ORM owned-store admission: ${describePhaseConflict(service)}`);
     }
   }
   const strict = services.filter((service): service is HostedService & { readonly __bazisSchemaAdmission: { readonly owner?: string; readonly unit: readonly string[]; readonly tables: readonly string[]; readonly foreignKeys: readonly { readonly source: string; readonly target: string }[] } } =>
@@ -59,7 +59,7 @@ function validateOrmHostedPlan(services: readonly HostedService[]): void {
       || (service as { __bazisSchemaAdmission?: unknown }).__bazisSchemaAdmission !== undefined
       || (service as { __bazisOrmOwnedStoreAdmission?: unknown }).__bazisOrmOwnedStoreAdmission === true;
     if (!framework && (service.phase ?? 0) < 0) {
-      throw new SchemaAdmissionError("ORM_SCHEMA_HOSTED_PHASE_CONFLICT", "Application hosted services must use phase 0 or later with schema admission.");
+      throw new SchemaAdmissionError("ORM_SCHEMA_HOSTED_PHASE_CONFLICT", `Application hosted services must use phase 0 or later with schema admission: ${describePhaseConflict(service)}`);
     }
   }
 }

package/core/orm/strictSchemaHostedIdentity.ts

@@ -9,9 +9,24 @@ export function isOrmProviderLifecycle(lifecycle: HostedService): boolean {
   return connector?.token === DATABASE_PROVIDER && lifecycle.phase === -110;
 }
 
+/**
+ * Unchanged framework connectors that never touch the schema: they may start
+ * at phase -100, after schema admission and before application services.
+ */
+const PREREQUISITE_ROLES = new Set(["llm", "agent-session-checkpoint-protection", "postgres", "redis", "opensearch"]);
+
 /** Only these unchanged factory-owned resources may precede application services. */
 export function isStrictSchemaPrerequisiteLifecycle(lifecycle: HostedService): boolean {
   if ((lifecycle.phase ?? 0) !== -100) return false;
   const role = getLifecycleConnectorRole(lifecycle);
-  return role === "llm" || role === "agent-session-checkpoint-protection";
+  return role !== undefined && PREREQUISITE_ROLES.has(role);
+}
+
+/** The service a phase conflict is about and what to do with it. */
+export function describePhaseConflict(service: HostedService): string {
+  const name = service.diagnosticName ?? service.constructor?.name ?? "a hosted service";
+  const connector = getLifecycleConnector(service) !== undefined;
+  return connector
+    ? `${name} (phase ${service.phase ?? 0}) is not a framework connector; a custom or changed connector starts at phase 0 or later: set phase: 0 on it.`
+    : `${name} has phase ${service.phase ?? 0}; use phase 0 or later.`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bazis",
-  "version": "0.100.0",
+  "version": "0.100.1",
   "description": "Modular backend framework for Bun in TypeScript: DI wired by codegen, HTTP, a PostgreSQL ORM, JWT, WebSocket, agents and a CLI.",
   "license": "MIT",
   "author": "Alexander Alenin",