@plurnk/plurnk-contracts 1.10.0 → 1.11.0

package/dist/schema/CapabilityProjection.json

@@ -0,0 +1,16 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/CapabilityProjection.json",
+    "title": "CapabilityProjection",
+    "description": "The complete worker-level capability-policy cascade and its normalized effective intersection.",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "service": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
+        "workspace": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
+        "workerBound": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
+        "worker": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
+        "effective": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" }
+    },
+    "required": ["service", "workspace", "workerBound", "worker", "effective"]
+}

package/dist/schema/CapabilitySelector.json

@@ -0,0 +1,24 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/CapabilitySelector.json",
+    "title": "CapabilitySelector",
+    "description": "One exact, conjunctive selector over a routed PLURNK capability demand. Omitted fields are wildcards; at least one field is required.",
+    "type": "object",
+    "minProperties": 1,
+    "additionalProperties": false,
+    "properties": {
+        "operation": {
+            "enum": ["FIND", "READ", "EDIT", "COPY", "MOVE", "SEND", "EXEC", "BARE", "WORK", "FORK", "KILL"]
+        },
+        "scheme": { "type": "string", "pattern": "^[a-z][a-z0-9+.-]*$" },
+        "runtime": { "type": "string", "pattern": "^[a-z][a-z0-9+.-]*$" },
+        "tool": { "type": "string", "minLength": 1 },
+        "access": { "enum": ["observe", "mutate", "execute", "interact", "control"] },
+        "traits": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+            "uniqueItems": true
+        }
+    }
+}

package/dist/schema/ClientStatement.json

@@ -18,6 +18,12 @@
         "AnnotationOrNull": {
             "type": ["string", "null"]
         },
+        "SchemeMetadataOrNull": {
+            "oneOf": [
+                { "type": "array", "items": { "type": "string" } },
+                { "type": "null" }
+            ]
+        },
         "PathOrNull": {
             "oneOf": [
                 { "$ref": "https://schemas.plurnk.xyz/v0/ParsedPath.json" },
@@ -47,12 +53,13 @@
         },
         "LookStatement": {
             "type": "object",
-            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "metadata", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "LOOK" },
                 "delimiter": { "type": "string" },
                 "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
+                "metadata": { "$ref": "#/$defs/SchemeMetadataOrNull" },
                 "signal": { "$ref": "#/$defs/TagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
@@ -62,12 +69,13 @@
         },
         "BuffStatement": {
             "type": "object",
-            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "metadata", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "BUFF" },
                 "delimiter": { "type": "string" },
                 "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
+                "metadata": { "$ref": "#/$defs/SchemeMetadataOrNull" },
                 "signal": { "$ref": "#/$defs/TagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/LineMarkerOrNull" },

package/dist/schema/LoopPolicy.json

@@ -0,0 +1,13 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/LoopPolicy.json",
+    "title": "LoopPolicy",
+    "description": "The complete immutable policy snapshot for one loop. Capability admission precedes proposal disposition.",
+    "type": "object",
+    "required": ["capabilities", "proposals"],
+    "additionalProperties": false,
+    "properties": {
+        "capabilities": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
+        "proposals": { "enum": ["review", "accept", "reject"] }
+    }
+}

package/dist/schema/MatcherBody.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/MatcherBody.json",
     "title": "MatcherBody",
