@devinnn/docdrift 0.1.12 → 0.1.14

package/dist/src/cli.js

@@ -57,7 +57,7 @@ async function main() {
             "  status            Show run status [--since 24h]\n" +
             "  sla-check         Check SLA for unmerged PRs\n" +
             "  setup             Interactive setup (generates v2 docdrift.yaml)\n" +
-            "  generate-yaml     Generate config [--output path] [--force]");
+            "  generate-yaml     Generate config [--output path] [--force] [--open-pr]");
     }
     if (command === "setup" || command === "generate-yaml") {
         require("dotenv").config();
@@ -65,6 +65,7 @@ async function main() {
         await runSetup({
             outputPath: getArg(args, "--output") ?? "docdrift.yaml",
             force: args.includes("--force"),
+            openPr: args.includes("--open-pr"),
         });
         return;
     }

package/dist/src/setup/devin-setup.js

@@ -101,23 +101,105 @@ async function runSetupLocal(options) {
         sessionUrl: "",
     };
 }
-function parseSetupOutput(session) {
-    const raw = session?.structured_output ?? session?.data?.structured_output;
-    if (!raw || typeof raw !== "object")
+/** Extract transcript text from session for fallback parsing when structured_output is empty */
+function getSessionTranscript(session) {
+    const s = session;
+    const topLevel = (typeof s.output === "string" ? s.output : null) ?? (typeof s.result === "string" ? s.result : null) ?? (typeof s.transcript === "string" ? s.transcript : null);
+    if (topLevel)
+        return topLevel;
+    const data = s.data;
+    const messages = (session.messages ?? data?.messages ?? s.events);
+    if (!Array.isArray(messages))
+        return "";
+    return messages
+        .map((m) => {
+        if (typeof m.content === "string")
+            return m.content;
+        if (typeof m.text === "string")
+            return m.text;
+        if (typeof m.message === "string")
+            return m.message;
+        if (typeof m.body === "string")
+            return m.body;
+        if (m.message && typeof m.message === "object" && typeof m.message.content === "string")
+            return m.message.content;
+        return "";
+    })
+        .filter(Boolean)
+        .join("\n");
+}
+/** Parse setup output from <docdrift_setup_output>...</docdrift_setup_output> JSON block in text */
+function parseFromStrictTag(text) {
+    const openTag = `<${setup_prompt_1.DOCDRIFT_SETUP_OUTPUT_TAG}>`;
+    const closeTag = `</${setup_prompt_1.DOCDRIFT_SETUP_OUTPUT_TAG}>`;
+    const openIdx = text.indexOf(openTag);
+    const closeIdx = text.indexOf(closeTag, openIdx);
+    if (openIdx === -1 || closeIdx === -1)
+        return null;
+    const inner = text.slice(openIdx + openTag.length, closeIdx).trim();
+    try {
+        const o = JSON.parse(inner);
+        const yaml = o.docdriftYaml;
+        const summary = o.summary;
+        if (typeof yaml !== "string" || typeof summary !== "string")
+            return null;
+        return {
+            docdriftYaml: yaml,
+            docDriftMd: typeof o.docDriftMd === "string" && o.docDriftMd ? o.docDriftMd : undefined,
+            workflowYml: typeof o.workflowYml === "string" && o.workflowYml ? o.workflowYml : undefined,
+            summary,
+            sessionUrl: "",
+        };
+    }
+    catch {
         return null;
-    const o = raw;
-    const yaml = o.docdriftYaml;
-    const summary = o.summary;
-    if (typeof yaml !== "string" || typeof summary !== "string")
+    }
+}
+/** Fallback: parse from markdown blocks like **docdriftYaml:** ```yaml ... ``` */
+function parseFromMarkdownBlocks(text) {
+    const yamlMatch = text.match(/\*\*docdriftYaml:\*\*[\s\S]*?```(?:yaml)?\s*([\s\S]*?)```/i);
+    const docMdMatch = text.match(/\*\*docDriftMd:\*\*[\s\S]*?```(?:markdown)?\s*([\s\S]*?)```/i);
+    const workflowMatch = text.match(/\*\*workflowYml:\*\*[\s\S]*?```(?:yaml)?\s*([\s\S]*?)```/i);
+    const summaryBlock = text.match(/\*\*summary:\*\*([\s\S]*?)(?=\n\n\*\*|$)/i)?.[1]?.trim();
+    const yaml = yamlMatch?.[1]?.trim();
+    const summary = (summaryBlock || "Inferred from repo analysis").slice(0, 500);
+    if (!yaml)
         return null;
     return {
         docdriftYaml: yaml,
-        docDriftMd: typeof o.docDriftMd === "string" && o.docDriftMd ? o.docDriftMd : undefined,
-        workflowYml: typeof o.workflowYml === "string" && o.workflowYml ? o.workflowYml : undefined,
+        docDriftMd: docMdMatch?.[1]?.trim() || undefined,
+        workflowYml: workflowMatch?.[1]?.trim() || undefined,
         summary,
         sessionUrl: "",
     };
 }
+function parseSetupOutput(session) {
+    const raw = session?.structured_output ?? session?.data?.structured_output;
+    if (raw && typeof raw === "object") {
+        const o = raw;
+        const yaml = o.docdriftYaml;
+        const summary = o.summary;
+        if (typeof yaml === "string" && typeof summary === "string") {
+            return {
+                docdriftYaml: yaml,
+                docDriftMd: typeof o.docDriftMd === "string" && o.docDriftMd ? o.docDriftMd : undefined,
+                workflowYml: typeof o.workflowYml === "string" && o.workflowYml ? o.workflowYml : undefined,
+                summary,
+                sessionUrl: "",
+            };
+        }
+    }
+    const transcript = getSessionTranscript(session);
+    if (transcript) {
+        const fromTag = parseFromStrictTag(transcript);
+        if (fromTag)
+            return fromTag;
+        const fromMarkdown = parseFromMarkdownBlocks(transcript);
+        if (fromMarkdown)
+            return fromMarkdown;
+    }
+    return null;
+}
 async function runSetupDevin(options) {
     const cwd = options.cwd ?? process.cwd();
     const outputPath = node_path_1.default.resolve(cwd, options.outputPath ?? "docdrift.yaml");
@@ -139,7 +221,7 @@ async function runSetupDevin(options) {
     process.stdout.write("Uploading schema…\n");
     const schemaPath = getSchemaPath();
     const attachmentUrl = await (0, v1_1.devinUploadAttachment)(apiKey, schemaPath);
-    const prompt = (0, setup_prompt_1.buildSetupPrompt)([attachmentUrl]);
+    const prompt = (0, setup_prompt_1.buildSetupPrompt)([attachmentUrl], { openPr: options.openPr });
     process.stdout.write("Creating Devin session…\n");
     const session = await (0, v1_1.devinCreateSession)(apiKey, {
         prompt,
@@ -147,20 +229,26 @@ async function runSetupDevin(options) {
         max_acu_limit: 2,
         tags: ["docdrift", "setup"],
         attachments: [attachmentUrl],
-        structured_output: {
-            schema: schemas_1.SetupOutputSchema,
-        },
+        structured_output_schema: schemas_1.SetupOutputSchema,
         metadata: { purpose: "docdrift-setup" },
     });
     process.stdout.write("Devin is analyzing the repo and generating config…\n");
     process.stdout.write(`Session: ${session.url}\n`);
     const finalSession = await (0, v1_1.pollUntilTerminal)(apiKey, session.session_id, 15 * 60_000);
     const result = parseSetupOutput(finalSession);
+    if (result?.summary && !(finalSession.structured_output ?? finalSession.data?.structured_output)) {
+        process.stdout.write("  (Parsed from session transcript — structured_output was empty; using strict-tag fallback)\n");
+    }
     if (!result) {
         throw new Error("Devin session did not return valid setup output. Check the session for details: " + session.url);
     }
     result.sessionUrl = session.url;
-    // Write files
+    const prUrl = finalSession.pull_request_url ??
+        finalSession.pr_url ??
+        finalSession.pull_request?.url;
+    if (prUrl)
+        result.prUrl = prUrl;
+    // Write files (always write for validation; when openPr, Devin also created PR)
     node_fs_1.default.mkdirSync(node_path_1.default.dirname(outputPath), { recursive: true });
     node_fs_1.default.writeFileSync(outputPath, result.docdriftYaml, "utf8");
     if (result.docDriftMd) {

package/dist/src/setup/index.js

@@ -113,6 +113,8 @@ async function runSetup(options = {}) {
     console.log("\nSummary: " + result.summary);
     if (result.sessionUrl)
         console.log("\nSession: " + result.sessionUrl);
+    if (result.prUrl)
+        console.log("PR: " + result.prUrl);
     console.log("\nNext steps:");
     const usedLocal = mode === "local" || (mode === "devin" && !hasDevinKey) || usedLocalFallback;
     if (usedLocal) {

package/dist/src/setup/setup-prompt.js

@@ -5,11 +5,46 @@
  * Devin's Machine, so Devin has full context.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCDRIFT_SETUP_OUTPUT_TAG = void 0;
 exports.buildSetupPrompt = buildSetupPrompt;
+/** XML tag used as strict delimiter for fallback parsing from chat transcript */
+exports.DOCDRIFT_SETUP_OUTPUT_TAG = "docdrift_setup_output";
 function attachmentBlock(urls) {
     return urls.map((url, i) => `- ATTACHMENT ${i + 1}: ${url}`).join("\n");
 }
-function buildSetupPrompt(attachmentUrls) {
+function strictOutputBlock() {
+    return [
+        "",
+        "STRICT OUTPUT FORMAT (REQUIRED FOR PARSING):",
+        "You MUST include this exact block in your final message so we can reliably parse it.",
+        "Format: open with <" +
+            exports.DOCDRIFT_SETUP_OUTPUT_TAG +
+            ">, then valid JSON, then close with </" +
+            exports.DOCDRIFT_SETUP_OUTPUT_TAG +
+            ">.",
+        "Example (escape quotes in strings as \\\"):",
+        "",
+        `<${exports.DOCDRIFT_SETUP_OUTPUT_TAG}>`,
+        '{"docdriftYaml":"# yaml...","docDriftMd":"# DocDrift...","workflowYml":"name: docdrift...","summary":"OpenAPI at..."}',
+        `</${exports.DOCDRIFT_SETUP_OUTPUT_TAG}>`,
+        "",
+        "Rules: Valid JSON only. Newlines in YAML/yml strings become \\n. Escape \" as \\\".",
+    ].join("\n");
+}
+function buildSetupPrompt(attachmentUrls, options) {
+    const openPr = options?.openPr ?? false;
+    const createFilesBlock = openPr
+        ? [
+            "",
+            "CREATE A PULL REQUEST:",
+            "- Create branch docdrift/setup from main",
+            "- Create docdrift.yaml, .docdrift/DocDrift.md, .github/workflows/docdrift.yml in the repo",
+            "- Commit with message: [docdrift] Add docdrift configuration",
+            "- Push and open a PR to main with title: [docdrift] Add docdrift configuration",
+            "- In the PR description, explain what was inferred (openapi export, docsite path, verification commands)",
+            "- You MUST still emit the strict output block below so we can validate the config",
+        ].join("\n")
+        : "Do NOT create files in the repo. Only produce the structured output and the strict output block.";
     return [
         "You are Devin. Task: set up docdrift for this repository.",
         "",
@@ -43,12 +78,12 @@ function buildSetupPrompt(attachmentUrls) {
         "   - Note: docdrift-sla-check.yml (daily cron for PRs open 7+ days) is added automatically",
         "",
         "OUTPUT:",
-        "Emit your final output in the provided structured output schema.",
+        "Emit your final output in the provided structured output schema if possible.",
         "- docdriftYaml: complete YAML string (no leading/trailing comments about the task)",
         "- docDriftMd: content for .docdrift/DocDrift.md, or empty string to omit",
         "- workflowYml: content for .github/workflows/docdrift.yml, or empty string to omit",
         "- summary: what you inferred (openapi export, docsite path, verification commands)",
-        "",
-        "Do NOT create files in the repo. Only produce the structured output.",
+        createFilesBlock,
+        strictOutputBlock(),
     ].join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devinnn/docdrift",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "private": false,
   "description": "Detect and remediate documentation drift with Devin sessions",
   "main": "dist/src/index.js",