Add integrations and prompt inputs for issue notifications

.github/workflows/local.yml

@@ -38,6 +38,13 @@ on:
         description: issue_body
         required: false
         default: 'A Doc Detective run ($RUN_URL) failed with the following results:$RESULTS'
+      integrations:
+        description: integrations
+        required: false
+        default: ''
+      prompt:
+        description: prompt
+        required: false
 
 permissions:
   contents: write
@@ -59,3 +66,5 @@ jobs:
         id: dd
         with:
           config: ./artifacts/.doc-detective.json
+          integrations: ${{ github.event.inputs.integrations }}
+          prompt: ${{ github.event.inputs.prompt }}

.github/workflows/main.yml

@@ -42,6 +42,13 @@ on:
         description: issue_body
         required: false
         default: 'A Doc Detective run ($RUN_URL) failed with the following results:$RESULTS'
+      integrations:
+        description: integrations
+        required: false
+        default: ''
+      prompt:
+        description: prompt
+        required: false
 
 permissions:
   contents: write
@@ -71,3 +78,5 @@ jobs:
           exit_on_fail: ${{ github.event.inputs.exit_on_fail }}
           create_issue_on_fail: ${{ github.event.inputs.create_issue_on_fail }}
           issue_body: ${{ github.event.inputs.issue_body }}
+          integrations: ${{ github.event.inputs.integrations }}
+          prompt: ${{ github.event.inputs.prompt }}

.github/workflows/test.yml

@@ -44,3 +44,24 @@ jobs:
           config: ./artifacts/.doc-detective.json
           input: ./artifacts/doc-content-inline-tests-fail.md
           exit_on_fail: true
+
+  fail-tests-with-integrations:
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    name: Fail tests with integrations
+    permissions:
+      contents: read
+      issues: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run Doc Detective
+        uses: ./
+        id: dd
+        continue-on-error: true
+        with:
+          config: ./artifacts/.doc-detective.json
+          input: ./artifacts/doc-content-inline-tests-fail.md
+          exit_on_fail: true
+          create_issue_on_fail: true
+          integrations: doc-sentinel,claude
+          prompt: "Investigate the failures and suggest fixes"

action.yml

@@ -59,7 +59,7 @@ inputs:
     required: false
     default: "Doc Detective Failure"
   issue_body:
-    description: The body of the created GitHub issue. `$RESULTS` inserts the results object. `$RUN_URL` inserts the URL of the workflow that created the issue. Only valid if "create_issue_on_fail" is set to "true".
+    description: The body of the created GitHub issue. `$RESULTS` inserts the results object. `$RUN_URL` inserts the URL of the workflow that created the issue. `$PROMPT` inserts the prompt text. Only valid if "create_issue_on_fail" is set to "true".
     required: false
     default: "A Doc Detective run ($RUN_URL) failed with the following results:$RESULTS"
   issue_labels:
@@ -70,6 +70,24 @@ inputs:
     description: Comma-separated list of GitHub usernames to assign to the GitHub issue. Only valid if "create_issue_on_fail" is set to "true".
     required: false
     default: ""
+  integrations:
+    description: >-
+      Comma-separated list of integrations to notify in the created GitHub issue. When specified, matching integrations are triggered via mentions or commands in a collapsible "Integrations" section appended to the issue body.
+
+      Supported values: "doc-sentinel", "promptless", "dosu", "claude", "opencode", "copilot". Invalid values are ignored with a warning.
+
+      The "copilot" integration auto-assigns the issue to Copilot instead of adding to the accordion.
+
+      Only valid if "create_issue_on_fail" is set to "true".
+    required: false
+    default: ""
+  prompt:
+    description: >-
+      The prompt passed to integrations. For example, if `integrations` is set to `claude`, the issue includes "@claude <prompt_value>". Also available as `$PROMPT` in the `issue_body` template.
+
+      Only valid if "create_issue_on_fail" is set to "true".
+    required: false
+    default: "Investigate potential causes of the failures reported in this Doc Detective test output and suggest fixes."
   token:
     description: The GitHub token to use for creating issues. Defaults to the token already available to the GitHub Action workflow. Only set this if you want to override the default token.
     required: false

dist/index.js