-    "description": "Parsed body of a FIND/OPEN/FOLD statement, discriminated on `dialect`. The dialect is determined by the body's leading characters (`//` xpath, `/` regex, `$` jsonpath, `~` semantic, `@` graph, else glob). The regex variant carries pattern and flags split out of the `/pattern/flags` literal; every variant remains JSON-serializable.",
+    "description": "Parsed single-line body of a matcher-bearing statement, discriminated on `dialect`. The dialect is determined by the body's leading characters (`//` xpath, `/` regex, `$` jsonpath, `~` semantic, `&` graph, else glob). The regex variant carries pattern and flags split out of the `/pattern/flags` literal; every variant remains JSON-serializable.",
     "oneOf": [
         { "$ref": "#/$defs/XPathBody" },
         { "$ref": "#/$defs/RegexBody" },
@@ -20,7 +20,7 @@
             "additionalProperties": false,
             "properties": {
                 "dialect": { "const": "xpath" },
-                "raw": { "type": "string", "minLength": 2 }
+                "raw": { "type": "string", "minLength": 2, "pattern": "^[^\\r\\n]*$" }
             }
         },
         "RegexBody": {
@@ -31,7 +31,7 @@
             "additionalProperties": false,
             "properties": {
                 "dialect": { "const": "regex" },
-                "raw": { "type": "string", "minLength": 2 },
+                "raw": { "type": "string", "minLength": 2, "pattern": "^[^\\r\\n]*$" },
                 "pattern": { "type": "string" },
                 "flags": { "type": "string" }
             }
@@ -44,7 +44,7 @@
             "additionalProperties": false,
             "properties": {
                 "dialect": { "const": "jsonpath" },
-                "raw": { "type": "string", "minLength": 1 }
+                "raw": { "type": "string", "minLength": 1, "pattern": "^[^\\r\\n]*$" }
             }
         },
         "SemanticBody": {
@@ -55,18 +55,18 @@
             "additionalProperties": false,
             "properties": {
                 "dialect": { "const": "semantic" },
-                "raw": { "type": "string", "minLength": 1 }
+                "raw": { "type": "string", "minLength": 1, "pattern": "^[^\\r\\n]*$" }
             }
         },
         "GraphBody": {
             "title": "GraphBody",
-            "description": "Code-graph reference query. Body is `@symbol` for a neighborhood, `@<symbol` for inbound references, or `@>symbol` for outbound references. Resolution happens service-side through the symbol index; no parse step occurs in the language parser.",
+            "description": "Code-graph reference query. Body is `&symbol` for a neighborhood, `&<symbol` for inbound references, or `&>symbol` for outbound references. Shape is validated during language admission; resolution happens service-side through the symbol index.",
             "type": "object",
             "required": ["dialect", "raw"],
             "additionalProperties": false,
             "properties": {
                 "dialect": { "const": "graph" },
-                "raw": { "type": "string", "minLength": 1 }
+                "raw": { "type": "string", "pattern": "^&[<>]?[^\\s<>]\\S*$" }
             }
         },
         "GlobBody": {
@@ -77,7 +77,7 @@
             "additionalProperties": false,
             "properties": {
                 "dialect": { "const": "glob" },
-                "raw": { "type": "string" }
+                "raw": { "type": "string", "pattern": "^[^\\r\\n]*$" }
             }
         }
     }

package/dist/schema/ParsedPath.json

@@ -47,17 +47,7 @@
                     "description": "Canonical serialized WHATWG query component without the leading `?`. Null means no query; the empty string means an explicit empty query (`?`). Ordering, duplicate names, and encoded spelling are preserved.",
                     "type": ["string", "null"]
                 },
-                "fragment": { "type": ["string", "null"] },
-                "headers": {
-                    "description": "Trailing `{key: value}` request-metadata blocks removed before WHATWG decomposition and preserved as ordered pairs. Order and duplicate names survive; the addressed scheme owns their meaning. Absent when no block was supplied.",
-                    "type": "array",
-                    "items": {
-                        "type": "array",
-                        "items": { "type": "string" },
-                        "minItems": 2,
-                        "maxItems": 2
-                    }
-                }
+                "fragment": { "type": ["string", "null"] }
             }
         }
     }

package/dist/schema/PlurnkStatement.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/PlurnkStatement.json",
     "title": "PlurnkStatement",
