@h-rig/standard-plugin 0.0.6-alpha.142 → 0.0.6-alpha.144

package/dist/src/cli-surface.d.ts

@@ -0,0 +1,5 @@
+import type { RigPluginWithRuntime } from "@rig/core/config";
+import type { CliCommandRegistration } from "@rig/contracts";
+export declare const STANDARD_CLI_SURFACE_PLUGIN_NAME = "@rig/standard-plugin:cli-surface";
+export declare const STANDARD_CLI_SURFACE_COMMAND_METADATA: readonly CliCommandRegistration[];
+export declare const standardCliSurfacePlugin: RigPluginWithRuntime;

package/dist/src/cli-surface.js

@@ -0,0 +1,55 @@
+// @bun
+// packages/standard-plugin/src/cli-surface.ts
+var STANDARD_CLI_SURFACE_PLUGIN_NAME = "@rig/standard-plugin:cli-surface";
+function standardCliCommand(family, options) {
+  return {
+    id: `${STANDARD_CLI_SURFACE_PLUGIN_NAME}:${family}`,
+    family,
+    description: options.description,
+    ...options.usage ? { usage: options.usage } : {},
+    ...options.aliases ? { aliases: [...options.aliases] } : {},
+    projectRequired: options.projectRequired ?? false
+  };
+}
+var STANDARD_CLI_SURFACE_COMMAND_METADATA = [
+  standardCliCommand("init", { description: "Initialize Rig project configuration." }),
+  standardCliCommand("setup", { description: "Install and inspect local Rig setup." }),
+  standardCliCommand("check", { description: "Run Rig setup checks.", usage: "rig check" }),
+  standardCliCommand("install", { description: "Install Rig distribution artifacts.", usage: "rig install [options]" }),
+  standardCliCommand("github", { description: "Manage GitHub auth and integration state." }),
+  standardCliCommand("doctor", { description: "Inspect Rig environment health." }),
+  standardCliCommand("repo", { description: "Manage repository state.", projectRequired: true }),
+  standardCliCommand("profile", { description: "Manage runtime profile settings." }),
+  standardCliCommand("review", { description: "Run review helpers.", projectRequired: true }),
+  standardCliCommand("git", { description: "Run Rig git automation.", projectRequired: true }),
+  standardCliCommand("harness", { description: "Inspect native harness integration." }),
+  standardCliCommand("pi", { description: "Inspect Pi/OMP runtime integration." }),
+  standardCliCommand("plugin", { description: "Inspect and run plugin compatibility commands." }),
+  standardCliCommand("queue", { description: "Inspect dispatch queue state.", projectRequired: true }),
+  standardCliCommand("agent", { description: "Run agent lifecycle helpers.", projectRequired: true }),
+  standardCliCommand("dist", { description: "Build and inspect Rig distributions." }),
+  standardCliCommand("workspace", { description: "Inspect workspace topology." }),
+  standardCliCommand("remote", { description: "Manage remote endpoints." }),
+  standardCliCommand("test", { description: "Run Rig test helpers." }),
+  standardCliCommand("inspect", { description: "Inspect live/project Rig state." }),
+  standardCliCommand("run", { description: "Dispatch and inspect runs.", projectRequired: true }),
+  standardCliCommand("task", { description: "List and inspect task-source tasks.", projectRequired: true }),
+  standardCliCommand("inbox", { description: "Inspect and resolve run inbox items.", projectRequired: true }),
+  standardCliCommand("stats", { description: "Inspect run statistics.", projectRequired: true }),
+  standardCliCommand("server", { description: "Manage selected local/remote execution server.", projectRequired: true }),
+  standardCliCommand("config", { description: "Inspect Rig configuration." }),
+  standardCliCommand("triage", { description: "Run issue triage helpers.", projectRequired: true })
+];
+var standardCliSurfacePlugin = {
+  name: STANDARD_CLI_SURFACE_PLUGIN_NAME,
+  version: "0.0.0-alpha.1",
+  contributes: {
+    capabilities: [{ id: "surface.cli", title: "Rig CLI surface", description: "Registry-dispatched command-line surface." }],
+    cliCommands: STANDARD_CLI_SURFACE_COMMAND_METADATA
+  }
+};
+export {
+  standardCliSurfacePlugin,
+  STANDARD_CLI_SURFACE_PLUGIN_NAME,
+  STANDARD_CLI_SURFACE_COMMAND_METADATA
+};

