@forgezero/runtime 0.1.20 → 0.1.22

package/README.md

@@ -972,6 +972,19 @@ scheduler.pause();            // stop scheduling, let in-flight finish
 await scheduler.runNow('rotate-provider-credentials');
 ```
 
+## Deployment handoff is typed state, not copied RAM
+
+The portable lifecycle for native and containerd services is deliberately smaller than a process snapshot. First report not-ready and close new HTTP and job intake. Existing requests, streams and queue handlers drain within one deadline. Durable jobs stay in the application store with an idempotency key, expiring lease and monotonic fence, so the candidate may reclaim unfinished work without allowing the old generation to commit. An optional handoff value may carry a bounded, versioned cursor or connection coordinate after schema validation. Closures, arbitrary heap objects, sockets and Vault plaintext never cross generations; the candidate resolves the same named Vault references through its own authorized runtime boundary. This is the lifecycle ForgeZero itself must use before it is offered to tenants.
+
+```text
+old: ready=false -> close intake -> drain HTTP/streams -> drain or release fenced jobs
+new: private health -> validate handoff -> resolve named Vault refs -> accept claims
+switch: route new HTTP -> observe old deadline -> stop old or roll back
+
+durable job = payload + idempotencyKey + leaseUntil + fence
+handoff value = versioned + schema-validated + size-bounded + non-secret
+```
+
 ## Status somebody can read during an incident
 
 Last run, duration, result, error and consecutive failures per job. Without it a job that has been failing for a week looks exactly like a job that has been succeeding.

package/dist/schema-typebox.js

@@ -141,6 +141,7 @@ function describeJsonSchema(schema, prefix = "") {
       required: required.has(name),
       description: property.description,
       writeOnly: property.writeOnly === true ? true : undefined,
+      readOnly: property.readOnly === true ? true : undefined,
       default: property.default,
       format: property.format,
       minLength: property.minLength,
@@ -181,6 +182,7 @@ function describeProperty(property, path, label, required) {
     required,
     description: property.description,
     writeOnly: property.writeOnly === true ? true : undefined,
+    readOnly: property.readOnly === true ? true : undefined,
     default: property.default,
     format: property.format,
     minLength: property.minLength,

package/dist/schema.d.ts

@@ -61,6 +61,8 @@ export interface FormField {
      * is what routes a credential into the vault instead of onto a page.
      */
     writeOnly?: boolean;
+    /** Stored and validated, but supplied only by a trusted backend resolver. */
+    readOnly?: boolean;
     default?: unknown;
     /** `enum` only. */
     options?: readonly string[];

package/dist/schema.js

@@ -141,6 +141,7 @@ function describeJsonSchema(schema, prefix = "") {
       required: required.has(name),
       description: property.description,
       writeOnly: property.writeOnly === true ? true : undefined,
+      readOnly: property.readOnly === true ? true : undefined,
       default: property.default,
       format: property.format,
       minLength: property.minLength,
@@ -181,6 +182,7 @@ function describeProperty(property, path, label, required) {
     required,
     description: property.description,
     writeOnly: property.writeOnly === true ? true : undefined,
+    readOnly: property.readOnly === true ? true : undefined,
     default: property.default,
     format: property.format,
     minLength: property.minLength,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgezero/runtime",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "type": "module",
   "publishConfig": {
     "access": "public",