@h-rig/standard-plugin 0.0.6-alpha.135 → 0.0.6-alpha.136

package/dist/src/drift/plugin.d.ts

@@ -1,4 +1,4 @@
-import { type DriftFinding, type DriftReport, type StageMutation, type StageResult, type ValidatorRegistration } from "@rig/contracts";
+import { type DriftFinding, type DriftReport, type StageMutation, type StageResult, type StageRun, type ValidatorRegistration } from "@rig/contracts";
 import type { RegisteredValidator, ValidatorResult } from "@rig/core";
 import { type DriftDetectOptions } from "./detect";
 export interface DocsDriftPluginOptions {
@@ -14,6 +14,13 @@ export declare const DOCS_DRIFT_STAGE_MUTATION: StageMutation;
 export declare const DOCS_DRIFT_CLI_COMMAND = "bun -e 'import { runDriftCli } from \"@rig/standard-plugin/drift\"; process.exitCode = await runDriftCli(process.argv.slice(1), { projectRoot: process.cwd() });' --";
 export declare function highConfidenceDriftFindings(report: DriftReport): readonly DriftFinding[];
 export declare function driftGateResult(report: DriftReport, mode?: "observe" | "enforce"): StageResult;
+/**
+ * Executable for the `docs-drift` pre-merge gate stage (inserted by
+ * DOCS_DRIFT_STAGE_MUTATION before `merge-gate`). Reads the project root from the
+ * stage context metadata, runs deletion-survival drift detection, and blocks the
+ * pipeline on high-confidence drift when enforcing (`failOnDrift`), else observes.
+ */
+export declare function createDocsDriftGateStage(options?: DocsDriftPluginOptions): StageRun;
 export declare function runDocsDriftValidation(options: DriftDetectOptions & {
     failOnDrift?: boolean;
 }): Promise<ValidatorResult>;

package/dist/src/drift/plugin.js

@@ -312,7 +312,7 @@ var DOCS_DRIFT_STAGE_MUTATION = Schema.decodeUnknownSync(StageMutationSchema)({
     id: DOCS_DRIFT_STAGE_ID,
     kind: "gate",
     before: ["merge-gate"],
-    after: ["verify"]
+    after: ["open-pr"]
   },
   contributedBy: DOCS_DRIFT_STAGE_ID
 });
@@ -327,6 +327,17 @@ function driftGateResult(report, mode = "enforce") {
   }
   return { kind: "allow" };
 }
+function createDocsDriftGateStage(options = {}) {
+  return async (ctx) => {
+    const projectRoot = typeof ctx.metadata?.projectRoot === "string" ? ctx.metadata.projectRoot : process.cwd();
+    const report = await detectDrift({
+      projectRoot,
+      ...options.docsGlobs !== undefined ? { docsGlobs: options.docsGlobs } : {},
+      ...options.ignoreGlobs !== undefined ? { ignoreGlobs: options.ignoreGlobs } : {}
+    });
+    return driftGateResult(report, options.failOnDrift ? "enforce" : "observe");
+  };
+}
 async function runDocsDriftValidation(options) {
   const report = await detectDrift(options);
   const high = highConfidenceDriftFindings(report);
@@ -412,6 +423,7 @@ export {
   highConfidenceDriftFindings,
   driftGateResult,
   createDocsDriftValidator,
+  createDocsDriftGateStage,
   DOCS_DRIFT_VALIDATOR_ID,
   DOCS_DRIFT_VALIDATOR,
   DOCS_DRIFT_STAGE_MUTATION,

package/dist/src/index.js

@@ -1294,7 +1294,7 @@ var DOCS_DRIFT_STAGE_MUTATION = Schema.decodeUnknownSync(StageMutationSchema)({
     id: DOCS_DRIFT_STAGE_ID,
     kind: "gate",
     before: ["merge-gate"],
-    after: ["verify"]
+    after: ["open-pr"]
   },
   contributedBy: DOCS_DRIFT_STAGE_ID
 });
@@ -1309,6 +1309,17 @@ function driftGateResult(report, mode = "enforce") {
   }
   return { kind: "allow" };
 }
+function createDocsDriftGateStage(options = {}) {
+  return async (ctx) => {
+    const projectRoot = typeof ctx.metadata?.projectRoot === "string" ? ctx.metadata.projectRoot : process.cwd();
+    const report = await detectDrift({
+      projectRoot,
+      ...options.docsGlobs !== undefined ? { docsGlobs: options.docsGlobs } : {},
+      ...options.ignoreGlobs !== undefined ? { ignoreGlobs: options.ignoreGlobs } : {}
+    });
+    return driftGateResult(report, options.failOnDrift ? "enforce" : "observe");
+  };
+}
 async function runDocsDriftValidation(options) {
   const report = await detectDrift(options);
   const high = highConfidenceDriftFindings(report);
@@ -1474,6 +1485,7 @@ function standardPlugin(opts = {}) {
     }
   }, {
     validators: [createDocsDriftValidator(opts.drift)],
+    stages: { [DOCS_DRIFT_STAGE_ID]: createDocsDriftGateStage(opts.drift) },
     taskSources: [
       {
         id: "std:github-issues",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/standard-plugin",
-  "version": "0.0.6-alpha.135",
+  "version": "0.0.6-alpha.136",
   "type": "module",
   "description": "First-party contribution bundle for Rig's OMP extension plugin graph; not a standalone plugin runtime.",
   "license": "UNLICENSED",
@@ -29,8 +29,8 @@
   "module": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.135",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.135",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.136",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.136",
     "effect": "https://pkg.pr.new/Effect-TS/effect-smol/effect@8881a9b"
   }
 }