@h-rig/bundle-default-lifecycle 0.0.6-alpha.136 → 0.0.6-alpha.137

package/dist/src/cli.d.ts

@@ -0,0 +1,27 @@
+import type { RuntimeCliContext } from "@rig/core";
+export declare const DEFAULT_PIPELINE_CLI_ID = "default-lifecycle.pipeline";
+export declare const DEFAULT_KERNEL_CLI_ID = "default-lifecycle.kernel";
+type CommandOutcome = {
+    readonly ok: boolean;
+    readonly group: string;
+    readonly command: string;
+    readonly details?: Record<string, unknown>;
+};
+export declare function executePipeline(context: RuntimeCliContext, args: readonly string[]): Promise<CommandOutcome>;
+export declare function executeKernel(context: RuntimeCliContext, args: readonly string[]): Promise<CommandOutcome>;
+export declare const defaultLifecycleCliCommands: readonly [{
+    readonly id: "default-lifecycle.pipeline";
+    readonly family: "pipeline";
+    readonly command: "rig pipeline show [--json]";
+    readonly description: "Show the resolved default lifecycle pipeline.";
+    readonly usage: "rig pipeline show [--json]";
+    readonly run: typeof executePipeline;
+}, {
+    readonly id: "default-lifecycle.kernel";
+    readonly family: "kernel";
+    readonly command: "rig kernel status [--json]";
+    readonly description: "Show default kernel provider and lifecycle status.";
+    readonly usage: "rig kernel status [--json]";
+    readonly run: typeof executeKernel;
+}];
+export {};

package/dist/src/cli.js

