npm - @kungfu-tech/buildchain - Versions diffs - 3.0.6 → 3.0.7-alpha.0 - Mend

@kungfu-tech/buildchain 3.0.6 → 3.0.7-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (64) hide show

package/README.md +4 -2
package/actions/release-tail/README.md +17 -0
package/bin/buildchain.mjs +11 -0
package/bin/internal/command-registry.mjs +2 -0
package/contracts/fixtures/release-tail-capabilities-v1/kungfu-alpha.json +273 -0
package/contracts/publication-rehearsal-capsule-v1.schema.json +173 -0
package/contracts/release-tail-capabilities-v1.schema.json +199 -0
package/contracts/release-tail-provider-bindings-v1.schema.json +56 -0
package/dist/site/agent-index.json +3 -0
package/dist/site/artifact-schemas.json +6 -0
package/dist/site/buildchain-contract.json +35 -20
package/dist/site/buildchain-site.json +307 -17
package/dist/site/capability-registry.json +12 -9
package/dist/site/cli-registry.json +102 -0
package/dist/site/controller-registry.json +14 -2
package/dist/site/kfd-claims.json +247 -16
package/dist/site/kfd-upstream-aggregate.json +1 -1
package/dist/site/manual-registry.json +48 -3
package/dist/site/node-api-registry.json +3108 -1409
package/dist/site/page-registry.json +275 -9
package/dist/site/public-surface-audit.json +304 -15
package/dist/site/publication-authority-registry.json +26 -1
package/dist/site/publication-registry.json +4 -4
package/dist/site/release-provenance.json +5 -0
package/dist/site/schemas/publication-rehearsal-capsule-v1.schema.json +269 -0
package/dist/site/schemas/release-tail-capabilities-v1.schema.json +353 -0
package/dist/site/schemas/release-tail-provider-bindings-v1.schema.json +94 -0
package/dist/site/site-manifest.json +31 -7
package/dist/site/workflow-registry.json +86 -9
package/docs/MAP.md +5 -2
package/docs/cli-reference.md +136 -0
package/docs/node-api-reference.md +233 -84
package/docs/publication-rehearsal.md +94 -0
package/docs/release-tail-contract.md +160 -0
package/docs/release-tail-provider-plane.md +120 -0
package/package.json +8 -3
package/packages/core/buildchain-agent-manuals.js +3 -0
package/packages/core/buildchain-kfd-claims.js +1 -1
package/packages/core/buildchain-publication-authority.js +1 -0
package/packages/core/index.js +39 -0
package/packages/core/paper-agent-entry.js +11 -5
package/packages/core/paper-repository.js +1 -0
package/packages/core/paper-scaffold-content.js +21 -0
package/packages/core/paper.js +28 -2
package/packages/core/publication-rehearsal-projection.js +173 -0
package/packages/core/publication-rehearsal-runtime.js +909 -0
package/packages/core/release-tail-compatibility.js +60 -0
package/packages/core/release-tail-provider-adapters.js +461 -0
package/packages/core/release-tail-provider-plane.js +1228 -0
package/scripts/assemble-publication-artifact-admission.mjs +1 -1
package/scripts/assemble-self-publication-admission.mjs +1 -1
package/scripts/buildchain-cli-help.mjs +13 -0
package/scripts/check-core-mechanism-inventory.mjs +347 -0
package/scripts/check-inventory.mjs +8 -8
package/scripts/check-maintainability.mjs +9 -2
package/scripts/check-release-tail-contract.mjs +435 -0
package/scripts/generate-channel-promotion-workflow.mjs +10 -8
package/scripts/generate-site-bundle.mjs +24 -0
package/scripts/init-repo.mjs +26 -2
package/scripts/materialize-self-release-candidate-version.mjs +131 -0
package/scripts/release-tail.mjs +159 -0
package/scripts/site-capability-metadata.mjs +11 -0
package/scripts/v4-architecture.mjs +600 -0
package/scripts/workflow-call-contract.mjs +184 -5

package/dist/site/schemas/publication-rehearsal-capsule-v1.schema.json ADDED Viewed

