@maintainabilityai/research-runner 0.1.15 → 0.1.17

package/dist/search/uspto-client.js

@@ -71,7 +71,10 @@ async function usptoSearch(opts) {
             patentNumber: num,
             title: meta.inventionTitle ?? '',
             abstract: '',
-            url: num ? `https://patents.google.com/patent/US${num}` : '',
+            // earliestPublicationNumber already carries the `US` prefix (e.g.
+            // `US20260064729A1`); patentNumber is plain digits. Avoid the double
+            // `USUS…` URL we were producing.
+            url: num ? `https://patents.google.com/patent/${num.startsWith('US') ? num : `US${num}`}` : '',
             grantedAt: meta.grantDate || meta.filingDate || meta.effectiveFilingDate || '',
             inventors: meta.firstInventorName ? [meta.firstInventorName] : [],
             _xmlUri: xmlUri,
@@ -80,16 +83,39 @@ async function usptoSearch(opts) {
     // Stage 2: parallel best-effort abstract fetch. The full-text XML carries
     // the <abstract> element; we regex it out rather than parsing the whole
     // document (the XML is large and we only want the abstract).
+    //
+    // Telemetry: count how many we attempted and how many succeeded so the
+    // archeologist progress log can surface "uspto abstracts: 3/5" instead of
+    // silently shipping empty `>` blockquotes to the synth agent.
+    let attempted = 0;
+    let succeeded = 0;
+    let missingUri = 0;
+    const failureCauses = [];
     await Promise.all(stage1.map(async (r) => {
         if (!r._xmlUri) {
+            missingUri += 1;
             return;
         }
+        attempted += 1;
         try {
             const xmlRes = await fetchImpl(r._xmlUri, {
                 method: 'GET',
-                headers: { 'X-API-Key': opts.apiKey, accept: 'application/xml' },
+                // Mirror the NCMS reference exactly: same headers dict on the
+                // search call AND the XML fetch (X-API-Key + Accept: json). My
+                // earlier "drop X-API-Key on stage 2" was wrong — the CDN does
+                // gate on it, and removing it produced http403 across the
+                // board (seen in #49 logs: "0/5 fetched, failures: http403 ×5").
+                // The Accept header looks wrong-shape (json for an XML doc) but
+                // the upstream ignores it and returns XML regardless; matches
+                // the NCMS pattern that works in production.
+                headers: {
+                    accept: 'application/json',
+                    'X-API-Key': opts.apiKey,
+                    'user-agent': 'maintainabilityai-research-runner/1.0',
+                },
             });
             if (!xmlRes.ok) {
+                failureCauses.push(`http${xmlRes.status}`);
                 return;
             }
             const xml = await xmlRes.text();
@@ -97,10 +123,20 @@ async function usptoSearch(opts) {
             if (m) {
                 const stripped = m[1].replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
                 r.abstract = stripped.slice(0, 1000);
+                succeeded += 1;
             }
+            else {
+                failureCauses.push('no-abstract-tag');
+            }
+        }
+        catch (err) {
+            failureCauses.push(err instanceof Error ? err.name : 'unknown');
         }
-        catch { /* ignore — best-effort */ }
     }));
+    if (records.length > 0 && process.env.RESEARCH_RUNNER_QUIET !== '1') {
+        process.stderr.write(`[research-runner] uspto abstracts: ${succeeded}/${attempted} fetched ` +
+            `(${missingUri} record(s) had no XML URI; failures: ${failureCauses.join(',') || 'none'})\n`);
+    }
     // Drop the internal _xmlUri marker before returning.
     const results = stage1.map(({ _xmlUri: _ignored, ...rest }) => rest);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maintainabilityai/research-runner",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Research + PRD agent runner — orchestrates the Archeologist and PRD pipelines for the MaintainabilityAI governance mesh",
   "license": "MIT",
   "author": "MaintainabilityAI",