package/dist/src/default-lifecycle.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_LIFECYCLE_PLUGIN_ID, createDefaultLifecyclePlugin, defaultLifecyclePlugin, } from "@rig/bundle-default-lifecycle/plugin";
+export type { DefaultLifecyclePlugin } from "@rig/bundle-default-lifecycle/plugin";

package/dist/src/default-lifecycle.js

@@ -0,0 +1,12 @@
+// @bun
+// packages/standard-plugin/src/default-lifecycle.ts
+import {
+  DEFAULT_LIFECYCLE_PLUGIN_ID,
+  createDefaultLifecyclePlugin,
+  defaultLifecyclePlugin
+} from "@rig/bundle-default-lifecycle/plugin";
+export {
+  defaultLifecyclePlugin,
+  createDefaultLifecyclePlugin,
+  DEFAULT_LIFECYCLE_PLUGIN_ID
+};

package/dist/src/dependency-graph.d.ts

@@ -0,0 +1 @@
+export { DEPENDENCY_GRAPH_CLI_ID, DEPENDENCY_GRAPH_PANEL_ID, EPICS_PANEL_ID, PEOPLE_PANEL_ID, WORKSPACE_STATUS_CLI_ID, WORKSPACE_SUMMARY_CLI_ID, createDependencyGraphPlugin, dependencyGraphPlugin, } from "@rig/dependency-graph-plugin/plugin";

package/dist/src/dependency-graph.js

@@ -0,0 +1,22 @@
+// @bun
+// packages/standard-plugin/src/dependency-graph.ts
+import {
+  DEPENDENCY_GRAPH_CLI_ID,
+  DEPENDENCY_GRAPH_PANEL_ID,
+  EPICS_PANEL_ID,
+  PEOPLE_PANEL_ID,
+  WORKSPACE_STATUS_CLI_ID,
+  WORKSPACE_SUMMARY_CLI_ID,
+  createDependencyGraphPlugin,
+  dependencyGraphPlugin
+} from "@rig/dependency-graph-plugin/plugin";
+export {
+  dependencyGraphPlugin,
+  createDependencyGraphPlugin,
+  WORKSPACE_SUMMARY_CLI_ID,
+  WORKSPACE_STATUS_CLI_ID,
+  PEOPLE_PANEL_ID,
+  EPICS_PANEL_ID,
+  DEPENDENCY_GRAPH_PANEL_ID,
+  DEPENDENCY_GRAPH_CLI_ID
+};

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

@@ -0,0 +1,13 @@
+import { type StageMutation, type ValidatorRegistration } from "@rig/contracts";
+export interface DocsDriftPluginOptions {
+    readonly docsGlobs?: readonly string[];
+    readonly ignoreGlobs?: readonly string[];
+    readonly failOnDrift?: boolean;
+}
+export declare const DOCS_DRIFT_VALIDATOR_ID = "std:docs-drift";
+export declare const DOCS_DRIFT_CLI_ID = "std:drift";
+export declare const DOCS_DRIFT_STAGE_ID = "docs-drift";
+export declare const DOCS_DRIFT_CAPABILITY_ID = "std:docs-drift-capability";
+export declare const DOCS_DRIFT_VALIDATOR: ValidatorRegistration;
+export declare const DOCS_DRIFT_STAGE_MUTATION: StageMutation;
+export declare const DOCS_DRIFT_CLI_COMMAND = "rig drift [--docs <csv>] [--ignore <csv>] [--fail-on-drift] [--json]";

package/dist/src/drift/metadata.js

