@h-rig/docs-drift-plugin 0.0.6-alpha.157 → 0.0.6-alpha.158

package/dist/src/drift/plugin.js

@@ -395,9 +395,6 @@ function requireNoExtraArgs(args, usage) {
     throw new Error(`Unexpected argument: ${args[0]}
 Usage: ${usage}`);
 }
-function parseCsv(value) {
-  return value?.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0) ?? [];
-}
 function driftSummary(report) {
   const highConfidence = highConfidenceDriftFindings(report).length;
   return { total: report.findings.length, highConfidence, degraded: report.degraded };
@@ -408,8 +405,8 @@ async function executeDrift(context, args, options = {}) {
   const ignore = takeOption(docs.rest, "--ignore");
   const failOnDrift = takeFlag(ignore.rest, "--fail-on-drift");
   requireNoExtraArgs(failOnDrift.rest, "rig drift [--docs <csv>] [--ignore <csv>] [--fail-on-drift] [--json]");
-  const docsGlobs = parseCsv(docs.value);
-  const ignoreGlobs = parseCsv(ignore.value);
+  const docsGlobs = docs.value?.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0) ?? [];
+  const ignoreGlobs = ignore.value?.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0) ?? [];
   const effectiveDocsGlobs = docsGlobs.length > 0 ? docsGlobs : options.docsGlobs;
   const effectiveIgnoreGlobs = ignoreGlobs.length > 0 ? ignoreGlobs : options.ignoreGlobs;
   const effectiveFailOnDrift = failOnDrift.value || options.failOnDrift === true;

package/dist/src/plugin.js

@@ -444,9 +444,6 @@ function requireNoExtraArgs(args, usage) {
     throw new Error(`Unexpected argument: ${args[0]}
 Usage: ${usage}`);
 }
-function parseCsv(value) {
-  return value?.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0) ?? [];
-}
 function driftSummary(report) {
   const highConfidence = highConfidenceDriftFindings(report).length;
   return { total: report.findings.length, highConfidence, degraded: report.degraded };
@@ -457,8 +454,8 @@ async function executeDrift(context, args, options = {}) {
   const ignore = takeOption(docs.rest, "--ignore");
   const failOnDrift = takeFlag(ignore.rest, "--fail-on-drift");
   requireNoExtraArgs(failOnDrift.rest, "rig drift [--docs <csv>] [--ignore <csv>] [--fail-on-drift] [--json]");
-  const docsGlobs = parseCsv(docs.value);
-  const ignoreGlobs = parseCsv(ignore.value);
+  const docsGlobs = docs.value?.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0) ?? [];
+  const ignoreGlobs = ignore.value?.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0) ?? [];
   const effectiveDocsGlobs = docsGlobs.length > 0 ? docsGlobs : options.docsGlobs;
   const effectiveIgnoreGlobs = ignoreGlobs.length > 0 ? ignoreGlobs : options.ignoreGlobs;
   const effectiveFailOnDrift = failOnDrift.value || options.failOnDrift === true;
@@ -622,34 +619,19 @@ function createStandardDocsDriftPlugin(opts = {}) {
     name: "@rig/standard-plugin:docs-drift",
     version: "0.1.0",
     contributes: {
-      validators: [DOCS_DRIFT_VALIDATOR],
+      validators: [createLazyDocsDriftValidator(opts)],
       capabilities: [
         { id: DOCS_DRIFT_CAPABILITY_ID, title: "Documentation drift detection", commandId: DOCS_DRIFT_CLI_ID, panelId: DOCS_HEALTH_PANEL_ID }
       ],
       panels: [
-        { id: DOCS_HEALTH_PANEL_ID, slot: "capability", title: "Documentation drift", capabilityId: DOCS_DRIFT_CAPABILITY_ID }
+        { id: DOCS_HEALTH_PANEL_ID, slot: "capability", title: "Documentation drift", capabilityId: DOCS_DRIFT_CAPABILITY_ID, produce: createDocsHealthPanelProducer(opts) }
       ],
-      cliCommands: [
-        {
-          id: DOCS_DRIFT_CLI_ID,
-          family: "drift",
-          command: DOCS_DRIFT_CLI_COMMAND,
-          description: "Scan documentation for stale code references.",
-          projectRequired: true
-        }
+      cliCommands: [createLazyDocsDriftRuntimeCliCommand(opts)],
+      stages: [
+        { id: DOCS_DRIFT_STAGE_ID, kind: "gate", priority: 0, protected: false, run: createLazyDocsDriftGateStage(opts) }
       ],
       stageMutations: [DOCS_DRIFT_STAGE_MUTATION]
     }
-  }, {
-    validators: [createLazyDocsDriftValidator(opts)],
-    stages: { [DOCS_DRIFT_STAGE_ID]: createLazyDocsDriftGateStage(opts) },
-    featureCapabilities: [
-      { id: DOCS_DRIFT_CAPABILITY_ID, title: "Documentation drift detection", commandId: DOCS_DRIFT_CLI_ID, panelId: DOCS_HEALTH_PANEL_ID }
-    ],
-    panels: [
-      { id: DOCS_HEALTH_PANEL_ID, slot: "capability", title: "Documentation drift", capabilityId: DOCS_DRIFT_CAPABILITY_ID, produce: createDocsHealthPanelProducer(opts) }
-    ],
-    cliCommands: [createLazyDocsDriftRuntimeCliCommand(opts)]
   });
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/docs-drift-plugin",
-  "version": "0.0.6-alpha.157",
+  "version": "0.0.6-alpha.158",
   "type": "module",
   "description": "First-party documentation drift detection capability plugin for Rig.",
   "license": "UNLICENSED",