-    "description": "The parsed AST union for one protocol statement, discriminated by `op`. Every variant has fixed signal, target, lineMarker, annotation, body, delimiter, and source-position fields; operation-specific schemas constrain their types. A null field records an omitted tolerated slot and does not satisfy runtime requirements by itself.",
+    "description": "The parsed AST union for one protocol statement, discriminated by `op`. Every variant has fixed signal, target, metadata, lineMarker, annotation, body, delimiter, and source-position fields; operation-specific schemas constrain their types. A null field records an omitted tolerated slot and does not satisfy runtime requirements by itself.",
     "oneOf": [
         {
             "$ref": "#/$defs/FindStatement"
@@ -67,6 +67,18 @@
                 "null"
             ]
         },
+        "SchemeMetadataOrNull": {
+            "description": "Opaque ordered scheme-metadata modifier blocks. Contracts preserve each block's raw inner text; the addressed scheme exclusively owns interpretation and validation.",
+            "oneOf": [
+                {
+                    "type": "array",
+                    "items": { "type": "string" }
+                },
+                {
+                    "type": "null"
+                }
+            ]
+        },
         "AppliedTagSignal": {
             "oneOf": [
                 {
@@ -145,16 +157,6 @@
                 }
             ]
         },
-        "ResourceSelectionOrNull": {
-            "oneOf": [
-                {
-                    "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json"
-                },
-                {
-                    "type": "null"
-                }
-            ]
-        },
         "PositionRef": {
             "$ref": "https://schemas.plurnk.xyz/v0/Position.json"
         },
@@ -164,6 +166,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -181,6 +184,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "$ref": "#/$defs/AppliedTagSignal"
                 },
@@ -204,6 +210,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -221,6 +228,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "$ref": "#/$defs/AppliedTagSignal"
                 },
@@ -244,6 +254,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -261,6 +272,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "$ref": "#/$defs/CurationTagSignal"
                 },
@@ -284,6 +298,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -301,6 +316,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "$ref": "#/$defs/CurationTagSignal"
                 },
@@ -324,6 +342,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -341,6 +360,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "$ref": "#/$defs/AppliedTagSignal"
                 },
@@ -368,9 +390,8 @@
                 "delimiter",
                 "annotation",
                 "signal",
-                "target",
-                "lineMarker",
-                "body",
+                "source",
+                "destination",
                 "position"
             ],
             "additionalProperties": false,
@@ -387,14 +408,11 @@
                 "signal": {
                     "$ref": "#/$defs/AppliedTagSignal"
                 },