@@ -0,0 +1,269 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/publication-rehearsal-capsule-v1.schema.json",
+  "title": "Buildchain publication rehearsal capsule",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract",
+    "schemaVersion",
+    "root",
+    "declaration",
+    "policyRoots",
+    "passport",
+    "transaction",
+    "files",
+    "providerBindings",
+    "providerObservations",
+    "runtime"
+  ],
+  "properties": {
+    "contract": {
+      "const": "kungfu.buildchain.publication-rehearsal-capsule/v1"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "root": {
+      "$ref": "#/$defs/root"
+    },
+    "declaration": {
+      "$ref": "release-tail-capabilities-v1.schema.json"
+    },
+    "policyRoots": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/root"
+      }
+    },
+    "passport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "root"
+      ],
+      "properties": {
+        "path": {
+          "$ref": "#/$defs/path"
+        },
+        "root": {
+          "$ref": "#/$defs/root"
+        }
+      }
+    },
+    "transaction": {
+      "type": "object",
+      "required": [
+        "schema",
+        "transactionPolicy",
+        "transactionRoot",
+        "declarationRoot",
+        "planRoot",
+        "subject",
+        "state",
+        "operationOrder",
+        "operations",
+        "observations",
+        "receipts",
+        "failure",
+        "stateRoot"
+      ]
+    },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "role",
+          "path",
+          "size",
+          "root"
+        ],
+        "properties": {
+          "role": {
+            "type": "string",
+            "minLength": 1
+          },
+          "path": {
+            "$ref": "#/$defs/path"
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "root": {
+            "$ref": "#/$defs/root"
+          }
+        }
+      }
+    },
+    "providerBindings": {
+      "$ref": "release-tail-provider-bindings-v1.schema.json"
+    },
+    "providerObservations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "operationId",
+          "readbacks",
+          "apply"
+        ],
+        "properties": {
+          "operationId": {
+            "$ref": "#/$defs/root"
+          },
+          "readbacks": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "$ref": "#/$defs/observation"
+            }
+          },
+          "apply": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "outcome",
+              "code",
+              "classification"
+            ],
+            "properties": {
+              "outcome": {
+                "enum": [
+                  "applied",
+                  "transient",
+                  "conflict"
+                ]
+              },
+              "code": {
+                "type": "string",
+                "minLength": 1
+              },
+              "classification": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        }
+      }
+    },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "platform",
+        "declaredEnvironment",
+        "externalEffects"
+      ],
+      "properties": {
+        "platform": {
+          "const": "portable"
+        },
+        "declaredEnvironment": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z][A-Z0-9_]*$"
+          }
+        },
+        "externalEffects": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "capabilityId",
+              "adapter",
+              "kind"
+            ],
+            "properties": {
+              "capabilityId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "adapter": {
+                "type": "string",
+                "minLength": 1
+              },
+              "kind": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "root": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*\\\\).+$"
+    },
+    "observation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "subjectRoot",
+        "targetRoot",
+        "evidenceRoots",
+        "providerCode"
+      ],
+      "properties": {
+        "outcome": {
+          "enum": [
+            "observed",
+            "absent",
+            "transient",
+            "conflict"
+          ]
+        },
+        "subjectRoot": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/root"
+            },
+            {
+              "const": ""
+            }
+          ]
+        },
+        "targetRoot": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/root"
+            },
+            {
+              "const": ""
+            }
+          ]
+        },
+        "evidenceRoots": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/root"
+          }
+        },
+        "providerCode": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}

package/dist/site/schemas/release-tail-capabilities-v1.schema.json ADDED Viewed