@@ -26,8 +26,8 @@
     "bun": ">=1.3.11"
   },
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.157",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.157",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.158",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.158",
     "effect": "4.0.0-beta.90"
   }
 }

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

@@ -1,24 +0,0 @@
-import type { DriftConfidence, DriftFinding, DriftKind, DriftReport } from "@rig/contracts";
-export interface DriftScanInput {
-    readonly projectRoot: string;
-    readonly docsGlobs?: readonly string[];
-    readonly ignoreGlobs?: readonly string[];
-    readonly judge?: boolean;
-}
-export type DriftDetector = (input: DriftScanInput) => Promise<DriftReport> | DriftReport;
-export interface DriftSummary {
-    readonly total: number;
-    readonly highConfidence: number;
-    readonly byKind: Readonly<Record<DriftKind, number>>;
-    readonly byConfidence: Readonly<Record<DriftConfidence, number>>;
-    readonly degraded: boolean;
-}
-export declare function runDriftScan(projectRoot: string, deps: {
-    readonly detectDrift: DriftDetector;
-}, options?: Omit<DriftScanInput, "projectRoot">): Promise<DriftReport>;
-export declare function summarizeDriftReport(report: DriftReport): DriftSummary;
-export declare function driftFindingsByDocument(report: DriftReport): ReadonlyMap<string, readonly DriftFinding[]>;
-export declare function shouldFailOnDrift(report: DriftReport, options?: {
-    readonly failOnDrift?: boolean;
-    readonly minimumConfidence?: DriftConfidence;
-}): boolean;

package/dist/src/drift/summary.js

@@ -1,42 +0,0 @@
-// @bun
-// packages/docs-drift-plugin/src/drift/summary.ts
-var DRIFT_KINDS = ["deleted-reference", "stale-anchor", "semantic-mismatch", "issue-mismatch"];
-var DRIFT_CONFIDENCES = ["high", "medium", "low"];
-async function runDriftScan(projectRoot, deps, options = {}) {
-  return deps.detectDrift({ projectRoot, ...options });
-}
-function summarizeDriftReport(report) {
-  const byKind = Object.fromEntries(DRIFT_KINDS.map((kind) => [kind, 0]));
-  const byConfidence = Object.fromEntries(DRIFT_CONFIDENCES.map((confidence) => [confidence, 0]));
-  for (const finding of report.findings) {
-    byKind[finding.kind] += 1;
-    byConfidence[finding.confidence] += 1;
-  }
-  return {
-    total: report.findings.length,
-    highConfidence: byConfidence.high,
-    byKind,
-    byConfidence,
-    degraded: report.degraded
-  };
-}
-function driftFindingsByDocument(report) {
-  const grouped = new Map;
-  for (const finding of report.findings) {
-    grouped.set(finding.docPath, [...grouped.get(finding.docPath) ?? [], finding]);
-  }
-  return new Map([...grouped.entries()].map(([path, findings]) => [path, findings.toSorted((left, right) => (left.line ?? 0) - (right.line ?? 0))]));
-}
-function shouldFailOnDrift(report, options = {}) {
-  if (!options.failOnDrift)
-    return false;
-  const threshold = options.minimumConfidence ?? "high";
-  const rank = { high: 3, medium: 2, low: 1 };
-  return report.findings.some((finding) => rank[finding.confidence] >= rank[threshold]);
-}
-export {
-  summarizeDriftReport,
-  shouldFailOnDrift,
-  runDriftScan,
-  driftFindingsByDocument
-};