@openapi-flow/core 0.3.8 → 0.3.9

package/README.md

@@ -2,7 +2,7 @@
 
 Zod `^4.6.5` is a required peer, shared with the host rather than installed as a separately pinned runtime copy. Development tests use 4.6.5; the strict installed-consumer check also uses the host's 4.6.7. This preserves the public schema type boundary without casts or dependency overrides.
 
-Version **0.3.8**. Canonical draft, clarification and runtime-input APIs described below are included in this release source. Original-choice follow-ups derive their display and typed reply in Core. This patch aligns the three libraries for the new n8n response-object capability without adding a Core-specific composition path. Ajv 8.20.0 does not correctly validate a declared `properties.__proto__`; generated validation may reject valid data or omit that property's constraints. This previously accepted limitation remains unchanged, without renaming data or skipping its failing regression. See the [release record](https://github.com/carefreelife98/openapi-flow/blob/main/docs/releases/0.3.8.md) for publication and host status.
+Version **0.3.9**. Canonical draft, clarification and runtime-input APIs described below are included in this release source. Requirement-edit schema descriptions distinguish explicit record editing from workflow behavior changes; runtime validation rules and typed human answers are unchanged. Original-choice follow-ups still derive their display and typed reply in Core. Ajv 8.20.0 does not correctly validate a declared `properties.__proto__`; generated validation may reject valid data or omit that property's constraints. This previously accepted limitation remains unchanged, without renaming data or skipping its failing regression. See the [release record](https://github.com/carefreelife98/openapi-flow/blob/main/docs/releases/0.3.9.md) for publication and host status.
 
 Native and fixed-material connection planning accept the optional, existing `WorkflowEntryPointContract` as `entrypoint`. Core validates and snapshots this owner-provided start alongside the other inputs; it does not infer one when absent, add a selectable trigger or let model output modify it.
 

package/dist/schemas/create-workflow-draft-edit-proposal-schema.js

@@ -118,11 +118,15 @@ export function createWorkflowDraftEditProposalSchema(options, sources) {
         }));
     if (sources.requirementIds.length)
         for (const kind of ['revise-requirement', 'remove-requirement'])
-            decisions.push(z.strictObject({
+            decisions.push(z
+                .strictObject({
                 kind: z.literal(kind),
                 requirementId: z.enum(sources.requirementIds),
                 ...fields,
-            }));
+            })
+                .describe(kind === 'revise-requirement'
+                ? 'An explicit request to edit the existing requirement record itself: its stored statement, state or scope; not a request to change workflow behavior. API/native node, input, source and connection changes use their own decisions and do not require this bookkeeping edit. A later typed human answer supplies replacement fields.'
+                : 'An explicit request to withdraw this existing requirement record itself, not its API/native nodes or connections. Do not infer record withdrawal from workflow behavior changes.'));
     if (sources.removedRequirementIds.length)
         decisions.push(z.strictObject({
             kind: z.literal('restore-requirement'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openapi-flow/core",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "license": "MIT",
   "description": "Engine-independent OpenAPI catalogs, operation contracts and typed request schemas",
   "keywords": [