@h-rig/standard-plugin 0.0.6-alpha.14 → 0.0.6-alpha.141

package/dist/src/index.js

@@ -1,5 +1,6 @@
 // @bun
-// packages/standard-plugin/src/index.ts
+// packages/standard-plugin/src/plugin.ts
+import { resolve as resolve4 } from "path";
 import { definePlugin } from "@rig/core";
 
 // packages/standard-plugin/src/github-issues-source.ts
@@ -14,9 +15,9 @@ function createEnvGitHubCredentialProvider() {
   return {
     async resolveGitHubToken(input) {
       if (input.purpose === "selected-repo") {
-        return { token: cleanToken(process.env.RIG_GITHUB_SELECTED_TOKEN ?? null) ?? "", source: "signed-in-user" };
+        return { token: cleanToken(process.env.RIG_GITHUB_SELECTED_TOKEN ?? process.env.RIG_GITHUB_TOKEN ?? null) ?? "", source: "signed-in-user" };
       }
-      const token = cleanToken(process.env.GH_TOKEN ?? process.env.GITHUB_TOKEN ?? null);
+      const token = cleanToken(process.env.RIG_GITHUB_TOKEN ?? process.env.GH_TOKEN ?? process.env.GITHUB_TOKEN ?? null);
       if (!token) {
         throw new Error("No host GitHub token is configured for admin fallback.");
       }
@@ -25,34 +26,40 @@ function createEnvGitHubCredentialProvider() {
   };
 }
 function createStateGitHubCredentialProvider(options = {}) {
-  const resolveStateFile = () => {
+  const stateFileCandidates = () => {
+    const candidates = [];
     const explicitFile = options.stateFile ?? process.env.RIG_GITHUB_AUTH_STATE_FILE;
     if (explicitFile?.trim())
-      return resolve(explicitFile.trim());
-    const stateDir = options.stateDir ?? process.env.RIG_STATE_DIR;
-    return stateDir?.trim() ? resolve(stateDir.trim(), "github-auth.json") : null;
+      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"));
+    }
+    return candidates;
   };
   const readToken = () => {
-    const stateFile = resolveStateFile();
-    if (!stateFile || !existsSync(stateFile))
-      return null;
-    try {
-      const parsed = JSON.parse(readFileSync(stateFile, "utf8"));
-      return typeof parsed.token === "string" ? cleanToken(parsed.token) : null;
-    } catch {
-      return null;
+    for (const stateFile of stateFileCandidates()) {
+      if (!existsSync(stateFile))
+        continue;
+      try {
+        const parsed = JSON.parse(readFileSync(stateFile, "utf8"));
+        const token = typeof parsed.token === "string" ? cleanToken(parsed.token) : null;
+        if (token)
+          return token;
+      } catch {}
     }
+    return null;
   };
   return {
     async resolveGitHubToken(input) {
       const token = readToken();
       if (input.purpose === "selected-repo") {
-        return { token: token ?? "", source: "signed-in-user" };
+        return { token: token ?? cleanToken(process.env.RIG_GITHUB_SELECTED_TOKEN ?? process.env.RIG_GITHUB_TOKEN ?? null) ?? "", source: "signed-in-user" };
       }
       if (token) {
         return { token, source: "signed-in-user" };
       }
-      const fallback = cleanToken(process.env.GH_TOKEN ?? process.env.GITHUB_TOKEN ?? null);
+      const fallback = cleanToken(process.env.RIG_GITHUB_TOKEN ?? process.env.GH_TOKEN ?? process.env.GITHUB_TOKEN ?? null);
       if (!fallback) {
         throw new Error("No signed-in GitHub token is stored for Rig and no host admin fallback token is configured.");
       }
@@ -86,17 +93,42 @@ function statusFor(issue) {
     return "cancelled";
   return "open";
 }
+function parseIssueRefs(raw) {
+  return raw.split(",").map((s) => s.trim()).map((s) => s.replace(/^#/, "").match(/^(\d+)/)?.[1] ?? "").filter((s) => s.length > 0);
+}
+function parseMetadataList(body, key) {
+  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 = [];
+  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]));
+      continue;
+    }
+    if (!new RegExp(`^${key}:\\s*$`, "i").test(line))
+      continue;
+    for (let cursor = index + 1;cursor < lines.length; cursor += 1) {
+      const item = lines[cursor].match(/^\s*-\s*(.+)$/);
+      if (!item)
+        break;
+      values.push(...parseIssueRefs(item[1]));
+    }
+  }
+  return [...new Set(values)];
+}
 function parseDeps(body) {
   const match = body.match(/^depends-on:\s*([^\n]+)/im);
-  if (!match)
-    return [];
-  return match[1].split(",").map((s) => s.trim()).map((s) => s.replace(/^#/, "").match(/^(\d+)/)?.[1] ?? "").filter((s) => s.length > 0);
+  const bodyRefs = match ? parseIssueRefs(match[1]) : [];
+  return [...new Set([...bodyRefs, ...parseMetadataList(body, "depends-on")])];
 }
 function parseParents(body) {
   const match = body.match(/^parents?:\s*([^\n]+)/im);
-  if (!match)
-    return [];
-  return match[1].split(",").map((s) => s.trim()).map((s) => s.replace(/^#/, "").match(/^(\d+)/)?.[1] ?? "").filter((s) => s.length > 0);
+  const bodyRefs = match ? parseIssueRefs(match[1]) : [];
+  return [...new Set([...bodyRefs, ...parseMetadataList(body, "parents")])];
 }
 function issueTypeFor(issue) {
   const labels = labelNamesFor(issue);
@@ -107,7 +139,7 @@ function issueTypeFor(issue) {
     return "epic";
   return "task";
 }
-function issueToTask(issue, repo) {
+function issueToTask(issue, repo, nativeDependencies) {
   const labelNames = labelNamesFor(issue);
   const scope = labelNames.filter((l) => l.startsWith("scope:")).map((l) => l.slice("scope:".length));
   const roleLabel = labelNames.find((l) => l.startsWith("role:"));
@@ -115,10 +147,12 @@ function issueToTask(issue, repo) {
   const validators = labelNames.filter((l) => l.startsWith("validator:")).map((l) => l.slice("validator:".length));
   const body = issue.body ?? "";
   const issueNodeId = issue.id ?? issue.nodeId ?? issue.node_id;
+  const parsedDeps = parseDeps(body);
+  const deps = nativeDependencies?.deps ? [...new Set([...parsedDeps, ...nativeDependencies.deps])] : parsedDeps;
   return {
     id: String(issue.number),
     ...typeof issueNodeId === "string" && issueNodeId.trim() ? { issueNodeId: issueNodeId.trim() } : {},
-    deps: parseDeps(body),
+    deps,
     status: statusFor(issue),
     title: issue.title,
     body,
@@ -130,6 +164,7 @@ function issueToTask(issue, repo) {
     sourceIssueId: `${repo}#${issue.number}`,
     parentChildDeps: parseParents(body),
     labels: labelNames,
+    ...nativeDependencies?.degraded ? { nativeDependenciesDegraded: true, nativeDependenciesError: nativeDependencies.degraded } : {},
     raw: issue
   };
 }
@@ -166,17 +201,41 @@ ${rendered}
 ` : `${rendered}
 `;
 }
+function buildRigStickyStatusComment(input) {
+  const lines = [
+    RIG_STATUS_COMMENT_MARKER,
+    `### Rig status: ${input.status}`,
+    "",
+    input.summary
+  ];
+  if (input.runId)
+    lines.push("", `- Run: ${input.runId}`);
+  if (input.prUrl)
+    lines.push(`- PR: ${input.prUrl}`);
+  for (const detail of input.details ?? [])
+    lines.push(`- ${detail}`);
+  return lines.join(`
+`);
+}
 function isRigStickyStatusComment(body) {
   return body.includes(RIG_STATUS_COMMENT_MARKER);
 }
 function ghSpawnOptions(extraEnv, timeoutMs) {
-  if (!extraEnv)
-    return { encoding: "utf-8", timeout: timeoutMs };
-  return { encoding: "utf-8", timeout: timeoutMs, env: { ...process.env, ...extraEnv } };
+  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 ?? {}
+    }
+  };
 }
 function credentialEnv(token) {
   const clean = token?.trim() ?? "";
-  return { GH_TOKEN: clean, GITHUB_TOKEN: clean };
+  return { GH_TOKEN: clean, GITHUB_TOKEN: clean, RIG_GITHUB_TOKEN: clean };
 }
 async function resolveCredentialEnv(opts, purpose) {
   if (!opts.credentialProvider)
@@ -191,28 +250,319 @@ async function resolveCredentialEnv(opts, purpose) {
   const resolved = await opts.credentialProvider.resolveGitHubToken(input);
   return credentialEnv(resolved.token);
 }
+function tokenDiagnostic(value) {
+  const clean = value?.trim() ?? "";
+  return clean ? `present(len=${clean.length})` : "missing";
+}
 function runGh(bin, args, spawn, extraEnv, timeoutMs) {
-  const res = spawn(bin, [...args], ghSpawnOptions(extraEnv, timeoutMs));
-  assertGhSuccess(args, res);
+  const options = ghSpawnOptions(extraEnv, timeoutMs);
+  const res = spawn(bin, [...args], options);
+  assertGhSuccess(args, res, options.env);
   if (!res.stdout || res.stdout.trim() === "")
     return [];
   return JSON.parse(res.stdout);
 }
 function runGhVoid(bin, args, spawn, extraEnv, timeoutMs) {
-  const res = spawn(bin, [...args], ghSpawnOptions(extraEnv, timeoutMs));
-  assertGhSuccess(args, res);
+  const options = ghSpawnOptions(extraEnv, timeoutMs);
+  const res = spawn(bin, [...args], options);
+  assertGhSuccess(args, res, options.env);
 }
-function assertGhSuccess(args, res) {
+function assertGhSuccess(args, res, env) {
   if (res.error) {
     const msg = res.error.message ?? String(res.error);
     throw new Error(`gh CLI not available \u2014 install gh (brew install gh / apt install gh): ${msg}`);
   }
   if (res.status !== 0) {
-    throw new Error(`gh ${args.join(" ")} failed (exit ${res.status}): ${res.stderr}`);
+    throw new Error(`gh ${args.join(" ")} failed (exit ${res.status}): ${res.stderr}
+[rig gh env:standard-plugin] GH_TOKEN=${tokenDiagnostic(env.GH_TOKEN)} GITHUB_TOKEN=${tokenDiagnostic(env.GITHUB_TOKEN)} RIG_GITHUB_TOKEN=${tokenDiagnostic(env.RIG_GITHUB_TOKEN)}`);
   }
 }
+var DEFAULT_PROJECT_STATUSES = {
+  todo: "Todo",
+  running: "In Progress",
+  prOpen: "In Review",
+  ciFixing: "In Review",
+  merging: "In Review",
+  done: "Done",
+  needsAttention: "Needs Attention"
+};
+function asProjectRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function projectString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function projectLifecycleStatusForTaskStatus(status) {
+  const normalized = status?.trim().toLowerCase().replace(/[-\s]+/g, "_");
+  switch (normalized) {
+    case "draft":
+    case "open":
+    case "queued":
+    case "ready":
+      return "todo";
+    case "running":
+    case "in_progress":
+      return "running";
+    case "under_review":
+    case "review":
+    case "pr_open":
+      return "prOpen";
+    case "ci_fixing":
+    case "fixing":
+      return "ciFixing";
+    case "merging":
+    case "merge":
+      return "merging";
+    case "closed":
+    case "completed":
+    case "done":
+      return "done";
+    case "blocked":
+    case "cancelled":
+    case "failed":
+    case "needs_attention":
+      return "needsAttention";
+    default:
+      return null;
+  }
+}
+function ghGraphQLFetch(bin, spawnFn, extraEnv, timeoutMs) {
+  return async (query, variables) => {
+    const args = ["api", "graphql", "-f", `query=${query}`];
+    for (const [key, value] of Object.entries(variables)) {
+      if (value === undefined || value === null)
+        continue;
+      args.push("-f", `${key}=${String(value)}`);
+    }
+    const response = runGh(bin, args, spawnFn, extraEnv, timeoutMs);
+    return asProjectRecord(response)?.data ?? response;
+  };
+}
+function issueNodeIdFor(issue) {
+  const id = issue.id ?? issue.nodeId ?? issue.node_id;
+  return typeof id === "string" && id.trim().length > 0 ? id.trim() : null;
+}
+function nativeIssueDependencyRef(value, currentRepo) {
+  const record = asProjectRecord(value);
+  const number = typeof record?.number === "number" ? String(record.number) : projectString(record?.number);
+  if (!number)
+    return null;
+  const repository = asProjectRecord(record?.repository);
+  const owner = projectString(asProjectRecord(repository?.owner)?.login);
+  const name = projectString(repository?.name);
+  if (!owner || !name || `${owner}/${name}` === currentRepo)
+    return number;
+  return `${owner}/${name}#${number}`;
+}
+function nativeDependencyRefsFrom(data, currentRepo) {
+  const issue = asProjectRecord(asProjectRecord(data)?.node);
+  const blockedBy = asProjectRecord(issue?.blockedBy);
+  const nodes = Array.isArray(blockedBy?.nodes) ? blockedBy.nodes : [];
+  return [...new Set(nodes.flatMap((node) => {
+    const ref = nativeIssueDependencyRef(node, currentRepo);
+    return ref ? [ref] : [];
+  }))];
+}
+async function readNativeDependenciesForIssue(input) {
+  const issueId = issueNodeIdFor(input.issue);
+  if (!issueId)
+    return { deps: [], degraded: "GitHub issue node id is unavailable." };
+  const query = `
+    query RigIssueNativeDependencies($issueId: ID!) {
+      node(id: $issueId) {
+        ... on Issue {
+          blockedBy(first: 100) {
+            nodes {
+              number
+              repository { name owner { login } }
+            }
+          }
+        }
+      }
+    }
+  `;
+  try {
+    return {
+      deps: nativeDependencyRefsFrom(await input.fetchGraphQL(query, { issueId }, "gh-cli"), input.repo)
+    };
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return { deps: [], degraded: detail };
+  }
+}
+function formatIssueReference(ref) {
+  const clean = ref.trim().replace(/^#/, "");
+  return /^\d+$/.test(clean) ? `#${clean}` : clean;
+}
+function appendReferenceLines(body, deps, parents) {
+  const lines = [];
+  const cleanDeps = (deps ?? []).map(formatIssueReference).filter((ref) => ref.length > 0);
+  const cleanParents = (parents ?? []).map(formatIssueReference).filter((ref) => ref.length > 0);
+  if (cleanDeps.length > 0)
+    lines.push(`depends-on: ${cleanDeps.join(", ")}`);
+  if (cleanParents.length > 0)
+    lines.push(`parents: ${cleanParents.join(", ")}`);
+  if (lines.length === 0)
+    return body;
+  return body.trim().length > 0 ? `${body.trimEnd()}
+
+${lines.join(`
+`)}` : lines.join(`
+`);
+}
+function bodyForCreatedTask(input) {
+  const metadata = { ...input.metadata ?? {} };
+  if (input.deps && input.deps.length > 0)
+    metadata["depends-on"] = input.deps.map(formatIssueReference);
+  if (input.parents && input.parents.length > 0)
+    metadata.parents = input.parents.map(formatIssueReference);
+  return updateRigOwnedMetadataBlock(appendReferenceLines(input.body, input.deps, input.parents), metadata);
+}
+function projectStatusFieldFrom(data, projectId) {
+  const fields = asProjectRecord(asProjectRecord(asProjectRecord(data)?.node)?.fields)?.nodes;
+  for (const node of Array.isArray(fields) ? fields : []) {
+    const record = asProjectRecord(node);
+    if (projectString(record?.name)?.toLowerCase() !== "status")
+      continue;
+    const id = projectString(record?.id);
+    if (!id)
+      continue;
+    const options = Array.isArray(record?.options) ? record.options.flatMap((option) => {
+      const optionRecord = asProjectRecord(option);
+      const optionId = projectString(optionRecord?.id);
+      const name = projectString(optionRecord?.name);
+      return optionId && name ? [{ id: optionId, name }] : [];
+    }) : [];
+    return { id, name: "Status", options };
+  }
+  throw new Error(`GitHub Project ${projectId} does not expose a Status single-select field.`);
+}
+async function resolveProjectStatusField(input) {
+  const query = `
+    query RigProjectStatusField($projectId: ID!) {
+      node(id: $projectId) {
+        ... on ProjectV2 {
+          fields(first: 50) {
+            nodes {
+              ... on ProjectV2FieldCommon { id name }
+              ... on ProjectV2SingleSelectField { id name options { id name } }
+            }
+          }
+        }
+      }
+    }
+  `;
+  return projectStatusFieldFrom(await input.fetchGraphQL(query, { projectId: input.projectId }, input.token), input.projectId);
+}
+async function ensureIssueProjectItem(input) {
+  const query = `
+    query RigFindProjectIssueItem($projectId: ID!) {
+      node(id: $projectId) {
+        ... on ProjectV2 {
+          items(first: 100) { nodes { id content { ... on Issue { id } } } }
+        }
+      }
+    }
+  `;
+  const data = await input.fetchGraphQL(query, { projectId: input.projectId }, input.token);
+  const nodes = asProjectRecord(asProjectRecord(asProjectRecord(data)?.node)?.items)?.nodes;
+  for (const node of Array.isArray(nodes) ? nodes : []) {
+    const record = asProjectRecord(node);
+    const content = asProjectRecord(record?.content);
+    if (projectString(content?.id) === input.issueNodeId) {
+      const id2 = projectString(record?.id);
+      if (id2)
+        return { id: id2, created: false };
+    }
+  }
+  const mutation = `
+    mutation RigAddIssueToProject($projectId: ID!, $contentId: ID!) {
+      addProjectV2ItemById(input: { projectId: $projectId, contentId: $contentId }) { item { id } }
+    }
+  `;
+  const created = await input.fetchGraphQL(mutation, { projectId: input.projectId, contentId: input.issueNodeId }, input.token);
+  const addResult = asProjectRecord(asProjectRecord(created)?.addProjectV2ItemById);
+  const id = projectString(asProjectRecord(addResult?.item)?.id);
+  if (!id)
+    throw new Error("GitHub Project item creation did not return an item id.");
+  return { id, created: true };
+}
+async function updateIssueProjectStatus(input) {
+  const mutation = `
+    mutation RigUpdateProjectStatus($projectId: ID!, $itemId: ID!, $fieldId: ID!, $optionId: String!) {
+      updateProjectV2ItemFieldValue(input: {
+        projectId: $projectId,
+        itemId: $itemId,
+        fieldId: $fieldId,
+        value: { singleSelectOptionId: $optionId }
+      }) { projectV2Item { id } }
+    }
+  `;
+  await input.fetchGraphQL(mutation, {
+    projectId: input.projectId,
+    itemId: input.itemId,
+    fieldId: input.fieldId,
+    optionId: input.optionId
+  }, input.token);
+}
+function fetchIssueNodeId(bin, repo, spawnFn, id, extraEnv, timeoutMs) {
+  const issue = runGh(bin, ["issue", "view", String(id), "--repo", repo, "--json", "id"], spawnFn, extraEnv, timeoutMs);
+  return projectString(issue.id) ?? projectString(issue.nodeId) ?? projectString(issue.node_id);
+}
+async function syncGitHubProjectStatus(bin, repo, spawnFn, id, status, projects, extraEnv, timeoutMs) {
+  if (!projects?.enabled)
+    return;
+  const projectId = projectString(projects.projectId);
+  if (!projectId)
+    throw new Error("GitHub Projects status sync is enabled but projectId is missing.");
+  const lifecycleStatus = projectLifecycleStatusForTaskStatus(status);
+  if (!lifecycleStatus)
+    return;
+  const issueNodeId = fetchIssueNodeId(bin, repo, spawnFn, id, extraEnv, timeoutMs);
+  if (!issueNodeId)
+    throw new Error(`GitHub issue ${repo}#${id} did not expose a node id for Projects status sync.`);
+  const projectStatus = projectString(projects.statuses?.[lifecycleStatus]) ?? DEFAULT_PROJECT_STATUSES[lifecycleStatus];
+  const fetchGraphQL = ghGraphQLFetch(bin, spawnFn, extraEnv, timeoutMs);
+  const field = await resolveProjectStatusField({ projectId, token: "gh-cli", fetchGraphQL });
+  const option = field.options.find((candidate) => candidate.name.toLowerCase() === projectStatus.toLowerCase() || candidate.id === projectStatus);
+  if (!option)
+    throw new Error(`GitHub Project ${projectId} Status field does not contain option "${projectStatus}".`);
+  const item = await ensureIssueProjectItem({ projectId, issueNodeId, token: "gh-cli", fetchGraphQL });
+  await updateIssueProjectStatus({
+    projectId,
+    itemId: item.id,
+    fieldId: projectString(projects.statusFieldId) ?? field.id,
+    optionId: option.id,
+    token: "gh-cli",
+    fetchGraphQL
+  });
+}
+var TERMINAL_TASK_STATUSES = new Set(["closed", "completed", "merged", "cancelled", "resolved", "done"]);
+function normalizeTaskStatusToken(status) {
+  return status?.trim().toLowerCase().replace(/[-\s]+/g, "_") ?? "";
+}
+function issueUpdatesMode(value) {
+  return value === "off" || value === "minimal" || value === "lifecycle" ? value : "lifecycle";
+}
+function isTerminalTaskStatus(status) {
+  return TERMINAL_TASK_STATUSES.has(normalizeTaskStatusToken(status));
+}
+function shouldWriteIssueUpdate(mode, status) {
+  if (mode === "off")
+    return false;
+  if (mode === "lifecycle")
+    return true;
+  return isTerminalTaskStatus(status);
+}
+function isRunningStatus(status) {
+  return normalizeTaskStatusToken(status) === "running";
+}
+function assignRunningIssue(bin, repo, spawnFn, id, assignee, extraEnv, timeoutMs) {
+  runGhVoid(bin, ["issue", "edit", String(id), "--repo", repo, "--add-assignee", assignee?.trim() || "@me"], spawnFn, extraEnv, timeoutMs);
+}
 function statusLabelFor(status) {
   switch (status) {
+    case "running":
     case "in_progress":
       return "in-progress";
     case "blocked":
@@ -231,6 +581,8 @@ function statusLabelFor(status) {
       return "under-review";
     case "needs_attention":
       return "blocked";
+    case "closed":
+    case "completed":
     case "open":
       return null;
     default:
@@ -239,11 +591,13 @@ function statusLabelFor(status) {
 }
 function rigStatusLabelFor(status) {
   switch (status) {
+    case "running":
     case "in_progress":
       return "rig:running";
     case "under_review":
       return "rig:pr-open";
     case "closed":
+    case "completed":
       return "rig:done";
     case "ci_fixing":
       return "rig:ci-fixing";
@@ -261,9 +615,10 @@ function rigStatusLabelFor(status) {
       return null;
   }
 }
-function applyIssueStatus(bin, repo, spawnFn, id, status, extraEnv, timeoutMs) {
-  const targetLabel = status === "closed" ? null : statusLabelFor(status);
+async function applyIssueStatus(bin, repo, spawnFn, id, status, projects, runningAssignee, issueUpdates, extraEnv, timeoutMs) {
+  const targetLabel = status === "closed" || status === "completed" ? null : statusLabelFor(status);
   const targetRigLabel = rigStatusLabelFor(status);
+  const shouldSyncLifecycle = shouldWriteIssueUpdate(issueUpdates, status);
   for (const l of [...STATUS_LABELS, ...RIG_STATUS_LABELS]) {
     if (targetLabel !== null && l === targetLabel)
       continue;
@@ -285,7 +640,19 @@ function applyIssueStatus(bin, repo, spawnFn, id, status, extraEnv, timeoutMs) {
       runGhVoid(bin, ["issue", "edit", String(id), "--repo", repo, "--add-label", label], spawnFn, extraEnv, timeoutMs);
     }
   }
-  if (status === "closed") {
+  if (isRunningStatus(status)) {
+    assignRunningIssue(bin, repo, spawnFn, id, runningAssignee, extraEnv, timeoutMs);
+    if (shouldSyncLifecycle) {
+      upsertRigStickyComment(bin, repo, spawnFn, String(id), buildRigStickyStatusComment({
+        status: "running",
+        summary: "Rig run started."
+      }), extraEnv, timeoutMs);
+    }
+  }
+  if (shouldSyncLifecycle) {
+    await syncGitHubProjectStatus(bin, repo, spawnFn, id, status, projects, extraEnv, timeoutMs);
+  }
+  if (status === "closed" || status === "completed") {
     runGhVoid(bin, ["issue", "close", String(id), "--repo", repo], spawnFn, extraEnv, timeoutMs);
   }
 }
@@ -355,11 +722,11 @@ function applyLabels(bin, repo, spawnFn, id, labels, action, extraEnv, timeoutMs
     } catch {}
   }
 }
-function applyIssueUpdate(bin, repo, spawnFn, id, update, extraEnv, timeoutMs) {
+async function applyIssueUpdate(bin, repo, spawnFn, id, update, projects, runningAssignee, issueUpdates, extraEnv, timeoutMs) {
   if (update.status) {
-    applyIssueStatus(bin, repo, spawnFn, id, update.status, extraEnv, timeoutMs);
+    await applyIssueStatus(bin, repo, spawnFn, id, update.status, projects, runningAssignee, issueUpdates, extraEnv, timeoutMs);
   }
-  if (update.comment?.trim()) {
+  if (update.comment?.trim() && shouldWriteIssueUpdate(issueUpdates, update.status)) {
     if (isRigStickyStatusComment(update.comment)) {
       upsertRigStickyComment(bin, repo, spawnFn, String(id), update.comment, extraEnv, timeoutMs);
     } else {
@@ -385,6 +752,17 @@ function createGitHubIssuesTaskSource(opts) {
   const spawnFn = opts.spawn ?? spawnSync;
   const timeoutMs = Math.max(1000, Math.trunc(opts.timeoutMs ?? DEFAULT_GH_TIMEOUT_MS));
   const listLimit = Math.max(1, Math.trunc(opts.listLimit ?? DEFAULT_GITHUB_ISSUE_LIST_LIMIT));
+  const issueUpdates = issueUpdatesMode(opts.issueUpdates);
+  async function issueToTaskWithOptionalNativeDependencies(issue, env) {
+    if (!opts.useNativeDependencies)
+      return issueToTask(issue, repo);
+    const nativeDependencies = await readNativeDependenciesForIssue({
+      issue,
+      repo,
+      fetchGraphQL: ghGraphQLFetch(bin, spawnFn, env, timeoutMs)
+    });
+    return issueToTask(issue, repo, nativeDependencies);
+  }
   return {
     id: "std:github-issues",
     kind: "github-issues",
@@ -411,12 +789,13 @@ function createGitHubIssuesTaskSource(opts) {
         throw new Error(`GitHub issue list for ${repo} reached the configured limit (${listLimit}); refusing to silently truncate matching issues. Increase taskSource.options.listLimit or narrow labels/state/assignee.`);
       }
       const issues = rawIssues.filter((issue) => !issue.pull_request);
-      return issues.map((i) => issueToTask(i, repo));
+      return Promise.all(issues.map((issue) => issueToTaskWithOptionalNativeDependencies(issue, env)));
     },
     async get(id) {
+      const env = await resolveCredentialEnv(opts, "selected-repo");
+      let issue;
       try {
-        const env = await resolveCredentialEnv(opts, "selected-repo");
-        const issue = runGh(bin, [
+        issue = runGh(bin, [
           "issue",
           "view",
           String(id),
@@ -425,19 +804,23 @@ function createGitHubIssuesTaskSource(opts) {
           "--json",
           "number,title,body,labels,state,url,assignees,id"
         ], spawnFn, env, timeoutMs);
-        return issueToTask(issue, repo);
-      } catch {
-        return;
+      } catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        if (/could not resolve to (an? )?(issue|pullrequest)|no issues? (found|matched)|404 not found|gh: not found|gh issue view\b[\s\S]*failed \(exit \d+\): not found\b/i.test(detail)) {
+          return;
+        }
+        throw new Error(`Failed to read task ${id} from GitHub repo ${repo}: ${detail}`);
       }
+      return issueToTaskWithOptionalNativeDependencies(issue, env);
     },
     async updateStatus(id, status) {
       const env = await resolveCredentialEnv(opts, "selected-repo");
-      applyIssueStatus(bin, repo, spawnFn, id, status, env, timeoutMs);
+      await applyIssueStatus(bin, repo, spawnFn, id, status, opts.projects, opts.assignee, issueUpdates, env, timeoutMs);
       notifyTaskChanged(opts.onTaskChanged, repo, id, status);
     },
     async updateTask(id, update) {
       const env = await resolveCredentialEnv(opts, "selected-repo");
-      applyIssueUpdate(bin, repo, spawnFn, id, update, env, timeoutMs);
+      await applyIssueUpdate(bin, repo, spawnFn, id, update, opts.projects, opts.assignee, issueUpdates, env, timeoutMs);
       notifyTaskChanged(opts.onTaskChanged, repo, id, update.status);
     },
     async addLabels(id, labels) {
@@ -452,6 +835,7 @@ function createGitHubIssuesTaskSource(opts) {
     },
     async createIssue(input) {
       const env = await resolveCredentialEnv(opts, "selected-repo");
+      const body = input.body ?? "";
       const args = [
         "api",
         "-X",
@@ -460,12 +844,31 @@ function createGitHubIssuesTaskSource(opts) {
         "-f",
         `title=${input.title}`,
         "-f",
-        `body=${input.body ?? ""}`,
+        `body=${body}`,
         ...(input.labels ?? []).flatMap((label) => ["-f", `labels[]=${label}`])
       ];
       const issue = runGh(bin, args, spawnFn, env, timeoutMs);
       notifyTaskChanged(opts.onTaskChanged, repo, String(issue.number));
-      return issueToTask(issue, repo);
+      return issueToTask({ ...issue, body: issue.body ?? body }, repo);
+    },
+    async create(input) {
+      const env = await resolveCredentialEnv(opts, "selected-repo");
+      const body = bodyForCreatedTask(input);
+      const args = [
+        "api",
+        "-X",
+        "POST",
+        `repos/${repo}/issues`,
+        "-f",
+        `title=${input.title}`,
+        "-f",
+        `body=${body}`,
+        "-f",
+        "labels[]=rig:generated"
+      ];
+      const issue = runGh(bin, args, spawnFn, env, timeoutMs);
+      notifyTaskChanged(opts.onTaskChanged, repo, String(issue.number));
+      return issueToTask({ ...issue, body: issue.body ?? body }, repo);
     },
     async getIssueBody(id) {
       const env = await resolveCredentialEnv(opts, "selected-repo");
@@ -476,7 +879,7 @@ function createGitHubIssuesTaskSource(opts) {
 
 // packages/standard-plugin/src/files-source.ts
 import { readFileSync as readFileSync2, readdirSync, existsSync as existsSync2, statSync, writeFileSync } from "fs";
-import { join, basename } from "path";
+import { join, basename, isAbsolute, resolve as resolve2 } from "path";
 var DEFAULT_PATTERN = /\.(task\.)?json$/;
 function readTaskFile(file, pattern) {
   const raw = JSON.parse(readFileSync2(file, "utf-8"));
@@ -497,10 +900,11 @@ function readTaskFile(file, pattern) {
 }
 function createFilesTaskSource(opts) {
   const pattern = opts.pattern ?? DEFAULT_PATTERN;
-  const directory = opts.path ?? opts.dir;
-  if (!directory) {
+  const configured = opts.path ?? opts.dir;
+  if (!configured) {
     throw new Error("createFilesTaskSource: either `path` or `dir` must be provided");
   }
+  const directory = isAbsolute(configured) ? configured : resolve2(opts.projectRoot ?? process.cwd(), configured);
   const findTaskFile = (id) => {
     if (!existsSync2(directory))
       return;
@@ -577,7 +981,509 @@ function createFilesTaskSource(opts) {
   };
 }
 
-// packages/standard-plugin/src/index.ts
+// 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 as existsSync3 } from "fs";
+import { readdir, readFile, stat } from "fs/promises";
+import { basename as basename2, extname, relative, resolve as resolve3 } from "path";
+
+// packages/standard-plugin/src/drift/extract-refs.ts
+var INLINE_CODE = /`([^`\n]+)`/g;
+var MARKDOWN_LINK = /\[[^\]]+\]\(([^)\s]+)\)/g;
+var SYMBOL_REF = /^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)?$/;
+var PATH_REF = /^(?:\.\.?\/)?(?:[A-Za-z0-9_.-]+\/)+[A-Za-z0-9_.-]+$|^[A-Za-z0-9_.-]+\.(?:ts|tsx|js|jsx|mjs|cjs|json|md|mdx|css|scss|html|yml|yaml|toml|rs|go|py|rb|java|kt|swift|c|cc|cpp|h|hpp)$/;
+function stripFenceLines(markdown) {
+  const lines = markdown.split(/\r?\n/);
+  let fenced = false;
+  return lines.map((line) => {
+    if (/^\s*(```|~~~)/.test(line)) {
+      fenced = !fenced;
+      return "";
+    }
+    return fenced ? "" : line;
+  });
+}
+function normalizeToken(raw) {
+  return raw.trim().replace(/^['"]|['"]$/g, "").replace(/[),.;:]+$/g, "").replace(/#L\d+(?:-L\d+)?$/i, "");
+}
+function classifyReference(raw) {
+  if (raw.startsWith("@"))
+    return null;
+  if (PATH_REF.test(raw))
+    return "path";
+  if (SYMBOL_REF.test(raw))
+    return "symbol";
+  return null;
+}
+function pushReference(refs, seen, raw, line) {
+  const value = normalizeToken(raw);
+  if (!value)
+    return;
+  const kind = classifyReference(value);
+  if (!kind)
+    return;
+  const key = `${kind}:${value}:${line}`;
+  if (seen.has(key))
+    return;
+  seen.add(key);
+  refs.push({ kind, value, line });
+}
+function extractDriftReferences(markdown) {
+  const refs = [];
+  const seen = new Set;
+  const lines = stripFenceLines(markdown);
+  for (const [index, line] of lines.entries()) {
+    const lineNumber = index + 1;
+    for (const match of line.matchAll(INLINE_CODE)) {
+      pushReference(refs, seen, match[1] ?? "", lineNumber);
+    }
+    for (const match of line.matchAll(MARKDOWN_LINK)) {
+      pushReference(refs, seen, match[1] ?? "", lineNumber);
+    }
+  }
+  return refs;
+}
+
+// packages/standard-plugin/src/drift/git-adapter.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+function processError(value) {
+  return value && typeof value === "object" ? value : null;
+}
+function lineCount(output) {
+  const trimmed = output.trim();
+  return trimmed ? trimmed.split(/\r?\n/).length : 0;
+}
+function makeDriftGit(projectRoot) {
+  async function git(args) {
+    const result = await execFileAsync("git", [...args], {
+      cwd: projectRoot,
+      encoding: "utf8",
+      maxBuffer: 10 * 1024 * 1024
+    });
+    return String(result.stdout);
+  }
+  async function grepCountAt(symbolOrPath, commit) {
+    try {
+      return lineCount(await git(["grep", "-F", "-n", "-e", symbolOrPath, commit, "--"]));
+    } catch (error) {
+      const detail = processError(error);
+      if (detail?.code === 1)
+        return 0;
+      throw error;
+    }
+  }
+  return {
+    async lastCommitTouching(path) {
+      const commit = (await git(["log", "-n", "1", "--format=%H", "--", path])).trim();
+      return commit || "HEAD";
+    },
+    async grepCount(symbolOrPath) {
+      return grepCountAt(symbolOrPath, "HEAD");
+    },
+    async grepCountAtCommit(symbolOrPath, commit) {
+      return grepCountAt(symbolOrPath, commit);
+    },
+    async wasRenamed(symbolOrPath, sinceCommit) {
+      if (!symbolOrPath.includes("/") && !symbolOrPath.includes("."))
+        return false;
+      try {
+        const output = await git(["log", "--name-status", "--format=", `${sinceCommit}..HEAD`]);
+        return output.split(/\r?\n/).some((line) => {
+          const match = line.match(/^R\d*\s+(.+?)\s+(.+)$/);
+          return Boolean(match && (match[1] === symbolOrPath || match[2] === symbolOrPath));
+        });
+      } catch (error) {
+        const detail = processError(error);
+        if (detail?.code === 128)
+          return false;
+        throw error;
+      }
+    }
+  };
+}
+
+// packages/standard-plugin/src/drift/detect.ts
+var DEFAULT_IGNORED_DIRS = {
+  ".git": true,
+  node_modules: true,
+  dist: true,
+  build: true,
+  coverage: true,
+  ".next": true,
+  vendor: true
+};
+var SOURCE_EXTENSIONS = {
+  ".ts": true,
+  ".tsx": true,
+  ".js": true,
+  ".jsx": true,
+  ".mjs": true,
+  ".cjs": true,
+  ".rs": true,
+  ".go": true,
+  ".py": true,
+  ".rb": true,
+  ".java": true,
+  ".kt": true,
+  ".swift": true,
+  ".c": true,
+  ".cc": true,
+  ".cpp": true,
+  ".h": true,
+  ".hpp": true,
+  ".json": true,
+  ".toml": true,
+  ".yml": true,
+  ".yaml": true
+};
+function globLikeMatch(path, pattern) {
+  if (pattern === path)
+    return true;
+  if (pattern.startsWith("**/*"))
+    return path.endsWith(pattern.slice(4));
+  if (pattern.endsWith("/**"))
+    return path.startsWith(pattern.slice(0, -3));
+  if (pattern.includes("*")) {
+    const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+    return new RegExp(`^${escaped}$`).test(path);
+  }
+  return path.startsWith(pattern);
+}
+function isDefaultDoc(path) {
+  const lower = basename2(path).toLowerCase();
+  return (path.endsWith(".md") || path.endsWith(".mdx")) && !lower.startsWith("changelog") && !lower.includes("generated");
+}
+function isIgnored(path, patterns) {
+  return (patterns ?? []).some((pattern) => globLikeMatch(path, pattern));
+}
+async function collectFiles(root, options) {
+  const files = [];
+  async function visit(dir) {
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+      if (entry.isDirectory() && DEFAULT_IGNORED_DIRS[entry.name])
+        continue;
+      const absolute = resolve3(dir, entry.name);
+      const rel = relative(root, absolute).replace(/\\/g, "/");
+      if (isIgnored(rel, options.ignore))
+        continue;
+      if (entry.isDirectory()) {
+        await visit(absolute);
+        continue;
+      }
+      if (!entry.isFile())
+        continue;
+      if (options.docs) {
+        const matchesConfigured = options.patterns && options.patterns.length > 0 ? options.patterns.some((pattern) => globLikeMatch(rel, pattern)) : isDefaultDoc(rel);
+        if (matchesConfigured)
+          files.push(rel);
+        continue;
+      }
+      if (SOURCE_EXTENSIONS[extname(entry.name)])
+        files.push(rel);
+    }
+  }
+  await visit(root);
+  return files.sort();
+}
+async function sourceReferenceCount(projectRoot, reference, docPath) {
+  if (reference.kind === "path")
+    return existsSync3(resolve3(projectRoot, reference.value)) ? 1 : 0;
+  let count = 0;
+  const sourceFiles = await collectFiles(projectRoot, { docs: false });
+  for (const sourceFile of sourceFiles) {
+    if (sourceFile === docPath)
+      continue;
+    const text = await readFile(resolve3(projectRoot, sourceFile), "utf8").catch(() => "");
+    if (text.includes(reference.value))
+      count += 1;
+  }
+  return count;
+}
+function deletedReferenceFinding(docPath, reference) {
+  return {
+    kind: "deleted-reference",
+    docPath,
+    line: reference.line,
+    reference: reference.value,
+    detail: `Documented reference "${reference.value}" no longer exists in the source tree.`,
+    confidence: "high"
+  };
+}
+function staleAnchorFinding(docPath, reference) {
+  return {
+    kind: "stale-anchor",
+    docPath,
+    line: reference.line,
+    reference: reference.value,
+    detail: `Documented path "${reference.value}" changed after this doc was last updated.`,
+    confidence: "medium"
+  };
+}
+async function detectDeletedReferences(projectRoot, docPath, git = makeDriftGit(projectRoot)) {
+  const markdown = await readFile(resolve3(projectRoot, docPath), "utf8");
+  const docCommit = await git.lastCommitTouching(docPath);
+  const findings = [];
+  for (const reference of extractDriftReferences(markdown)) {
+    if (await sourceReferenceCount(projectRoot, reference, docPath) > 0)
+      continue;
+    if (await git.wasRenamed(reference.value, docCommit))
+      continue;
+    findings.push(deletedReferenceFinding(docPath, reference));
+  }
+  return findings;
+}
+async function detectStaleAnchors(projectRoot, docPath, git = makeDriftGit(projectRoot)) {
+  const markdown = await readFile(resolve3(projectRoot, docPath), "utf8");
+  const docCommit = await git.lastCommitTouching(docPath);
+  const findings = [];
+  for (const reference of extractDriftReferences(markdown).filter((ref) => ref.kind === "path")) {
+    if (!existsSync3(resolve3(projectRoot, reference.value)))
+      continue;
+    const sourceStat = await stat(resolve3(projectRoot, reference.value)).catch(() => null);
+    if (!sourceStat?.isFile())
+      continue;
+    const sourceCommit = await git.lastCommitTouching(reference.value);
+    if (sourceCommit !== docCommit && !await git.wasRenamed(reference.value, docCommit)) {
+      findings.push(staleAnchorFinding(docPath, reference));
+    }
+  }
+  return findings;
+}
+async function detectDrift(options) {
+  const git = options.git ?? makeDriftGit(options.projectRoot);
+  const docs = await collectFiles(options.projectRoot, {
+    docs: true,
+    ...options.docsGlobs !== undefined ? { patterns: options.docsGlobs } : {},
+    ...options.ignoreGlobs !== undefined ? { ignore: options.ignoreGlobs } : {}
+  });
+  const findings = [];
+  let degraded = false;
+  for (const docPath of docs) {
+    try {
+      findings.push(...await detectDeletedReferences(options.projectRoot, docPath, git));
+      findings.push(...await detectStaleAnchors(options.projectRoot, docPath, git));
+    } catch {
+      degraded = true;
+    }
+  }
+  return {
+    generatedAt: new Date().toISOString(),
+    scanned: docs.length,
+    degraded,
+    findings
+  };
+}
+
+// packages/standard-plugin/src/drift/plugin.ts
+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]";
+function highConfidenceDriftFindings(report) {
+  return report.findings.filter((finding) => finding.confidence === "high");
+}
+function driftGateResult(report, mode = "enforce") {
+  const high = highConfidenceDriftFindings(report);
+  if (mode === "enforce" && high.length > 0) {
+    return { kind: "block", reason: `${high.length} high-confidence documentation drift finding(s).` };
+  }
+  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);
+  const passed = options.failOnDrift ? high.length === 0 : true;
+  const findingWord = report.findings.length === 1 ? "finding" : "findings";
+  return {
+    id: DOCS_DRIFT_VALIDATOR_ID,
+    passed,
+    summary: `docs drift scanned ${report.scanned} doc(s), ${report.findings.length} ${findingWord}`,
+    details: JSON.stringify(report)
+  };
+}
+function createDocsDriftValidator(options = {}) {
+  return {
+    ...DOCS_DRIFT_VALIDATOR,
+    async run(ctx) {
+      return runDocsDriftValidation({
+        projectRoot: ctx.workspaceRoot,
+        ...options.docsGlobs !== undefined ? { docsGlobs: options.docsGlobs } : {},
+        ...options.ignoreGlobs !== undefined ? { ignoreGlobs: options.ignoreGlobs } : {},
+        ...options.failOnDrift !== undefined ? { failOnDrift: options.failOnDrift } : {}
+      });
+    }
+  };
+}
+function takeOptionValue(args, index, flag) {
+  const value = args[index + 1];
+  if (!value)
+    throw new Error(`${flag} requires a value`);
+  return value;
+}
+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 takeOption(args, flag) {
+  const rest = [...args];
+  const index = rest.indexOf(flag);
+  if (index < 0)
+    return { rest };
+  const value = rest[index + 1];
+  if (!value || value.startsWith("-"))
+    throw new Error(`${flag} requires a value.`);
+  rest.splice(index, 2);
+  return { value, rest };
+}
+function requireNoExtraArgs(args, usage) {
+  if (args.length > 0)
+    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 };
+}
+async function executeDrift(context, args, options = {}) {
+  const json = takeFlag(args, "--json");
+  const docs = takeOption(json.rest, "--docs");
+  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 effectiveDocsGlobs = docsGlobs.length > 0 ? docsGlobs : options.docsGlobs;
+  const effectiveIgnoreGlobs = ignoreGlobs.length > 0 ? ignoreGlobs : options.ignoreGlobs;
+  const effectiveFailOnDrift = failOnDrift.value || options.failOnDrift === true;
+  const report = await detectDrift({
+    projectRoot: context.projectRoot,
+    ...effectiveDocsGlobs !== undefined ? { docsGlobs: effectiveDocsGlobs } : {},
+    ...effectiveIgnoreGlobs !== undefined ? { ignoreGlobs: effectiveIgnoreGlobs } : {}
+  });
+  const failed = effectiveFailOnDrift && highConfidenceDriftFindings(report).length > 0;
+  const details = { report, summary: driftSummary(report), failOnDrift: effectiveFailOnDrift, failed };
+  if (context.outputMode === "text") {
+    if (json.value)
+      console.log(JSON.stringify(details, null, 2));
+    else
+      console.log(report.findings.length === 0 ? `No drift findings across ${report.scanned} documents.` : report.findings.map((finding) => `${finding.docPath}:${finding.line ?? "?"}	${finding.kind}	${finding.confidence}	${finding.detail}`).join(`
+`));
+  }
+  return { ok: !failed, group: "drift", command: "scan", details };
+}
+function createDocsDriftRuntimeCliCommand(options = {}) {
+  return {
+    id: DOCS_DRIFT_CLI_ID,
+    family: "drift",
+    command: DOCS_DRIFT_CLI_COMMAND,
+    description: "Scan documentation for stale code references.",
+    usage: DOCS_DRIFT_CLI_COMMAND,
+    projectRequired: true,
+    run: (context, args) => executeDrift(context, args, options)
+  };
+}
+var DOCS_DRIFT_RUNTIME_CLI_COMMAND = createDocsDriftRuntimeCliCommand();
+async function runDriftCli(args, options = {}) {
+  const docsGlobs = [];
+  const ignoreGlobs = [];
+  let json = false;
+  let failOnDrift = false;
+  for (let index = 0;index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--json") {
+      json = true;
+      continue;
+    }
+    if (arg === "--fail-on-drift") {
+      failOnDrift = true;
+      continue;
+    }
+    if (arg === "--docs") {
+      docsGlobs.push(takeOptionValue(args, index, arg));
+      index += 1;
+      continue;
+    }
+    if (arg === "--ignore") {
+      ignoreGlobs.push(takeOptionValue(args, index, arg));
+      index += 1;
+      continue;
+    }
+    throw new Error(`Unknown rig drift argument: ${arg}`);
+  }
+  const report = await detectDrift({
+    projectRoot: options.projectRoot ?? process.cwd(),
+    ...docsGlobs.length > 0 ? { docsGlobs } : {},
+    ...ignoreGlobs.length > 0 ? { ignoreGlobs } : {}
+  });
+  const write = options.write ?? ((message) => console.log(message));
+  if (json) {
+    write(JSON.stringify(report));
+  } else {
+    write(`Scanned ${report.scanned} doc(s); ${report.findings.length} drift finding(s).`);
+    for (const finding of report.findings) {
+      write(`${finding.confidence.toUpperCase()} ${finding.kind} ${finding.docPath}${finding.line ? `:${finding.line}` : ""} ${finding.reference ?? ""} \u2014 ${finding.detail}`);
+    }
+  }
+  const high = highConfidenceDriftFindings(report);
+  if (failOnDrift && high.length > 0) {
+    options.writeError?.(`${high.length} high-confidence drift finding(s).`);
+    return 2;
+  }
+  return 0;
+}
+// packages/standard-plugin/src/drift/judge.ts
+async function judgeDocumentationDrift(provider, input) {
+  const result = await provider.judge(input);
+  return result.mismatches.map((mismatch) => ({
+    kind: "semantic-mismatch",
+    docPath: input.docPath,
+    line: mismatch.line ?? null,
+    reference: mismatch.reference ?? input.reference ?? null,
+    detail: mismatch.detail,
+    confidence: mismatch.confidence ?? "medium"
+  }));
+}
+// packages/standard-plugin/src/plugin.ts
+var DOCS_HEALTH_PANEL_ID = "docs-health";
 function requireStringField(config, field, kind) {
   const value = config[field];
   if (!value) {
@@ -585,11 +1491,78 @@ function requireStringField(config, field, kind) {
   }
   return value;
 }
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function optionalString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function parseGitHubProjectsOptions(value) {
+  if (!isRecord(value))
+    return;
+  const statusesSource = isRecord(value.statuses) ? value.statuses : undefined;
+  const statuses = {};
+  for (const key of ["todo", "running", "prOpen", "ciFixing", "merging", "done", "needsAttention"]) {
+    const status = optionalString(statusesSource?.[key]);
+    if (status)
+      statuses[key] = status;
+  }
+  const parsed = {};
+  if (typeof value.enabled === "boolean")
+    parsed.enabled = value.enabled;
+  const projectId = optionalString(value.projectId);
+  if (projectId)
+    parsed.projectId = projectId;
+  const statusFieldId = optionalString(value.statusFieldId);
+  if (statusFieldId)
+    parsed.statusFieldId = statusFieldId;
+  if (Object.keys(statuses).length > 0)
+    parsed.statuses = statuses;
+  return parsed;
+}
+function githubProjectsOptionsFromConfig(config, context) {
+  const rigConfig = isRecord(context?.rigConfig) ? context.rigConfig : undefined;
+  const github = isRecord(rigConfig?.github) ? rigConfig.github : undefined;
+  return parseGitHubProjectsOptions(config.options?.projects) ?? parseGitHubProjectsOptions(github?.projects);
+}
+function booleanOption(value) {
+  return typeof value === "boolean" ? value : undefined;
+}
+function panelProjectRoot(context) {
+  return isRecord(context) && typeof context.projectRoot === "string" && context.projectRoot.length > 0 ? context.projectRoot : null;
+}
+function driftFindingPanelId(finding, index) {
+  return `${finding.docPath}:${finding.line ?? index}:${finding.kind}`;
+}
+function createDocsHealthPanelProducer(options = {}) {
+  return async (context) => {
+    const projectRoot = panelProjectRoot(context);
+    if (!projectRoot)
+      return;
+    const report = await detectDrift({
+      projectRoot,
+      ...options.docsGlobs !== undefined ? { docsGlobs: options.docsGlobs } : {},
+      ...options.ignoreGlobs !== undefined ? { ignoreGlobs: options.ignoreGlobs } : {}
+    });
+    return {
+      findings: report.findings.map((finding, index) => ({
+        id: driftFindingPanelId(finding, index),
+        docPath: finding.docPath,
+        kind: finding.kind,
+        confidence: finding.confidence,
+        summary: finding.detail,
+        taskId: null
+      })),
+      degraded: report.degraded ? "drift scan degraded" : null
+    };
+  };
+}
 function standardPlugin(opts = {}) {
   return definePlugin({
     name: "rig-standard",
     version: "0.1.0",
     contributes: {
+      validators: [DOCS_DRIFT_VALIDATOR],
       taskSources: [
         {
           id: "std:github-issues",
@@ -601,21 +1574,46 @@ function standardPlugin(opts = {}) {
           kind: "files",
           description: "JSON files in a local directory"
         }
-      ]
+      ],
+      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 }
+      ],
+      cliCommands: [
+        {
+          id: DOCS_DRIFT_CLI_ID,
+          family: "drift",
+          command: DOCS_DRIFT_CLI_COMMAND,
+          description: "Scan documentation for stale code references.",
+          projectRequired: true
+        }
+      ],
+      stageMutations: [DOCS_DRIFT_STAGE_MUTATION]
     }
   }, {
+    validators: [createDocsDriftValidator(opts.drift)],
+    stages: { [DOCS_DRIFT_STAGE_ID]: createDocsDriftGateStage(opts.drift) },
+    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.drift) }
+    ],
+    cliCommands: [createDocsDriftRuntimeCliCommand(opts.drift)],
     taskSources: [
       {
         id: "std:github-issues",
         kind: "github-issues",
         description: "GitHub Issues via gh CLI",
-        factory(config) {
+        factory(config, context) {
           const options = {
             owner: requireStringField(config, "owner", "github-issues"),
             repo: requireStringField(config, "repo", "github-issues")
           };
-          if (opts.githubCredentialProvider)
-            options.credentialProvider = opts.githubCredentialProvider;
+          const credentialProviderOptions = context?.projectRoot ? { stateDir: resolve4(context.projectRoot, ".rig", "state") } : {};
+          options.credentialProvider = opts.githubCredentialProvider ?? createStateGitHubCredentialProvider(credentialProviderOptions);
           if (opts.githubWorkspaceId)
             options.workspaceId = opts.githubWorkspaceId;
           if (opts.githubUserId)
@@ -637,6 +1635,12 @@ function standardPlugin(opts = {}) {
           const listLimit = typeof config.options?.listLimit === "number" ? config.options.listLimit : undefined;
           if (listLimit !== undefined)
             options.listLimit = listLimit;
+          const projects = githubProjectsOptionsFromConfig(config, context);
+          if (projects)
+            options.projects = projects;
+          const useNativeDependencies = booleanOption(config.options?.useNativeDependencies);
+          if (useNativeDependencies !== undefined)
+            options.useNativeDependencies = useNativeDependencies;
           return createGitHubIssuesTaskSource(options);
         }
       },
@@ -644,19 +1648,55 @@ function standardPlugin(opts = {}) {
         id: "std:files",
         kind: "files",
         description: "JSON files in a local directory",
-        factory(config) {
+        factory(config, context) {
           return createFilesTaskSource({
-            path: requireStringField(config, "path", "files")
+            path: requireStringField(config, "path", "files"),
+            ...context?.projectRoot ? { projectRoot: context.projectRoot } : {}
           });
         }
       }
     ]
   });
 }
+// packages/standard-plugin/src/bundle.ts
+import { createBlockerClassifierPlugin } from "@rig/blocker-classifier-plugin/plugin";
+import { createDefaultLifecyclePlugin } from "@rig/bundle-default-lifecycle/plugin";
+import { createDependencyGraphPlugin } from "@rig/dependency-graph-plugin/plugin";
+import { createPlanningPlugin } from "@rig/planning-plugin/plugin";
+import { createSupervisorPlugin } from "@rig/supervisor-plugin/plugin";
+function standardProjectPlugins(options = {}) {
+  return [
+    createDefaultLifecyclePlugin(),
+    createDependencyGraphPlugin(),
+    createBlockerClassifierPlugin(),
+    createPlanningPlugin(),
+    createSupervisorPlugin(),
+    standardPlugin(options.standard)
+  ];
+}
 export {
+  standardProjectPlugins,
+  runDriftCli,
+  runDocsDriftValidation,
+  makeDriftGit,
+  judgeDocumentationDrift,
+  extractDriftReferences,
+  executeDrift,
+  driftGateResult,
+  detectStaleAnchors,
+  detectDrift,
+  detectDeletedReferences,
   standardPlugin as default,
   createStateGitHubCredentialProvider,
   createGitHubIssuesTaskSource,
   createFilesTaskSource,
-  createEnvGitHubCredentialProvider
+  createEnvGitHubCredentialProvider,
+  createDocsDriftValidator,
+  createDocsDriftRuntimeCliCommand,
+  DOCS_HEALTH_PANEL_ID,
+  DOCS_DRIFT_VALIDATOR_ID,
+  DOCS_DRIFT_STAGE_ID,
+  DOCS_DRIFT_RUNTIME_CLI_COMMAND,
+  DOCS_DRIFT_CLI_ID,
+  DOCS_DRIFT_CAPABILITY_ID
 };