@kungfu-tech/buildchain 2.9.0 → 2.9.1

package/bin/buildchain.mjs

@@ -21,6 +21,10 @@ import {
   explainReleaseLineDryRun,
   formatReleaseLineDryRun,
 } from "../packages/core/release-line-dry-run.js";
+import {
+  planReleaseLineBootstrap,
+  writeReleaseLineBootstrapVersionState,
+} from "../packages/core/release-line-bootstrap.js";
 import {
   collectGitHubReleasePassport,
   explainReleasePassport,
@@ -84,6 +88,8 @@ function usage() {
                                      [--tags <comma-list>] [--json]
   buildchain release dry-run --target-ref <ref> [--sha <sha>] [--source-ref <ref>]
                                       [--tags <comma-list>] [--json]
+  buildchain release line open --major <n> --minor <n> [--source-ref <ref>]
+                               [--initial-version <version>] [--write] [--json]
   buildchain release <inspect|recover|finalize|abort> ...
   buildchain transaction inspect ...
   buildchain collect github-release --tag <tag> [--repository <owner/repo>]
@@ -158,6 +164,7 @@ Examples:
   buildchain lifecycle run build --artifact-path dist --artifact-name "{repo}-{version}-{platform}"
   buildchain npm dry-run --json
   buildchain release --dry-run --target-ref alpha/v2/v2.0
+  buildchain release line open --major 2 --minor 10 --source-ref release/v2/v2.9 --json
   buildchain span --event native.build -- cmake --build build
   buildchain collect github-release --tag v2.2.0 --assets-dir dist --output-dir .buildchain/release-passport
   buildchain verify release-passport .buildchain/release-passport/buildchain.release.json
@@ -919,6 +926,46 @@ async function main(argv = process.argv.slice(2)) {
   }
 
   if (command === "release") {
+    if (args[0] === "line" && args[1] === "open") {
+      const lineArgs = args.slice(2);
+      const options = {
+        cwd: readFlag(lineArgs, "cwd", process.cwd()),
+        major: readFlag(lineArgs, "major", ""),
+        minor: readFlag(lineArgs, "minor", ""),
+        sourceRef: readFlag(lineArgs, "source-ref", ""),
+        initialVersion: readFlag(lineArgs, "initial-version", ""),
+      };
+      const result = readBooleanFlag(lineArgs, "write")
+        ? writeReleaseLineBootstrapVersionState({
+            ...options,
+            runVersionStateLifecycle: !readBooleanFlag(lineArgs, "skip-version-state-lifecycle"),
+            generatedAt: readFlag(lineArgs, "generated-at", ""),
+          })
+        : planReleaseLineBootstrap({
+            ...options,
+            requiredStatusCheck: readFlag(lineArgs, "required-status-check", "check"),
+            setDefault: !readBooleanFlag(lineArgs, "no-set-default"),
+            createAlphaPr: !readBooleanFlag(lineArgs, "no-alpha-pr"),
+            approvalCount: Number(readFlag(lineArgs, "approval-count", "1")),
+            bootstrapBranch: readFlag(lineArgs, "bootstrap-branch", ""),
+          });
+      if (readBooleanFlag(lineArgs, "json")) {
+        printJson(result);
+      } else {
+        process.stdout.write(`Buildchain release line bootstrap ${result.line}\n`);
+        process.stdout.write(`- source: ${result.source.ref}${result.source.sha ? ` (${result.source.sha})` : ""}\n`);
+        process.stdout.write(`- initial version: ${result.initialVersion}\n`);
+        process.stdout.write(`- dev: ${result.refs.dev}\n`);
+        process.stdout.write(`- alpha: ${result.refs.alpha}\n`);
+        process.stdout.write(`- release: ${result.refs.release}\n`);
+        process.stdout.write(`- version files: ${result.versionState.files.join(", ") || "none"}\n`);
+        if (result.changedFiles) {
+          process.stdout.write(`- changed files: ${result.changedFiles.join(", ") || "none"}\n`);
+        }
+        process.stdout.write(result.dryRun ? "No refs, branches, PRs, or files were modified.\n" : "Version-state files were updated in the working tree.\n");
+      }
+      return;
+    }
     const explainMode = args[0] === "dry-run" || args[0] === "explain";
     const releaseArgs = explainMode ? args.slice(1) : args;
     if (explainMode || readBooleanFlag(args, "dry-run")) {

package/dist/site/agent-index.json

@@ -10,6 +10,7 @@
     "manual-registry.json",
     "node-api-registry.json",
     "workflow-registry.json",
+    "public-surface-audit.json",
     "artifact-schemas.json",
     "buildchain-contract.json",
     "kfd-claims.json",

package/dist/site/artifact-schemas.json

@@ -21,6 +21,7 @@
     "manual-registry.json",
     "node-api-registry.json",
     "workflow-registry.json",
+    "public-surface-audit.json",
     "release-model.json",
     "artifact-schemas.json",
     "buildchain-contract.json",

package/dist/site/buildchain-contract.json

@@ -4,7 +4,7 @@
   "product": {
     "name": "Buildchain",
     "package": "@kungfu-tech/buildchain",
-    "version": "2.9.0",
+    "version": "2.9.1",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "majorLine": "v2",
@@ -344,7 +344,7 @@
         "README badge block checks and writes are generated from machine-readable repository facts"
       ],
       "breakingDigest": "sha256:90a73892b2d6c214048448d5f45df75639bdf7b7e8fefd9c596e04b087407bcc",
-      "auditDigest": "sha256:114de9f5a2cd5602bec3ff7599aae1a09858ff53a96b562ebe542d501d37eb46"
+      "auditDigest": "sha256:8e4538461494045932ca878773403dd27d02d8f4f6e13faa90a19f6534cf9ffe"
     },
     {
       "contractVersion": 1,
@@ -434,7 +434,7 @@
         "manual entries carry source file digests so downstream sites and agents can detect stale hand-written documentation"
       ],
       "breakingDigest": "sha256:7d0d2819e3a3e72989d9c57b5efe9d0bc0a79bc0f2c82a0c7b9d6c5a211a91f2",
-      "auditDigest": "sha256:cd21906acf183b9f5b456f7013581dd55e493b904551f00475cf6ea2f0030098"
+      "auditDigest": "sha256:2cc5b516507336464f2e75e9f74d64e9bb4c01efedeff1787e0fe533c3935934"
     },
     {
       "contractVersion": 1,
@@ -456,9 +456,9 @@
         "agents can discover supported Node APIs without importing internal file paths"
       ],
       "breakingDigest": "sha256:48f925608d3e2131d90936b07dc2a30341204cae3e6e785c0f77d61ad755c945",
-      "auditDigest": "sha256:10855957c6eac44c41c59518e1d1310e6efd735ed3b5e1eddff4f98296352717"
+      "auditDigest": "sha256:1d42b05c7ebd9ad02ffd18c7d8a2641853d17552cb87706a1d859a98c7e65c98"
     }
   ],
   "compatibilityDigest": "sha256:407d6d5ee6a96a34d2cc30db9ac64cf4b1819ab6d77bd7a57a07a124f22101ca",
-  "contractDigest": "sha256:45c8a3198664e76e58ff881befcac450a7db6cfd6bffb5bcd3db747a895c551e"
+  "contractDigest": "sha256:3a82cbfd0cf15f85dac51b6ab03e3c3ce20ca2f3355d5319d969c43758ebb900"
 }