@@ -0,0 +1,33 @@
+// @bun
+// packages/standard-plugin/src/drift/metadata.ts
+import { Schema } from "effect";
+import { StageMutation as StageMutationSchema } from "@rig/contracts";
+var DOCS_DRIFT_VALIDATOR_ID = "std:docs-drift";
+var DOCS_DRIFT_CLI_ID = "std:drift";
+var DOCS_DRIFT_STAGE_ID = "docs-drift";
+var DOCS_DRIFT_CAPABILITY_ID = "std:docs-drift-capability";
+var DOCS_DRIFT_VALIDATOR = {
+  id: DOCS_DRIFT_VALIDATOR_ID,
+  category: "regression",
+  description: "Detect documentation references that drifted from the source tree."
+};
+var DOCS_DRIFT_STAGE_MUTATION = Schema.decodeUnknownSync(StageMutationSchema)({
+  op: "insert",
+  stage: {
+    id: DOCS_DRIFT_STAGE_ID,
+    kind: "gate",
+    before: ["merge-gate"],
+    after: ["open-pr"]
+  },
+  contributedBy: DOCS_DRIFT_STAGE_ID
+});
+var DOCS_DRIFT_CLI_COMMAND = "rig drift [--docs <csv>] [--ignore <csv>] [--fail-on-drift] [--json]";
+export {
+  DOCS_DRIFT_VALIDATOR_ID,
+  DOCS_DRIFT_VALIDATOR,
+  DOCS_DRIFT_STAGE_MUTATION,
+  DOCS_DRIFT_STAGE_ID,
+  DOCS_DRIFT_CLI_ID,
+  DOCS_DRIFT_CLI_COMMAND,
+  DOCS_DRIFT_CAPABILITY_ID
+};

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

@@ -1,18 +1,8 @@
-import { type DriftFinding, type DriftReport, type StageMutation, type StageResult, type StageRun, type ValidatorRegistration } from "@rig/contracts";
-import type { RegisteredValidator, RuntimeCliCommand, RuntimeCliContext, ValidatorResult } from "@rig/core";
+import type { DriftFinding, DriftReport, StageResult, StageRun } from "@rig/contracts";
+import type { RegisteredValidator, RuntimeCliCommand, RuntimeCliContext, ValidatorResult } from "@rig/core/config";
 import { type DriftDetectOptions } from "./detect";