@@ -0,0 +1,353 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/release-tail-capabilities-v1.schema.json",
+  "title": "Buildchain release-tail capability declaration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract",
+    "schemaVersion",
+    "transactionPolicy",
+    "subject",
+    "capabilities"
+  ],
+  "properties": {
+    "contract": {
+      "const": "kungfu-buildchain-release-tail-capabilities"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "transactionPolicy": {
+      "const": "buildchain.release-tail/v1"
+    },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repository",
+        "sourceSha",
+        "version",
+        "tag",
+        "channel"
+      ],
+      "properties": {
+        "repository": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sourceSha": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "tag": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channel": {
+          "enum": [
+            "alpha",
+            "release",
+            "stable"
+          ]
+        }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/capability"
+      }
+    }
+  },
+  "$defs": {
+    "root": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "executor",
+        "adapter",
+        "artifactRoles",
+        "destination",
+        "channelPolicy",
+        "activationPolicy",
+        "readbackPredicates",
+        "effect",
+        "observation",
+        "receipt",
+        "operationIdentity",
+        "idempotency",
+        "retry",
+        "evidenceRequirements"
+      ],
+      "properties": {
+        "id": {
+          "enum": [
+            "artifact.publish",
+            "signed-channel.commit",
+            "release.activate",
+            "released-evidence.synthesize"
+          ]
+        },
+        "executor": {
+          "enum": [
+            "buildchain-core",
+            "provider-adapter"
+          ]
+        },
+        "adapter": {
+          "type": "string",
+          "minLength": 1
+        },
+        "artifactRoles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "role",
+              "root"
+            ],
+            "properties": {
+              "role": {
+                "type": "string",
+                "minLength": 1
+              },
+              "root": {
+                "$ref": "#/$defs/root"
+              }
+            }
+          }
+        },
+        "destination": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "locator"
+          ],
+          "properties": {
+            "kind": {
+              "type": "string",
+              "minLength": 1
+            },
+            "locator": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "channelPolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "channel",
+            "tagPattern",
+            "authorityMove"
+          ],
+          "properties": {
+            "channel": {
+              "enum": [
+                "alpha",
+                "release",
+                "stable"
+              ]
+            },
+            "tagPattern": {
+              "type": "string",
+              "minLength": 1
+            },
+            "authorityMove": {
+              "enum": [
+                "none",
+                "signed-cas",
+                "verified-ref"
+              ]
+            }
+          }
+        },
+        "activationPolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "mode",
+            "environment"
+          ],
+          "properties": {
+            "mode": {
+              "enum": [
+                "none",
+                "receipt-set",
+                "receipt-only"
+              ]
+            },
+            "environment": {
+              "enum": [
+                "none",
+                "shadow",
+                "production"
+              ]
+            }
+          }
+        },
+        "readbackPredicates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "kind",
+              "expected"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "kind": {
+                "type": "string",
+                "minLength": 1
+              },
+              "expected": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        },
+        "effect": {
+          "$ref": "#/$defs/message"
+        },
+        "observation": {
+          "$ref": "#/$defs/message"
+        },
+        "receipt": {
+          "$ref": "#/$defs/message"
+        },
+        "operationIdentity": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "transactionRoot",
+            "capabilityId",
+            "subjectRoot",
+            "targetRoot",
+            "attemptKey"
+          ],
+          "properties": {
+            "transactionRoot": {
+              "$ref": "#/$defs/root"
+            },
+            "capabilityId": {
+              "enum": [
+                "artifact.publish",
+                "signed-channel.commit",
+                "release.activate",
+                "released-evidence.synthesize"
+              ]
+            },
+            "subjectRoot": {
+              "$ref": "#/$defs/root"
+            },
+            "targetRoot": {
+              "$ref": "#/$defs/root"
+            },
+            "attemptKey": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "idempotency": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "scope",
+            "duplicate"
+          ],
+          "properties": {
+            "scope": {
+              "enum": [
+                "operation",
+                "subject-target"
+              ]
+            },
+            "duplicate": {
+              "enum": [
+                "return-observed-receipt",
+                "readback-before-retry"
+              ]
+            }
+          }
+        },
+        "retry": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "class",
+            "localAttempts",
+            "exhausted"
+          ],
+          "properties": {
+            "class": {
+              "enum": [
+                "never",
+                "readback",
+                "provider-transient"
+              ]
+            },
+            "localAttempts": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 3
+            },
+            "exhausted": {
+              "enum": [
+                "blocked",
+                "repair-required",
+                "terminal-failure"
+              ]
+            }
+          }
+        },
+        "evidenceRequirements": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "message": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "schema"
+      ],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schema": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}

package/dist/site/schemas/release-tail-provider-bindings-v1.schema.json ADDED Viewed

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/release-tail-provider-bindings-v1.schema.json",
+  "title": "Buildchain release-tail provider bindings",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "artifacts",
+    "documents",
+    "evidence"
+  ],
+  "properties": {
+    "schema": {
+      "const": "kungfu.buildchain.release-tail.provider-bindings/v1"
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "path",
+          "name"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "documents": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "signed-channel.commit": {
+          "$ref": "#/$defs/document"
+        },
+        "release.activate": {
+          "$ref": "#/$defs/document"
+        }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "inputs",
+        "output"
+      ],
+      "properties": {
+        "inputs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "output": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "$defs": {
+    "document": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "method"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "method": {
+          "enum": [
+            "PUT",
+            "POST"
+          ]
+        }
+      }
+    }
+  }
+}