@@ -2759,7 +2759,7 @@ class HttpClient {
         }
         const usingSsl = parsedUrl.protocol === 'https:';
         proxyAgent = new undici_1.ProxyAgent(Object.assign({ uri: proxyUrl.href, pipelining: !this._keepAlive ? 0 : 1 }, ((proxyUrl.username || proxyUrl.password) && {
-            token: `${proxyUrl.username}:${proxyUrl.password}`
+            token: `Basic ${Buffer.from(`${proxyUrl.username}:${proxyUrl.password}`).toString('base64')}`
         })));
         this._proxyAgentDispatcher = proxyAgent;
         if (usingSsl && this._ignoreSslError) {
@@ -2873,11 +2873,11 @@ function getProxyUrl(reqUrl) {
     })();
     if (proxyVar) {
         try {
-            return new URL(proxyVar);
+            return new DecodedURL(proxyVar);
         }
         catch (_a) {
             if (!proxyVar.startsWith('http://') && !proxyVar.startsWith('https://'))
-                return new URL(`http://${proxyVar}`);
+                return new DecodedURL(`http://${proxyVar}`);
         }
     }
     else {
@@ -2936,6 +2936,19 @@ function isLoopbackAddress(host) {
         hostLower.startsWith('[::1]') ||
         hostLower.startsWith('[0:0:0:0:0:0:0:1]'));
 }
+class DecodedURL extends URL {
+    constructor(url, base) {
+        super(url, base);
+        this._decodedUsername = decodeURIComponent(super.username);
+        this._decodedPassword = decodeURIComponent(super.password);
+    }
+    get username() {
+        return this._decodedUsername;
+    }
+    get password() {
+        return this._decodedPassword;
+    }
+}
 //# sourceMappingURL=proxy.js.map
 
 /***/ }),