-export interface DocsDriftPluginOptions {
-    readonly docsGlobs?: readonly string[];
-    readonly ignoreGlobs?: readonly string[];
-    readonly failOnDrift?: boolean;
-}
-export declare const DOCS_DRIFT_VALIDATOR_ID = "std:docs-drift";
-export declare const DOCS_DRIFT_CLI_ID = "std:drift";
-export declare const DOCS_DRIFT_STAGE_ID = "docs-drift";
-export declare const DOCS_DRIFT_CAPABILITY_ID = "std:docs-drift-capability";
-export declare const DOCS_DRIFT_VALIDATOR: ValidatorRegistration;
-export declare const DOCS_DRIFT_STAGE_MUTATION: StageMutation;
-export declare const DOCS_DRIFT_CLI_COMMAND = "rig drift [--docs <csv>] [--ignore <csv>] [--fail-on-drift] [--json]";
+export { DOCS_DRIFT_CAPABILITY_ID, DOCS_DRIFT_CLI_COMMAND, DOCS_DRIFT_CLI_ID, DOCS_DRIFT_STAGE_ID, DOCS_DRIFT_STAGE_MUTATION, DOCS_DRIFT_VALIDATOR, DOCS_DRIFT_VALIDATOR_ID, type DocsDriftPluginOptions, } from "./metadata";
+import { type DocsDriftPluginOptions } from "./metadata";
 export declare function highConfidenceDriftFindings(report: DriftReport): readonly DriftFinding[];
 export declare function driftGateResult(report: DriftReport, mode?: "observe" | "enforce"): StageResult;
 /**

package/dist/src/drift/plugin.js

@@ -1,8 +1,4 @@
 // @bun
-// packages/standard-plugin/src/drift/plugin.ts
-import { Schema } from "effect";
-import { StageMutation as StageMutationSchema } from "@rig/contracts";
-
 // packages/standard-plugin/src/drift/detect.ts
 import { existsSync } from "fs";
 import { readdir, readFile, stat } from "fs/promises";
@@ -297,7 +293,9 @@ async function detectDrift(options) {
   };
 }
 
-// packages/standard-plugin/src/drift/plugin.ts
+// packages/standard-plugin/src/drift/metadata.ts
+import { Schema } from "effect";
+import { StageMutation as StageMutationSchema } from "@rig/contracts";
 var DOCS_DRIFT_VALIDATOR_ID = "std:docs-drift";
 var DOCS_DRIFT_CLI_ID = "std:drift";
 var DOCS_DRIFT_STAGE_ID = "docs-drift";
@@ -318,6 +316,7 @@ var DOCS_DRIFT_STAGE_MUTATION = Schema.decodeUnknownSync(StageMutationSchema)({
   contributedBy: DOCS_DRIFT_STAGE_ID
 });
 var DOCS_DRIFT_CLI_COMMAND = "rig drift [--docs <csv>] [--ignore <csv>] [--fail-on-drift] [--json]";
+// packages/standard-plugin/src/drift/plugin.ts
 function highConfidenceDriftFindings(report) {
   return report.findings.filter((finding) => finding.confidence === "high");
 }

package/dist/src/github-issues-source.js

@@ -11,7 +11,7 @@ function createEnvGitHubCredentialProvider() {
   return {
     async resolveGitHubToken(input) {
       if (input.purpose === "selected-repo") {
-        return { token: cleanToken(process.env.RIG_GITHUB_SELECTED_TOKEN ?? process.env.RIG_GITHUB_TOKEN ?? null) ?? "", source: "signed-in-user" };
+        return { token: cleanToken(process.env.RIG_GITHUB_SELECTED_TOKEN ?? null) ?? "", source: "signed-in-user" };
       }
       const token = cleanToken(process.env.RIG_GITHUB_TOKEN ?? process.env.GH_TOKEN ?? process.env.GITHUB_TOKEN ?? null);
       if (!token) {
@@ -22,15 +22,35 @@ function createEnvGitHubCredentialProvider() {
   };
 }
 function createStateGitHubCredentialProvider(options = {}) {
+  const addCandidate = (candidates, path) => {
+    const trimmed = path?.trim();
+    if (!trimmed)
+      return;
+    const resolved = resolve(trimmed);
+    if (!candidates.includes(resolved))
+      candidates.push(resolved);
+  };
+  const addStateDir = (candidates, dir) => {
+    const trimmed = dir?.trim();
+    if (!trimmed)
+      return;
+    addCandidate(candidates, resolve(trimmed, "github-auth.json"));
+  };
+  const addProjectStateDir = (candidates, root) => {
+    const trimmed = root?.trim();
+    if (!trimmed)
+      return;
+    addStateDir(candidates, resolve(trimmed, ".rig", "state"));
+  };
   const stateFileCandidates = () => {
     const candidates = [];
-    const explicitFile = options.stateFile ?? process.env.RIG_GITHUB_AUTH_STATE_FILE;
-    if (explicitFile?.trim())
-      candidates.push(resolve(explicitFile.trim()));
-    for (const dir of [options.stateDir, process.env.RIG_STATE_DIR]) {
-      if (dir?.trim())
-        candidates.push(resolve(dir.trim(), "github-auth.json"));
-    }
+    addCandidate(candidates, options.stateFile ?? process.env.RIG_GITHUB_AUTH_STATE_FILE);
+    addStateDir(candidates, options.stateDir);
+    addStateDir(candidates, process.env.RIG_STATE_DIR);
+    addProjectStateDir(candidates, process.env.PROJECT_RIG_ROOT);
+    addProjectStateDir(candidates, process.env.RIG_PROJECT_ROOT);
+    addProjectStateDir(candidates, process.env.RIG_HOST_PROJECT_ROOT);
+    addProjectStateDir(candidates, process.cwd());
     return candidates;
   };
   const readToken = () => {
@@ -50,7 +70,7 @@ function createStateGitHubCredentialProvider(options = {}) {
     async resolveGitHubToken(input) {
       const token = readToken();
       if (input.purpose === "selected-repo") {
-        return { token: token ?? cleanToken(process.env.RIG_GITHUB_SELECTED_TOKEN ?? process.env.RIG_GITHUB_TOKEN ?? null) ?? "", source: "signed-in-user" };
+        return { token: token ?? cleanToken(process.env.RIG_GITHUB_SELECTED_TOKEN ?? null) ?? "", source: "signed-in-user" };
       }
       if (token) {
         return { token, source: "signed-in-user" };
@@ -90,23 +110,29 @@ function statusFor(issue) {
   return "open";
 }
 function parseIssueRefs(raw) {
-  return raw.split(",").map((s) => s.trim()).map((s) => s.replace(/^#/, "").match(/^(\d+)/)?.[1] ?? "").filter((s) => s.length > 0);
+  const refs = [...raw.matchAll(/(?:^|[^\w/.-])(?:[\w.-]+\/[\w.-]+#|#)?(\d+)\b/g)].map((match) => match[1]).filter((value) => Boolean(value));
+  return [...new Set(refs)];
 }
-function parseMetadataList(body, key) {
+function metadataKeyPattern(keys) {
+  return new RegExp(`^(?:${keys.map((key) => key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")}):\\s*(.*)$`, "i");
+}
+function parseMetadataList(body, keys) {
   const block = body.match(/<!-- rig:metadata:start -->\s*([\s\S]*?)\s*<!-- rig:metadata:end -->/);
   if (!block)
     return [];
   const lines = block[1].split(/\r?\n/);
   const values = [];
+  const keyPattern = metadataKeyPattern(keys);
   for (let index = 0;index < lines.length; index += 1) {
     const line = lines[index];
-    const sameLine = line.match(new RegExp(`^${key}:\\s*(.+)$`, "i"));
-    if (sameLine) {
-      values.push(...parseIssueRefs(sameLine[1]));
+    const sameLine = line.match(keyPattern);
+    if (!sameLine)
       continue;
-    }
-    if (!new RegExp(`^${key}:\\s*$`, "i").test(line))
+    const inlineValue = sameLine[1]?.trim() ?? "";
+    if (inlineValue) {
+      values.push(...parseIssueRefs(inlineValue));
       continue;
+    }
     for (let cursor = index + 1;cursor < lines.length; cursor += 1) {
       const item = lines[cursor].match(/^\s*-\s*(.+)$/);
       if (!item)
@@ -116,15 +142,24 @@ function parseMetadataList(body, key) {
   }
   return [...new Set(values)];
 }
+function bodyWithoutRigMetadataBlock(body) {
+  return body.replace(/<!-- rig:metadata:start -->\s*[\s\S]*?\s*<!-- rig:metadata:end -->/g, "");
+}
+function parseBodyKeyRefs(body, keys) {
+  const keyPattern = metadataKeyPattern(keys);
+  const values = bodyWithoutRigMetadataBlock(body).split(/\r?\n/).flatMap((line) => {
+    const match = line.match(keyPattern);
+    return match?.[1] ? parseIssueRefs(match[1]) : [];
+  });
+  return [...new Set(values)];
+}
 function parseDeps(body) {
-  const match = body.match(/^depends-on:\s*([^\n]+)/im);
-  const bodyRefs = match ? parseIssueRefs(match[1]) : [];
-  return [...new Set([...bodyRefs, ...parseMetadataList(body, "depends-on")])];
+  const keys = ["depends-on", "deps", "blocked-by", "blocked_by"];
+  return [...new Set([...parseBodyKeyRefs(body, keys), ...parseMetadataList(body, keys)])];
 }
 function parseParents(body) {
-  const match = body.match(/^parents?:\s*([^\n]+)/im);
-  const bodyRefs = match ? parseIssueRefs(match[1]) : [];
-  return [...new Set([...bodyRefs, ...parseMetadataList(body, "parents")])];
+  const keys = ["parents", "parent"];
+  return [...new Set([...parseBodyKeyRefs(body, keys), ...parseMetadataList(body, keys)])];
 }
 function issueTypeFor(issue) {
   const labels = labelNamesFor(issue);
@@ -217,21 +252,29 @@ function isRigStickyStatusComment(body) {
   return body.includes(RIG_STATUS_COMMENT_MARKER);
 }
 function ghSpawnOptions(extraEnv, timeoutMs) {
+  const env = {
+    ...process.env,
+    ...process.env.GH_TOKEN !== undefined ? { GH_TOKEN: process.env.GH_TOKEN } : {},
+    ...process.env.GITHUB_TOKEN !== undefined ? { GITHUB_TOKEN: process.env.GITHUB_TOKEN } : {},
+    ...process.env.RIG_GITHUB_TOKEN !== undefined ? { RIG_GITHUB_TOKEN: process.env.RIG_GITHUB_TOKEN } : {}
+  };
+  for (const [key, value] of Object.entries(extraEnv ?? {})) {
+    if (value === undefined)
+      delete env[key];
+    else
+      env[key] = value;
+  }
   return {
     encoding: "utf-8",
     timeout: timeoutMs,
-    env: {
-      ...process.env,
-      ...process.env.GH_TOKEN !== undefined ? { GH_TOKEN: process.env.GH_TOKEN } : {},
-      ...process.env.GITHUB_TOKEN !== undefined ? { GITHUB_TOKEN: process.env.GITHUB_TOKEN } : {},
-      ...process.env.RIG_GITHUB_TOKEN !== undefined ? { RIG_GITHUB_TOKEN: process.env.RIG_GITHUB_TOKEN } : {},
-      ...extraEnv ?? {}
-    }
+    env
   };
 }
 function credentialEnv(token) {
   const clean = token?.trim() ?? "";
-  return { GH_TOKEN: clean, GITHUB_TOKEN: clean, RIG_GITHUB_TOKEN: clean };
+  if (clean)
+    return { GH_TOKEN: clean, GITHUB_TOKEN: clean, RIG_GITHUB_TOKEN: clean };
+  return { GH_TOKEN: undefined, GITHUB_TOKEN: undefined, RIG_GITHUB_TOKEN: undefined };
 }
 async function resolveCredentialEnv(opts, purpose) {
   if (!opts.credentialProvider)

package/dist/src/index.d.ts

@@ -1,3 +1,7 @@
-export * from "./plugin";
-export { default } from "./plugin";
-export { standardProjectPlugins, type StandardProjectPluginsOptions } from "./bundle";
+export { standardPlugins } from "./bundle";
+export type { StandardPluginsOptions } from "./bundle";
+export { DOCS_DRIFT_CAPABILITY_ID, DOCS_DRIFT_CLI_COMMAND, DOCS_DRIFT_CLI_ID, DOCS_DRIFT_STAGE_ID, DOCS_DRIFT_STAGE_MUTATION, DOCS_DRIFT_VALIDATOR, DOCS_DRIFT_VALIDATOR_ID, DOCS_HEALTH_PANEL_ID, createEnvGitHubCredentialProvider, createFilesTaskSource, createGitHubIssuesTaskSource, createStandardDocsDriftPlugin, createStandardProductEntrypointPlugin, createStandardTaskCliPlugin, createStandardTaskSourcesPlugin, createStateGitHubCredentialProvider, standardProductEntrypointPlugin, standardTaskCliPlugin, } from "./plugin";
+export type { DocsDriftPluginOptions, DriftGit, DriftJudgeInput, DriftJudgeMismatch, DriftJudgeProvider, DriftReference, DriftReferenceKind, FilesTaskSourceOptions, GitHubIssuesOptions, StandardTaskSourcesPluginOptions, } from "./plugin";
+export { RIG_CAPABILITY_PANEL_SLOT, RIG_RUN_STOP_PANEL_ACTION, RIG_SUPERVISOR_PANEL_ID, RUN_SUPERVISOR_PANEL_PRODUCER, RUN_SUPERVISOR_PANEL_REGISTRATION, RUN_WORKER_PANEL_PLUGIN, } from "./run-worker-panels";
+export type { WorkerPanelProducerContext } from "./run-worker-panels";
+export { STANDARD_CLI_SURFACE_COMMAND_METADATA, STANDARD_CLI_SURFACE_PLUGIN_NAME, standardCliSurfacePlugin, } from "./cli-surface";