@@ -0,0 +1,279 @@
+// @bun
+// packages/bundle-default-lifecycle/src/defaultPipeline.ts
+import { resolveKernelStages } from "@rig/kernel/resolver";
+import { createDefaultKernelPlugin } from "@rig/kernel/default-kernel";
+
+// packages/bundle-default-lifecycle/src/stages/auto-merge.ts
+import { runRepoDefaultMerge } from "@rig/runtime/control-plane/native/pr-automation";
+
+// packages/bundle-default-lifecycle/src/stages/types.ts
+function defineDefaultLifecycleStage(input) {
+  return {
+    ...input,
+    priority: input.priority ?? 0
+  };
+}
+
+// packages/bundle-default-lifecycle/src/stages/auto-merge.ts
+var autoMergeStage = defineDefaultLifecycleStage({
+  id: "auto-merge",
+  kind: "transform",
+  description: "Merge an approved PR using the repository default merge method through the runtime helper.",
+  calls: ["runRepoDefaultMerge"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/commit.ts
+import { commitRunChanges } from "@rig/runtime/control-plane/native/pr-automation";
+var commitStage = defineDefaultLifecycleStage({
+  id: "commit",
+  kind: "transform",
+  description: "Commit the agent worktree changes using the runtime git closeout helper.",
+  calls: ["commitRunChanges"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/isolation.ts
+import { ensureAgentRuntime } from "@rig/runtime/control-plane/runtime/isolation";
+var isolationStage = defineDefaultLifecycleStage({
+  id: "isolation",
+  kind: "transform",
+  description: "Provision the isolated runtime worktree through the runtime isolation subsystem.",
+  calls: ["ensureAgentRuntime"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/journal-append.ts
+var journalAppendStage = defineDefaultLifecycleStage({
+  id: "journal-append",
+  kind: "observe",
+  description: "Record resolved pipeline and per-stage outcome entries through the kernel journal capability.",
+  calls: ["journalCapability.append"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/merge-gate.ts
+import {
+  runStrictPrMergeGate
+} from "@rig/runtime/control-plane/native/pr-review-gate";
+var mergeGateStage = defineDefaultLifecycleStage({
+  id: "merge-gate",
+  kind: "gate",
+  description: "Enforce GitHub review state, required checks, and configured review gates through runtime PR automation.",
+  calls: ["runStrictPrMergeGate"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/open-pr.ts
+import { runPrAutomation } from "@rig/runtime/control-plane/native/pr-automation";
+var openPrStage = defineDefaultLifecycleStage({
+  id: "open-pr",
+  kind: "transform",
+  description: "Open or reuse the closeout PR through the existing runtime PR automation seam.",
+  calls: ["runPrAutomation"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/push.ts
+import { pushBranchSyncedWithOrigin } from "@rig/runtime/control-plane/native/pr-automation";
+var pushStage = defineDefaultLifecycleStage({
+  id: "push",
+  kind: "transform",
+  description: "Synchronize and push the task branch using the runtime closeout git helper.",
+  calls: ["pushBranchSyncedWithOrigin"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/source-closeout.ts
+import { closeIssueAfterMergedPr } from "@rig/runtime/control-plane/native/pr-automation";
+var sourceCloseoutStage = defineDefaultLifecycleStage({
+  id: "source-closeout",
+  kind: "transform",
+  description: "Reflect the merged PR into the task source using the existing runtime closeout helper.",
+  calls: ["closeIssueAfterMergedPr"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/validate.ts
+var validateStage = defineDefaultLifecycleStage({
+  id: "validate",
+  kind: "transform",
+  description: "Run plugin-host validators against the isolated worktree before closeout side effects.",
+  calls: ["taskValidate"]
+});
+
+// packages/bundle-default-lifecycle/src/stages/verify.ts
+var verifyStage = defineDefaultLifecycleStage({
+  id: "verify",
+  kind: "gate",
+  description: "Run the local verifier preflight and block closeout when it rejects the worktree.",
+  calls: ["verifierPreflight"]
+});
+
+// packages/bundle-default-lifecycle/src/defaultPipeline.ts
+var DEFAULT_STAGE_AFTER = {
+  verify: ["validate"],
+  commit: ["verify"],
+  push: ["commit"],
+  "open-pr": ["push"],
+  "merge-gate": ["open-pr"],
+  "auto-merge": ["merge-gate"],
+  "source-closeout": ["auto-merge"],
+  isolation: ["source-closeout"],
+  "journal-append": ["isolation"]
+};
+function withDefaultAnchors(stage) {
+  const after = DEFAULT_STAGE_AFTER[stage.id];
+  return after ? { ...stage, after } : stage;
+}
+var defaultLifecycleStages = [
+  validateStage,
+  verifyStage,
+  commitStage,
+  pushStage,
+  openPrStage,
+  mergeGateStage,
+  autoMergeStage,
+  sourceCloseoutStage,
+  isolationStage,
+  journalAppendStage
+].map(withDefaultAnchors);
+function resolveDefaultLifecycle(input = {}) {
+  return resolveKernelStages(defaultLifecycleStages, input.mutations ?? []);
+}
+function defaultPipelineShowData(input = {}) {
+  const resolved = resolveDefaultLifecycle(input);
+  const orderIndex = new Map(resolved.order.map((id, index) => [id, index + 1]));
+  const stages = resolved.record.map((entry) => ({
+    index: orderIndex.get(entry.stageId) ?? null,
+    id: entry.stageId,
+    contributedBy: entry.contributedBy,
+    ...entry.removedBy !== undefined ? { removedBy: entry.removedBy } : {},
+    ...entry.replacedBy !== undefined ? { replacedBy: entry.replacedBy } : {},
+    wrappedBy: entry.wrappedBy ?? [],
+    droppedAnchors: entry.droppedAnchors ?? []
+  }));
+  return {
+    title: `resolved run pipeline (${resolved.order.length} stages)`,
+    stageCount: resolved.order.length,
+    stages,
+    droppedAnchors: stages.flatMap((stage) => stage.droppedAnchors.map((anchor) => `${stage.id}:${anchor}`)),
+    cycles: resolved.cycles,
+    ...resolved.resolvedAt !== undefined ? { resolvedAt: resolved.resolvedAt } : {}
+  };
+}
+function defaultKernelStatusData() {
+  const plugin = createDefaultKernelPlugin();
+  const resolved = resolveDefaultLifecycle();
+  const capabilities = {};
+  for (const capability of plugin.provides)
+    capabilities[capability] = plugin.meta.id;
+  return {
+    kernelProviderId: plugin.meta.id,
+    kernelVersion: plugin.meta.version,
+    capabilities,
+    pipelineStageCount: resolved.order.length,
+    stageOrder: [...resolved.order]
+  };
+}
+function formatKernelStatus(data = defaultKernelStatusData()) {
+  const lines = [
+    `kernel: ${data.kernelProviderId} v${data.kernelVersion}`,
+    "capabilities (resolved provider):",
+    ...Object.entries(data.capabilities).map(([cap, provider]) => `  ${cap.padEnd(14)} ${provider}`),
+    `lifecycle stages: mutable`,
+    `resolved pipeline (${data.pipelineStageCount} stages): ${data.stageOrder.join(" -> ")}`
+  ];
+  return lines.join(`
+`);
+}
+function formatDefaultPipelineShow(input = {}) {
+  const data = defaultPipelineShowData(input);
+  const lines = [`${data.title}:`];
+  for (const stage of data.stages) {
+    if (stage.removedBy) {
+      lines.push(`  - ${stage.id.padEnd(20)} [${stage.contributedBy}] removed by [${stage.removedBy}]`);
+      continue;
+    }
+    const ordinal = stage.index === null ? " -." : `${String(stage.index).padStart(2)}.`;
+    const annotations = [
+      stage.replacedBy ? `replaced by [${stage.replacedBy}]` : "",
+      stage.wrappedBy.length > 0 ? `wrapped by [${stage.wrappedBy.join(", ")}]` : ""
+    ].filter(Boolean);
+    lines.push(`  ${ordinal} ${stage.id.padEnd(20)} [${stage.contributedBy}]${annotations.length > 0 ? ` ${annotations.join("  ")}` : ""}`);
+  }
+  lines.push(`dropped anchors: ${data.droppedAnchors.length > 0 ? data.droppedAnchors.join(", ") : "none"}      cycles: ${data.cycles.length > 0 ? data.cycles.map((cycle) => cycle.join(" -> ")).join(", ") : "none"}`);
+  return lines.join(`
+`);
+}
+
+// packages/bundle-default-lifecycle/src/cli.ts
+var DEFAULT_PIPELINE_CLI_ID = "default-lifecycle.pipeline";
+var DEFAULT_KERNEL_CLI_ID = "default-lifecycle.kernel";
+function printJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+function takeFlag(args, flag) {
+  const rest = [...args];
+  const index = rest.indexOf(flag);
+  if (index < 0)
+    return { value: false, rest };
+  rest.splice(index, 1);
+  return { value: true, rest };
+}
+function requireNoExtraArgs(args, usage) {
+  if (args.length > 0)
+    throw new Error(`Unexpected argument: ${args[0]}
+Usage: ${usage}`);
+}
+async function executePipeline(context, args) {
+  const [first = "show", ...rest] = args;
+  const command = first.startsWith("-") ? "show" : first;
+  const commandArgs = first.startsWith("-") ? args : rest;
+  if (command !== "show")
+    throw new Error(`Unknown pipeline command: ${command}`);
+  const json = takeFlag(commandArgs, "--json");
+  requireNoExtraArgs(json.rest, "rig pipeline show [--json]");
+  const details = defaultPipelineShowData();
+  if (context.outputMode === "text") {
+    if (json.value)
+      printJson(details);
+    else
+      console.log(formatDefaultPipelineShow());
+  }
+  return { ok: true, group: "pipeline", command: "show", details };
+}
+async function executeKernel(context, args) {
+  const [first = "status", ...rest] = args;
+  const command = first.startsWith("-") ? "status" : first;
+  const commandArgs = first.startsWith("-") ? args : rest;
+  if (command !== "status")
+    throw new Error(`Unknown kernel command: ${command}`);
+  const json = takeFlag(commandArgs, "--json");
+  requireNoExtraArgs(json.rest, "rig kernel status [--json]");
+  const details = defaultKernelStatusData();
+  if (context.outputMode === "text") {
+    if (json.value)
+      printJson(details);
+    else
+      console.log(formatKernelStatus(details));
+  }
+  return { ok: true, group: "kernel", command: "status", details };
+}
+var defaultLifecycleCliCommands = [
+  {
+    id: DEFAULT_PIPELINE_CLI_ID,
+    family: "pipeline",
+    command: "rig pipeline show [--json]",
+    description: "Show the resolved default lifecycle pipeline.",
+    usage: "rig pipeline show [--json]",
+    run: executePipeline
+  },
+  {
+    id: DEFAULT_KERNEL_CLI_ID,
+    family: "kernel",
+    command: "rig kernel status [--json]",
+    description: "Show default kernel provider and lifecycle status.",
+    usage: "rig kernel status [--json]",
+    run: executeKernel
+  }
+];
+export {
+  executePipeline,
+  executeKernel,
+  defaultLifecycleCliCommands,
+  DEFAULT_PIPELINE_CLI_ID,
+  DEFAULT_KERNEL_CLI_ID
+};

package/dist/src/defaultPipeline.d.ts

@@ -1,12 +1,10 @@
-import type { ProtectedStageGrant, StageMutation } from "@rig/contracts";
+import type { StageMutation } from "@rig/contracts";
 import { type KernelStageResolverResult } from "@rig/kernel/resolver";
 import type { DefaultLifecycleStageDescriptor, DefaultLifecycleStageId } from "./stages/types";
 export declare const DEFAULT_LIFECYCLE_STAGE_IDS: readonly ["validate", "verify", "commit", "push", "open-pr", "merge-gate", "auto-merge", "source-closeout", "isolation", "journal-append"];
-export declare const PROTECTED_DEFAULT_LIFECYCLE_STAGE_IDS: readonly ["merge-gate", "isolation", "journal-append"];
 export declare const defaultLifecycleStages: readonly DefaultLifecycleStageDescriptor[];
 export type ResolveDefaultLifecycleInput = {
     readonly mutations?: readonly StageMutation[];
-    readonly protectedStageGrants?: readonly ProtectedStageGrant[];
 };
 export declare function defaultLifecycleStageById(id: DefaultLifecycleStageId): DefaultLifecycleStageDescriptor;
 export declare function resolveDefaultLifecycle(input?: ResolveDefaultLifecycleInput): KernelStageResolverResult;
@@ -14,7 +12,6 @@ export type PipelineShowStage = {
     readonly index: number | null;
     readonly id: string;
     readonly contributedBy: string;
-    readonly protected: boolean;
     readonly removedBy?: string;
     readonly replacedBy?: string;
     readonly wrappedBy: readonly string[];
@@ -33,15 +30,13 @@ export type KernelStatusData = {
     readonly kernelProviderId: string;
     readonly kernelVersion: string;
     readonly capabilities: Readonly<Record<string, string>>;
-    readonly protectedStages: readonly string[];
     readonly pipelineStageCount: number;
     readonly stageOrder: readonly string[];
 };
 /**
  * Data backing `rig kernel status`: the resolved provider per kernel capability,
- * the kernel version, the protected-stage set, and the resolved default
- * pipeline. Derived from the default kernel plugin so it reflects what actually
- * boots, not a hardcoded list.
+ * the kernel version, and the resolved default pipeline. Derived from the
+ * default kernel plugin so it reflects what actually boots, not a hardcoded list.
  */
 export declare function defaultKernelStatusData(): KernelStatusData;
 export declare function formatKernelStatus(data?: KernelStatusData): string;

package/dist/src/defaultPipeline.js

@@ -10,7 +10,6 @@ import { runRepoDefaultMerge } from "@rig/runtime/control-plane/native/pr-automa
 function defineDefaultLifecycleStage(input) {
   return {
     ...input,
-    protected: input.protected ?? false,
     priority: input.priority ?? 0
   };
 }
@@ -38,8 +37,7 @@ var isolationStage = defineDefaultLifecycleStage({
   id: "isolation",
   kind: "transform",
   description: "Provision the isolated runtime worktree through the runtime isolation subsystem.",
-  calls: ["ensureAgentRuntime"],
-  protected: true
+  calls: ["ensureAgentRuntime"]
 });
 
 // packages/bundle-default-lifecycle/src/stages/journal-append.ts
@@ -47,8 +45,7 @@ var journalAppendStage = defineDefaultLifecycleStage({
   id: "journal-append",
   kind: "observe",
   description: "Record resolved pipeline and per-stage outcome entries through the kernel journal capability.",
-  calls: ["journalCapability.append"],
-  protected: true
+  calls: ["journalCapability.append"]
 });
 
 // packages/bundle-default-lifecycle/src/stages/merge-gate.ts
@@ -59,8 +56,7 @@ var mergeGateStage = defineDefaultLifecycleStage({
   id: "merge-gate",
   kind: "gate",
   description: "Enforce GitHub review state, required checks, and configured review gates through runtime PR automation.",
-  calls: ["runStrictPrMergeGate"],
-  protected: true
+  calls: ["runStrictPrMergeGate"]
 });
 
 // packages/bundle-default-lifecycle/src/stages/open-pr.ts
@@ -119,7 +115,6 @@ var DEFAULT_LIFECYCLE_STAGE_IDS = [
   "isolation",
   "journal-append"
 ];
-var PROTECTED_DEFAULT_LIFECYCLE_STAGE_IDS = ["merge-gate", "isolation", "journal-append"];
 var DEFAULT_STAGE_AFTER = {
   verify: ["validate"],
   commit: ["verify"],
@@ -154,8 +149,7 @@ function defaultLifecycleStageById(id) {
   return stage;
 }
 function resolveDefaultLifecycle(input = {}) {
-  const grants = { protectedStageGrants: input.protectedStageGrants ?? [] };
-  return resolveKernelStages(defaultLifecycleStages, input.mutations ?? [], grants);
+  return resolveKernelStages(defaultLifecycleStages, input.mutations ?? []);
 }
 function defaultPipelineShowData(input = {}) {
   const resolved = resolveDefaultLifecycle(input);
@@ -164,7 +158,6 @@ function defaultPipelineShowData(input = {}) {
     index: orderIndex.get(entry.stageId) ?? null,
     id: entry.stageId,
     contributedBy: entry.contributedBy,
-    protected: entry.isProtected,
     ...entry.removedBy !== undefined ? { removedBy: entry.removedBy } : {},
     ...entry.replacedBy !== undefined ? { replacedBy: entry.replacedBy } : {},
     wrappedBy: entry.wrappedBy ?? [],
@@ -189,7 +182,6 @@ function defaultKernelStatusData() {
     kernelProviderId: plugin.meta.id,
     kernelVersion: plugin.meta.version,
     capabilities,
-    protectedStages: [...PROTECTED_DEFAULT_LIFECYCLE_STAGE_IDS],
     pipelineStageCount: resolved.order.length,
     stageOrder: [...resolved.order]
   };
@@ -199,7 +191,7 @@ function formatKernelStatus(data = defaultKernelStatusData()) {
     `kernel: ${data.kernelProviderId} v${data.kernelVersion}`,
     "capabilities (resolved provider):",
     ...Object.entries(data.capabilities).map(([cap, provider]) => `  ${cap.padEnd(14)} ${provider}`),
-    `protected stages: ${data.protectedStages.join(", ")}`,
+    `lifecycle stages: mutable`,
     `resolved pipeline (${data.pipelineStageCount} stages): ${data.stageOrder.join(" -> ")}`
   ];
   return lines.join(`
@@ -210,12 +202,11 @@ function formatDefaultPipelineShow(input = {}) {
   const lines = [`${data.title}:`];
   for (const stage of data.stages) {
     if (stage.removedBy) {
-      lines.push(`  - ${stage.id.padEnd(20)} [${stage.contributedBy}] removed by [${stage.removedBy}]${stage.protected ? " PROTECTED" : ""}`);
+      lines.push(`  - ${stage.id.padEnd(20)} [${stage.contributedBy}] removed by [${stage.removedBy}]`);
       continue;
     }
     const ordinal = stage.index === null ? " -." : `${String(stage.index).padStart(2)}.`;
     const annotations = [
-      stage.protected ? "PROTECTED" : "",
       stage.replacedBy ? `replaced by [${stage.replacedBy}]` : "",
       stage.wrappedBy.length > 0 ? `wrapped by [${stage.wrappedBy.join(", ")}]` : ""
     ].filter(Boolean);
@@ -233,6 +224,5 @@ export {
   defaultLifecycleStages,
   defaultLifecycleStageById,
   defaultKernelStatusData,
-  PROTECTED_DEFAULT_LIFECYCLE_STAGE_IDS,
   DEFAULT_LIFECYCLE_STAGE_IDS
 };

package/dist/src/index.d.ts

@@ -2,6 +2,7 @@ export * from "./closeoutEquivalence";
 export * from "./closeoutShadowHarness";
 export * from "./defaultPipeline";
 export * from "./pipelineCloseout";
+export * from "./cli";
 export * from "./plugin";
 export * from "./stages/auto-merge";
 export * from "./stages/commit";