-                "target": {
-                    "$ref": "#/$defs/PathOrNull"
-                },
-                "lineMarker": {
-                    "$ref": "#/$defs/TextLineMarkerOrNull"
+                "source": {
+                    "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json"
                 },
-                "body": {
-                    "$ref": "#/$defs/ResourceSelectionOrNull"
+                "destination": {
+                    "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json"
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
@@ -408,9 +426,8 @@
                 "delimiter",
                 "annotation",
                 "signal",
-                "target",
-                "lineMarker",
-                "body",
+                "source",
+                "destination",
                 "position"
             ],
             "additionalProperties": false,
@@ -427,14 +444,11 @@
                 "signal": {
                     "$ref": "#/$defs/AppliedTagSignal"
                 },
-                "target": {
-                    "$ref": "#/$defs/PathOrNull"
-                },
-                "lineMarker": {
-                    "$ref": "#/$defs/TextLineMarkerOrNull"
+                "source": {
+                    "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json"
                 },
-                "body": {
-                    "$ref": "#/$defs/ResourceSelectionOrNull"
+                "destination": {
+                    "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json"
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
@@ -447,6 +461,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -464,6 +479,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "oneOf": [
                         {
@@ -494,6 +512,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -511,6 +530,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "type": [
                         "string",
@@ -549,6 +571,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -566,6 +589,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "$ref": "#/$defs/AppliedTagSignal"
                 },
@@ -590,6 +616,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -607,14 +634,17 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "type": "null"
+                },
                 "signal": {
-                    "$ref": "#/$defs/TagSignal"
+                    "type": "null"
                 },
                 "target": {
-                    "$ref": "#/$defs/PathOrNull"
+                    "type": "null"
                 },
                 "lineMarker": {
-                    "$ref": "#/$defs/LineMarkerOrNull"
+                    "type": "null"
                 },
                 "body": {
                     "$ref": "https://schemas.plurnk.xyz/v0/Plan.json"
@@ -630,6 +660,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -647,6 +678,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "oneOf": [
                         {
@@ -680,6 +714,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -697,6 +732,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "oneOf": [
                         {
@@ -729,6 +767,7 @@
                 "op",
                 "delimiter",
                 "annotation",
+                "metadata",
                 "signal",
                 "target",
                 "lineMarker",
@@ -746,6 +785,9 @@
                 "annotation": {
                     "$ref": "#/$defs/AnnotationOrNull"
                 },
+                "metadata": {
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                },
                 "signal": {
                     "oneOf": [
                         {

package/dist/schema/ProblemProjection.json

@@ -0,0 +1,38 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/ProblemProjection.json",
+    "title": "ProblemProjection",
+    "description": "The compact model-facing projection of one exact RFC 9457 Problem. The enclosing log row owns model-facing address and status; stable type, causal detail, and non-duplicative decision facts remain.",
+    "type": "object",
+    "required": ["type", "detail"],
+    "additionalProperties": true,
+    "properties": {
+        "type": {
+            "type": "string",
+            "pattern": "^[a-zA-Z][a-zA-Z0-9+.-]*:",
+            "description": "Absolute URI identifying the stable problem class."
+        },
+        "detail": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Specific, causal explanation of this occurrence."
+        },
+        "stage": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Stable producer-owned stage at which the operation failed, when neighboring stages imply different recovery."
+        },
+        "recovery": {
+            "type": "string",
+            "minLength": 1,
+            "description": "One generally valid next action, only when the producer knows it."
+        },
+        "retryable": {
+            "type": "boolean",
+            "description": "Whether the producer recommends automatically retrying the identical request."
+        },
+        "title": false,
+        "status": false,
+        "instance": false
+    }
+}

package/dist/schema/ProposalProjection.json

@@ -13,7 +13,7 @@
         "target",
         "body",
         "attrs",
-        "flags",
+        "policy",
         "disposition"
     ],
     "additionalProperties": false,
@@ -37,7 +37,7 @@
         },
         "body": { "type": "string" },
         "attrs": { "type": "object", "additionalProperties": true },
-        "flags": { "$ref": "https://schemas.plurnk.xyz/v0/LoopFlags.json" },
+        "policy": { "$ref": "https://schemas.plurnk.xyz/v0/LoopPolicy.json" },
         "disposition": { "$ref": "https://schemas.plurnk.xyz/v0/ProposalDisposition.json" }
     }
 }

package/dist/schema/ResourceSelection.json

@@ -2,14 +2,24 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/ResourceSelection.json",
     "title": "ResourceSelection",
-    "description": "A COPY/MOVE destination target and optional text scope. A target without a fragment selects the scheme's default channel; a fragment selects a named channel; lineMarker scopes the selected destination content.",
+    "description": "One COPY/MOVE resource operand. A target without a fragment selects the scheme's default channel; a fragment selects a named channel; metadata belongs to the selected scheme endpoint; lineMarker scopes the selected textual content.",
     "type": "object",
-    "required": ["target", "lineMarker"],
+    "required": ["target", "metadata", "lineMarker"],
     "additionalProperties": false,
     "properties": {
         "target": {
             "$ref": "https://schemas.plurnk.xyz/v0/ParsedPath.json"
         },
+        "metadata": {
+            "description": "Opaque ordered scheme-metadata modifier blocks owned by this operand's addressed scheme.",
+            "oneOf": [
+                {
+                    "type": "array",
+                    "items": { "type": "string" }
+                },
+                { "type": "null" }
+            ]
+        },
         "lineMarker": {
             "oneOf": [
                 { "$ref": "https://schemas.plurnk.xyz/v0/TextLineMarker.json" },