@@ -3545,25 +3558,40 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // pkg/dist-src/index.js
-var dist_src_exports = {};
-__export(dist_src_exports, {
+var index_exports = {};
+__export(index_exports, {
   Octokit: () => Octokit
 });
-module.exports = __toCommonJS(dist_src_exports);
+module.exports = __toCommonJS(index_exports);
 var import_universal_user_agent = __nccwpck_require__(3843);
 var import_before_after_hook = __nccwpck_require__(2732);
 var import_request = __nccwpck_require__(8636);
 var import_graphql = __nccwpck_require__(7);
 var import_auth_token = __nccwpck_require__(7864);
 
 // pkg/dist-src/version.js
-var VERSION = "5.1.0";
+var VERSION = "5.2.2";
 
 // pkg/dist-src/index.js
 var noop = () => {
 };
 var consoleWarn = console.warn.bind(console);
 var consoleError = console.error.bind(console);
+function createLogger(logger = {}) {
+  if (typeof logger.debug !== "function") {
+    logger.debug = noop;
+  }
+  if (typeof logger.info !== "function") {
+    logger.info = noop;
+  }
+  if (typeof logger.warn !== "function") {
+    logger.warn = consoleWarn;
+  }
+  if (typeof logger.error !== "function") {
+    logger.error = consoleError;
+  }
+  return logger;
+}
 var userAgentTrail = `octokit-core.js/${VERSION} ${(0, import_universal_user_agent.getUserAgent)()}`;
 var Octokit = class {
   static {
@@ -3637,15 +3665,7 @@ var Octokit = class {
     }
     this.request = import_request.request.defaults(requestDefaults);
     this.graphql = (0, import_graphql.withCustomRequest)(this.request).defaults(requestDefaults);
-    this.log = Object.assign(
-      {
-        debug: noop,
-        info: noop,
-        warn: consoleWarn,
-        error: consoleError
-      },
-      options.log
-    );
+    this.log = createLogger(options.log);
     this.hook = hook;
     if (!options.authStrategy) {
       if (!options.auth) {
@@ -4098,18 +4118,18 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // pkg/dist-src/index.js
-var dist_src_exports = {};
-__export(dist_src_exports, {
+var index_exports = {};
+__export(index_exports, {
   GraphqlResponseError: () => GraphqlResponseError,
   graphql: () => graphql2,
   withCustomRequest: () => withCustomRequest
 });
-module.exports = __toCommonJS(dist_src_exports);
+module.exports = __toCommonJS(index_exports);
 var import_request3 = __nccwpck_require__(8636);
 var import_universal_user_agent = __nccwpck_require__(3843);
 
 // pkg/dist-src/version.js
-var VERSION = "7.0.2";
+var VERSION = "7.1.1";
 
 // pkg/dist-src/with-defaults.js
 var import_request2 = __nccwpck_require__(8636);
@@ -4157,8 +4177,7 @@ function graphql(request2, query, options) {
       );
     }
     for (const key in options) {
-      if (!FORBIDDEN_VARIABLE_OPTIONS.includes(key))
-        continue;
+      if (!FORBIDDEN_VARIABLE_OPTIONS.includes(key)) continue;
       return Promise.reject(
         new Error(
           `[@octokit/graphql] "${key}" cannot be used as variable name`
@@ -31825,6 +31844,47 @@ const { execSync } = __nccwpck_require__(5317);
 const meta = { dist_interface: "github-actions" };
 process.env["DOC_DETECTIVE_META"] = JSON.stringify(meta);
 
+const INTEGRATION_MAP = {
+  "doc-sentinel": "\n/cc @reem-sab",
+  "promptless": "\n@promptless $PROMPT",
+  "dosu": "\n@dosu $PROMPT",
+  "claude": "\n@claude $PROMPT",
+  "opencode": "\n/opencode $PROMPT",
+};
+
+// All valid integration names (INTEGRATION_MAP keys + special-case integrations)
+const VALID_INTEGRATIONS = new Set([...Object.keys(INTEGRATION_MAP), "copilot"]);
+
+function parseIntegrations(integrationsInput) {
+  if (!integrationsInput || !integrationsInput.trim()) return [];
+
+  const requested = integrationsInput.split(",").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+  const valid = [];
+
+  for (const name of requested) {
+    if (VALID_INTEGRATIONS.has(name)) {
+      valid.push(name);
+    } else {
+      core.warning(
+        `Unknown integration "${name}". Supported integrations: ${[...VALID_INTEGRATIONS].join(", ")}`
+      );
+    }
+  }
+
+  return valid;
+}
+
+function buildIntegrationsAccordion(integrations, prompt) {
+  const accordionEntries = integrations
+    .filter((name) => name !== "copilot")
+    .map((name) => INTEGRATION_MAP[name].replace("$PROMPT", prompt))
+    .filter(Boolean);
+
+  if (accordionEntries.length === 0) return "";
+
+  return `\n\n<details>\n<summary>Integrations</summary>\n${accordionEntries.join("\n")}\n</details>`;
+}
+
 const repoOwner = github.context.repo.owner;
 const repoName = github.context.repo.repo;
 const runId = process.env.GITHUB_RUN_ID;
@@ -31968,23 +32028,48 @@ async function main() {
 async function createIssue(results) {
   const token = core.getInput("token");
   const title = core.getInput("issue_title");
+  const prompt = core.getInput("prompt");
+  const integrations = parseIntegrations(core.getInput("integrations"));
+  const integrationsAccordion = buildIntegrationsAccordion(integrations, prompt);
   const body = core
     .getInput("issue_body")
-    .replace("$RUN_URL", runURL)
-    .replace("$RESULTS", `\n\n\`\`\`json\n${results}\n\`\`\``);
-  const labels = core.getInput("issue_labels");
-  const assignees = core.getInput("issue_assignees");
+    .replaceAll("$RUN_URL", runURL)
+    .replaceAll("$RESULTS", `\n\n\`\`\`json\n${results}\n\`\`\``)
+    .replaceAll("$PROMPT", prompt)
+    + integrationsAccordion;
+  const labelsList = core.getInput("issue_labels").split(",").map((s) => s.trim()).filter(Boolean);
+  const assigneesList = core.getInput("issue_assignees").split(",").map((s) => s.trim()).filter(Boolean);
+  if (integrations.includes("copilot") && !assigneesList.includes("copilot-swe-agent")) {
+    assigneesList.push("copilot-swe-agent");
+  }
 
   const octokit = github.getOctokit(token);
 
-  const issue = await octokit.rest.issues.create({
-    owner: github.context.repo.owner,
-    repo: github.context.repo.repo,
-    title,
-    body,
-    labels: labels.split(","),
-    assignees: assignees.split(","),
-  });
+  // Try creating the issue; if assignees cause a 422, retry without them
+  let issue;
+  try {
+    issue = await octokit.rest.issues.create({
+      owner: github.context.repo.owner,
+      repo: github.context.repo.repo,
+      title,
+      body,
+      labels: labelsList,
+      assignees: assigneesList,
+    });
+  } catch (error) {
+    if (error.status === 422) {
+      core.warning(`Issue creation failed with assignees (${assigneesList.join(", ")}). Retrying without assignees.`);
+      issue = await octokit.rest.issues.create({
+        owner: github.context.repo.owner,
+        repo: github.context.repo.repo,
+        title,
+        body,
+        labels: labelsList,
+      });
+    } else {
+      throw error;
+    }
+  }
 
   core.info(`Issue created: ${issue.data.html_url}`);
   core.setOutput("issueUrl", issue.data.html_url);